ProtectedData.Unprotect Méthode

Définition

Espace de noms:
System.Security.Cryptography
Assembly:
System.Security.Cryptography.ProtectedData.dll
Assembly:
System.Security.dll
Paquet:
System.Security.Cryptography.ProtectedData v11.0.0-preview.4.26230.115

Surcharges

Nom Description
Unprotect(Byte[], Byte[], DataProtectionScope)

Déchiffre les données dans un tableau d’octets spécifié et retourne un tableau d’octets qui contient les données déchiffrées.
Unprotect(ReadOnlySpan<Byte>, DataProtectionScope, ReadOnlySpan<Byte>)

Déchiffre les données dans un tableau d’octets spécifié et retourne un tableau d’octets qui contient les données déchiffrées.
Unprotect(ReadOnlySpan<Byte>, DataProtectionScope, Span<Byte>, ReadOnlySpan<Byte>)

Déchiffre les données dans une mémoire tampon spécifiée et écrit les données déchiffrées dans une mémoire tampon de destination.

Unprotect(Byte[], Byte[], DataProtectionScope)

Source:
ProtectedData.cs
Source:
ProtectedData.cs
Source:
ProtectedData.cs
Source:
ProtectedData.cs
Source:
ProtectedData.cs
Source:
ProtectedData.cs
Source:
ProtectedData.cs

Déchiffre les données dans un tableau d’octets spécifié et retourne un tableau d’octets qui contient les données déchiffrées.

public:
 static cli::array <System::Byte> ^ Unprotect(cli::array <System::Byte> ^ encryptedData, cli::array <System::Byte> ^ optionalEntropy, System::Security::Cryptography::DataProtectionScope scope);
public static byte[] Unprotect(byte[] encryptedData, byte[]? optionalEntropy, System.Security.Cryptography.DataProtectionScope scope);
public static byte[] Unprotect(byte[] encryptedData, byte[] optionalEntropy, System.Security.Cryptography.DataProtectionScope scope);
static member Unprotect : byte[] * byte[] * System.Security.Cryptography.DataProtectionScope -> byte[]
Public Shared Function Unprotect (encryptedData As Byte(), optionalEntropy As Byte(), scope As DataProtectionScope) As Byte()

Paramètres

encryptedData
Byte[]

Tableau d’octets contenant des données chiffrées à l’aide de la Protect(Byte[], Byte[], DataProtectionScope) méthode.

optionalEntropy
Byte[]

Tableau d’octets supplémentaire facultatif utilisé pour chiffrer les données ou null si le tableau d’octets supplémentaire n’a pas été utilisé.

scope
DataProtectionScope

Une des valeurs d’énumération qui spécifie l’étendue de la protection des données utilisée pour chiffrer les données.

Retours

Byte[]

Tableau d’octets représentant les données déchiffrées.

Exceptions

ArgumentNullException

Le encryptedData paramètre est null.

CryptographicException

Échec du déchiffrement.

NotSupportedException

Le système d’exploitation ne prend pas en charge cette méthode.

OutOfMemoryException

Mémoire insuffisante.

PlatformNotSupportedException

.NET Core et .NET 5+ uniquement : les appels à la méthode Unprotect sont pris en charge uniquement sur les systèmes d’exploitation Windows.

Exemples

L’exemple de code suivant montre comment utiliser la protection des données.

using System;
using System.Security.Cryptography;

public class DataProtectionSample
{
    // Create byte array for additional entropy when using Protect method.
    static byte [] s_additionalEntropy = { 9, 8, 7, 6, 5 };

    public static void Main()
    {
        // Create a simple byte array containing data to be encrypted.
        byte [] secret = { 0, 1, 2, 3, 4, 1, 2, 3, 4 };

        //Encrypt the data.
        byte [] encryptedSecret = Protect( secret );
        Console.WriteLine("The encrypted byte array is:");
        PrintValues(encryptedSecret);

        // Decrypt the data and store in a byte array.
        byte [] originalData = Unprotect( encryptedSecret );
        Console.WriteLine("{0}The original data is:", Environment.NewLine);
        PrintValues(originalData);
    }

    public static byte [] Protect( byte [] data )
    {
        try
        {
            // Encrypt the data using DataProtectionScope.CurrentUser. The result can be decrypted
            // only by the same current user.
            return ProtectedData.Protect( data, s_additionalEntropy, DataProtectionScope.CurrentUser );
        }
        catch (CryptographicException e)
        {
            Console.WriteLine("Data was not encrypted. An error occurred.");
            Console.WriteLine(e.ToString());
            return null;
        }
    }

    public static byte [] Unprotect( byte [] data )
    {
        try
        {
            //Decrypt the data using DataProtectionScope.CurrentUser.
            return ProtectedData.Unprotect( data, s_additionalEntropy, DataProtectionScope.CurrentUser );
        }
        catch (CryptographicException e)
        {
            Console.WriteLine("Data was not decrypted. An error occurred.");
            Console.WriteLine(e.ToString());
            return null;
        }
    }

    public static void PrintValues( Byte[] myArr )
    {
        foreach ( Byte i in myArr )
        {
            Console.Write( "\t{0}", i );
        }
        Console.WriteLine();
    }
}

Imports System.Security.Cryptography



Public Class DataProtectionSample
    ' Create byte array for additional entropy when using Protect method.
    Private Shared s_additionalEntropy As Byte() = {9, 8, 7, 6, 5}


    Public Shared Sub Main()
        ' Create a simple byte array containing data to be encrypted.
        Dim secret As Byte() = {0, 1, 2, 3, 4, 1, 2, 3, 4}

        'Encrypt the data.
        Dim encryptedSecret As Byte() = Protect(secret)
        Console.WriteLine("The encrypted byte array is:")
        PrintValues(encryptedSecret)

        ' Decrypt the data and store in a byte array.
        Dim originalData As Byte() = Unprotect(encryptedSecret)
        Console.WriteLine("{0}The original data is:", Environment.NewLine)
        PrintValues(originalData)

    End Sub


    Public Shared Function Protect(ByVal data() As Byte) As Byte()
        Try
            ' Encrypt the data using DataProtectionScope.CurrentUser. The result can be decrypted
            '  only by the same current user.
            Return ProtectedData.Protect(data, s_additionalEntropy, DataProtectionScope.CurrentUser)
        Catch e As CryptographicException
            Console.WriteLine("Data was not encrypted. An error occurred.")
            Console.WriteLine(e.ToString())
            Return Nothing
        End Try

    End Function


    Public Shared Function Unprotect(ByVal data() As Byte) As Byte()
        Try
            'Decrypt the data using DataProtectionScope.CurrentUser.
            Return ProtectedData.Unprotect(data, s_additionalEntropy, DataProtectionScope.CurrentUser)
        Catch e As CryptographicException
            Console.WriteLine("Data was not decrypted. An error occurred.")
            Console.WriteLine(e.ToString())
            Return Nothing
        End Try

    End Function


    Public Shared Sub PrintValues(ByVal myArr() As [Byte])
        Dim i As [Byte]
        For Each i In myArr
            Console.Write(vbTab + "{0}", i)
        Next i
        Console.WriteLine()

    End Sub
End Class

Remarques

Cette méthode peut être utilisée pour annuler la protection des données chiffrées à l’aide de la Protect méthode. Si le paramètre a été utilisé pendant le optionalEntropy chiffrement, il doit être fourni pour déchiffrer les données.

Note

Si vous utilisez cette méthode pendant l’emprunt d’identité, vous pouvez recevoir l’erreur suivante : « Clé non valide pour une utilisation dans l’état spécifié ». Pour éviter cette erreur, chargez le profil de l’utilisateur que vous souhaitez emprunter l’identité avant d’appeler la méthode.

S’applique à

Unprotect(ReadOnlySpan<Byte>, DataProtectionScope, ReadOnlySpan<Byte>)

Source:
ProtectedData.cs
Source:
ProtectedData.cs
Source:
ProtectedData.cs

Déchiffre les données dans un tableau d’octets spécifié et retourne un tableau d’octets qui contient les données déchiffrées.

public static byte[] Unprotect(ReadOnlySpan<byte> encryptedData, System.Security.Cryptography.DataProtectionScope scope, ReadOnlySpan<byte> optionalEntropy = default);
static member Unprotect : ReadOnlySpan<byte> * System.Security.Cryptography.DataProtectionScope * ReadOnlySpan<byte> -> byte[]
Public Shared Function Unprotect (encryptedData As ReadOnlySpan(Of Byte), scope As DataProtectionScope, Optional optionalEntropy As ReadOnlySpan(Of Byte) = Nothing) As Byte()

Paramètres

encryptedData
ReadOnlySpan<Byte>

Mémoire tampon qui contient des données à déchiffrer.

scope
DataProtectionScope

Une des valeurs d’énumération qui spécifie l’étendue du chiffrement.

optionalEntropy
ReadOnlySpan<Byte>

Mémoire tampon supplémentaire facultative utilisée pour augmenter la complexité du chiffrement, ou vide pour aucune complexité supplémentaire.

Retours

Byte[]

Tableau d’octets représentant les données chiffrées.

Exceptions

CryptographicException

Échec du chiffrement.

NotSupportedException

Le système d’exploitation ne prend pas en charge cette méthode.

OutOfMemoryException

Le système n’a plus de mémoire pendant le déchiffrement des données.

PlatformNotSupportedException

Le système d’exploitation n’est pas Windows.

S’applique à

Unprotect(ReadOnlySpan<Byte>, DataProtectionScope, Span<Byte>, ReadOnlySpan<Byte>)

Source:
ProtectedData.cs
Source:
ProtectedData.cs
Source:
ProtectedData.cs

Déchiffre les données dans une mémoire tampon spécifiée et écrit les données déchiffrées dans une mémoire tampon de destination.

public static int Unprotect(ReadOnlySpan<byte> encryptedData, System.Security.Cryptography.DataProtectionScope scope, Span<byte> destination, ReadOnlySpan<byte> optionalEntropy = default);
static member Unprotect : ReadOnlySpan<byte> * System.Security.Cryptography.DataProtectionScope * Span<byte> * ReadOnlySpan<byte> -> int
Public Shared Function Unprotect (encryptedData As ReadOnlySpan(Of Byte), scope As DataProtectionScope, destination As Span(Of Byte), Optional optionalEntropy As ReadOnlySpan(Of Byte) = Nothing) As Integer

Paramètres

encryptedData
ReadOnlySpan<Byte>

Mémoire tampon qui contient des données à déchiffrer.

scope
DataProtectionScope

Une des valeurs d’énumération qui spécifie l’étendue du chiffrement.

destination
Span<Byte>

Mémoire tampon pour recevoir les données déchiffrées.

optionalEntropy
ReadOnlySpan<Byte>

Mémoire tampon supplémentaire facultative utilisée pour augmenter la complexité du chiffrement, ou vide pour aucune complexité supplémentaire.

Retours

Int32

Nombre total d’octets écrits dans destination

Exceptions

ArgumentException

La mémoire tampon est destination trop petite pour contenir les données déchiffrées.

CryptographicException

Échec du chiffrement.

NotSupportedException

Le système d’exploitation ne prend pas en charge cette méthode.

OutOfMemoryException

Le système n’a plus de mémoire pendant le chiffrement des données.

PlatformNotSupportedException

Le système d’exploitation n’est pas Windows.

S’applique à