ProtectedData.Protect(Byte[], Byte[], DataProtectionScope) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Criptografa os dados em uma matriz de bytes especificada e retorna uma matriz de bytes que contém os dados criptografados.
public:
static cli::array <System::Byte> ^ Protect(cli::array <System::Byte> ^ userData, cli::array <System::Byte> ^ optionalEntropy, System::Security::Cryptography::DataProtectionScope scope);public static byte[] Protect (byte[] userData, byte[]? optionalEntropy, System.Security.Cryptography.DataProtectionScope scope);public static byte[] Protect (byte[] userData, byte[] optionalEntropy, System.Security.Cryptography.DataProtectionScope scope);static member Protect : byte[] * byte[] * System.Security.Cryptography.DataProtectionScope -> byte[]Public Shared Function Protect (userData As Byte(), optionalEntropy As Byte(), scope As DataProtectionScope) As Byte()Parâmetros
- userData
- Byte[]
Uma matriz de bytes que contém os dados a serem criptografados.
- optionalEntropy
- Byte[]
Uma matriz de bytes adicional opcional usada para aumentar a complexidade da criptografia ou null para que não haja complexidade adicional.
- scope
- DataProtectionScope
Um dos valores de enumeração que especifica o escopo da criptografia.
Retornos
Uma matriz de bytes que representa os dados criptografados.
Exceções
O parâmetro userData é null.
Falha na criptografia.
O sistema operacional não é compatível com esse método.
O sistema ficou sem memória ao criptografar os dados.
Somente .NET Core e .NET 5+: as chamadas para o Protect método têm suporte apenas em sistemas operacionais Windows.
Exemplos
O exemplo a seguir mostra como usar a proteção de dados.
#using <System.Security.dll>
using namespace System;
using namespace System::Security::Cryptography;
public ref class DataProtectionSample
{
private:
// Create byte array for additional entropy when using Protect method.
static array<Byte>^s_additionalEntropy = {9,8,7,6,5};
public:
static void Main()
{
// Create a simple byte array containing data to be encrypted.
array<Byte>^secret = {0,1,2,3,4,1,2,3,4};
//Encrypt the data.
array<Byte>^encryptedSecret = Protect( secret );
Console::WriteLine( "The encrypted byte array is:" );
PrintValues( encryptedSecret );
// Decrypt the data and store in a byte array.
array<Byte>^originalData = Unprotect( encryptedSecret );
Console::WriteLine( "{0}The original data is:", Environment::NewLine );
PrintValues( originalData );
}
static array<Byte>^ Protect( array<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 );
return nullptr;
}
}
static array<Byte>^ Unprotect( array<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 );
return nullptr;
}
}
static void PrintValues( array<Byte>^myArr )
{
System::Collections::IEnumerator^ myEnum = myArr->GetEnumerator();
while ( myEnum->MoveNext() )
{
Byte i = safe_cast<Byte>(myEnum->Current);
Console::Write( "\t{0}", i );
}
Console::WriteLine();
}
};
int main()
{
DataProtectionSample::Main();
}
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
Comentários
Esse método pode ser usado para criptografar dados como senhas, chaves ou cadeias de conexão. O optionalEntropy parâmetro permite que você adicione dados para aumentar a complexidade da criptografia; especifique null para nenhuma complexidade adicional. Se fornecidas, essas informações também devem ser usadas ao descriptografar os dados usando o Unprotect método .
Observação
Se você usar esse método durante a representação, poderá receber o seguinte erro: "Chave não válida para uso no estado especificado". Para evitar esse erro, carregue o perfil do usuário que você deseja representar antes de chamar o método .
