Rfc2898DeriveBytes Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Implementuje funkcje wyprowadzania kluczy opartych na hasłach, PBKDF2, przy użyciu pseudo-losowego generatora liczb w oparciu o HMACSHA1.
public ref class Rfc2898DeriveBytes : System::Security::Cryptography::DeriveBytes[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public class Rfc2898DeriveBytes : System.Security.Cryptography.DeriveBytespublic class Rfc2898DeriveBytes : System.Security.Cryptography.DeriveBytes[System.Runtime.InteropServices.ComVisible(true)]
public class Rfc2898DeriveBytes : System.Security.Cryptography.DeriveBytes[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
type Rfc2898DeriveBytes = class
inherit DeriveBytestype Rfc2898DeriveBytes = class
inherit DeriveBytes[<System.Runtime.InteropServices.ComVisible(true)>]
type Rfc2898DeriveBytes = class
inherit DeriveBytesPublic Class Rfc2898DeriveBytes
Inherits DeriveBytes- Dziedziczenie
- Atrybuty
Przykłady
Poniższy przykład kodu używa Rfc2898DeriveBytes klasy do utworzenia dwóch identycznych kluczy dla Aes klasy. Następnie szyfruje i odszyfrowuje niektóre dane przy użyciu kluczy.
using namespace System;
using namespace System::IO;
using namespace System::Text;
using namespace System::Security::Cryptography;
// Generate a key k1 with password pwd1 and salt salt1.
// Generate a key k2 with password pwd1 and salt salt1.
// Encrypt data1 with key k1 using symmetric encryption, creating edata1.
// Decrypt edata1 with key k2 using symmetric decryption, creating data2.
// data2 should equal data1.
int main()
{
array<String^>^passwordargs = Environment::GetCommandLineArgs();
String^ usageText = "Usage: RFC2898 <password>\nYou must specify the password for encryption.\n";
//If no file name is specified, write usage text.
if ( passwordargs->Length == 1 )
{
Console::WriteLine( usageText );
}
else
{
String^ pwd1 = passwordargs[ 1 ];
array<Byte>^salt1 = gcnew array<Byte>(8);
RNGCryptoServiceProvider ^ rngCsp = gcnew RNGCryptoServiceProvider();
rngCsp->GetBytes(salt1);
//data1 can be a string or contents of a file.
String^ data1 = "Some test data";
//The default iteration count is 1000 so the two methods use the same iteration count.
int myIterations = 1000;
try
{
Rfc2898DeriveBytes ^ k1 = gcnew Rfc2898DeriveBytes( pwd1,salt1,myIterations );
Rfc2898DeriveBytes ^ k2 = gcnew Rfc2898DeriveBytes( pwd1,salt1 );
// Encrypt the data.
Aes^ encAlg = Aes::Create();
encAlg->Key = k1->GetBytes( 16 );
MemoryStream^ encryptionStream = gcnew MemoryStream;
CryptoStream^ encrypt = gcnew CryptoStream( encryptionStream,encAlg->CreateEncryptor(),CryptoStreamMode::Write );
array<Byte>^utfD1 = (gcnew System::Text::UTF8Encoding( false ))->GetBytes( data1 );
encrypt->Write( utfD1, 0, utfD1->Length );
encrypt->FlushFinalBlock();
encrypt->Close();
array<Byte>^edata1 = encryptionStream->ToArray();
k1->Reset();
// Try to decrypt, thus showing it can be round-tripped.
Aes^ decAlg = Aes::Create();
decAlg->Key = k2->GetBytes( 16 );
decAlg->IV = encAlg->IV;
MemoryStream^ decryptionStreamBacking = gcnew MemoryStream;
CryptoStream^ decrypt = gcnew CryptoStream( decryptionStreamBacking,decAlg->CreateDecryptor(),CryptoStreamMode::Write );
decrypt->Write( edata1, 0, edata1->Length );
decrypt->Flush();
decrypt->Close();
k2->Reset();
String^ data2 = (gcnew UTF8Encoding( false ))->GetString( decryptionStreamBacking->ToArray() );
if ( !data1->Equals( data2 ) )
{
Console::WriteLine( "Error: The two values are not equal." );
}
else
{
Console::WriteLine( "The two values are equal." );
Console::WriteLine( "k1 iterations: {0}", k1->IterationCount );
Console::WriteLine( "k2 iterations: {0}", k2->IterationCount );
}
}
catch ( Exception^ e )
{
Console::WriteLine( "Error: ", e );
}
}
}
using System;
using System.IO;
using System.Text;
using System.Security.Cryptography;
public class rfc2898test
{
// Generate a key k1 with password pwd1 and salt salt1.
// Generate a key k2 with password pwd1 and salt salt1.
// Encrypt data1 with key k1 using symmetric encryption, creating edata1.
// Decrypt edata1 with key k2 using symmetric decryption, creating data2.
// data2 should equal data1.
private const string usageText = "Usage: RFC2898 <password>\nYou must specify the password for encryption.\n";
public static void Main(string[] passwordargs)
{
//If no file name is specified, write usage text.
if (passwordargs.Length == 0)
{
Console.WriteLine(usageText);
}
else
{
string pwd1 = passwordargs[0];
// Create a byte array to hold the random value.
byte[] salt1 = new byte[8];
using (RNGCryptoServiceProvider rngCsp = new
RNGCryptoServiceProvider())
{
// Fill the array with a random value.
rngCsp.GetBytes(salt1);
}
//data1 can be a string or contents of a file.
string data1 = "Some test data";
//The default iteration count is 1000 so the two methods use the same iteration count.
int myIterations = 1000;
try
{
Rfc2898DeriveBytes k1 = new Rfc2898DeriveBytes(pwd1, salt1,
myIterations);
Rfc2898DeriveBytes k2 = new Rfc2898DeriveBytes(pwd1, salt1);
// Encrypt the data.
Aes encAlg = Aes.Create();
encAlg.Key = k1.GetBytes(16);
MemoryStream encryptionStream = new MemoryStream();
CryptoStream encrypt = new CryptoStream(encryptionStream,
encAlg.CreateEncryptor(), CryptoStreamMode.Write);
byte[] utfD1 = new System.Text.UTF8Encoding(false).GetBytes(
data1);
encrypt.Write(utfD1, 0, utfD1.Length);
encrypt.FlushFinalBlock();
encrypt.Close();
byte[] edata1 = encryptionStream.ToArray();
k1.Reset();
// Try to decrypt, thus showing it can be round-tripped.
Aes decAlg = Aes.Create();
decAlg.Key = k2.GetBytes(16);
decAlg.IV = encAlg.IV;
MemoryStream decryptionStreamBacking = new MemoryStream();
CryptoStream decrypt = new CryptoStream(
decryptionStreamBacking, decAlg.CreateDecryptor(), CryptoStreamMode.Write);
decrypt.Write(edata1, 0, edata1.Length);
decrypt.Flush();
decrypt.Close();
k2.Reset();
string data2 = new UTF8Encoding(false).GetString(
decryptionStreamBacking.ToArray());
if (!data1.Equals(data2))
{
Console.WriteLine("Error: The two values are not equal.");
}
else
{
Console.WriteLine("The two values are equal.");
Console.WriteLine("k1 iterations: {0}", k1.IterationCount);
Console.WriteLine("k2 iterations: {0}", k2.IterationCount);
}
}
catch (Exception e)
{
Console.WriteLine("Error: {0}", e);
}
}
}
}
Imports System.IO
Imports System.Text
Imports System.Security.Cryptography
Public Class rfc2898test
' Generate a key k1 with password pwd1 and salt salt1.
' Generate a key k2 with password pwd1 and salt salt1.
' Encrypt data1 with key k1 using symmetric encryption, creating edata1.
' Decrypt edata1 with key k2 using symmetric decryption, creating data2.
' data2 should equal data1.
Private Const usageText As String = "Usage: RFC2898 <password>" + vbLf + "You must specify the password for encryption." + vbLf
Public Shared Sub Main(ByVal passwordargs() As String)
'If no file name is specified, write usage text.
If passwordargs.Length = 0 Then
Console.WriteLine(usageText)
Else
Dim pwd1 As String = passwordargs(0)
Dim salt1(8) As Byte
Using rngCsp As New RNGCryptoServiceProvider()
rngCsp.GetBytes(salt1)
End Using
'data1 can be a string or contents of a file.
Dim data1 As String = "Some test data"
'The default iteration count is 1000 so the two methods use the same iteration count.
Dim myIterations As Integer = 1000
Try
Dim k1 As New Rfc2898DeriveBytes(pwd1, salt1, myIterations)
Dim k2 As New Rfc2898DeriveBytes(pwd1, salt1)
' Encrypt the data.
Dim encAlg As Aes = Aes.Create()
encAlg.Key = k1.GetBytes(16)
Dim encryptionStream As New MemoryStream()
Dim encrypt As New CryptoStream(encryptionStream, encAlg.CreateEncryptor(), CryptoStreamMode.Write)
Dim utfD1 As Byte() = New System.Text.UTF8Encoding(False).GetBytes(data1)
encrypt.Write(utfD1, 0, utfD1.Length)
encrypt.FlushFinalBlock()
encrypt.Close()
Dim edata1 As Byte() = encryptionStream.ToArray()
k1.Reset()
' Try to decrypt, thus showing it can be round-tripped.
Dim decAlg As Aes = Aes.Create()
decAlg.Key = k2.GetBytes(16)
decAlg.IV = encAlg.IV
Dim decryptionStreamBacking As New MemoryStream()
Dim decrypt As New CryptoStream(decryptionStreamBacking, decAlg.CreateDecryptor(), CryptoStreamMode.Write)
decrypt.Write(edata1, 0, edata1.Length)
decrypt.Flush()
decrypt.Close()
k2.Reset()
Dim data2 As String = New UTF8Encoding(False).GetString(decryptionStreamBacking.ToArray())
If Not data1.Equals(data2) Then
Console.WriteLine("Error: The two values are not equal.")
Else
Console.WriteLine("The two values are equal.")
Console.WriteLine("k1 iterations: {0}", k1.IterationCount)
Console.WriteLine("k2 iterations: {0}", k2.IterationCount)
End If
Catch e As Exception
Console.WriteLine("Error: ", e)
End Try
End If
End Sub
End Class
Uwagi
Rfc2898DeriveBytes pobiera hasło, sól i liczbę iteracji, a następnie generuje klucze za pomocą wywołań metody GetBytes .
RFC 2898 zawiera metody tworzenia klucza i wektora inicjowania (IV) z hasła i soli. Można użyć PBKDF2, funkcji wyprowadzania klucza opartego na hasłach, aby uzyskać klucze przy użyciu pseudo-losowej funkcji, która umożliwia generowanie kluczy o praktycznie nieograniczonej długości. Klasa Rfc2898DeriveBytes może służyć do tworzenia klucza pochodnego z klucza podstawowego i innych parametrów. W funkcji wyprowadzania klucza opartego na hasłach klucz podstawowy jest hasłem, a pozostałe parametry są wartością soli i liczbą iteracji.
Aby uzyskać więcej informacji o pbKDF2, zobacz RFC 2898 zatytułowany "PKCS #5: Password-Based Cryptography Specification Version 2.0". Aby uzyskać szczegółowe informacje, zobacz sekcję 5.2, "PBKDF2".
Ważne
Nigdy nie koduje hasła w kodzie źródłowym. Hasła zakodowane na podstawie kodu można pobrać z zestawu przy użyciu Ildasm.exe (IL Dezasembler) przy użyciu edytora szesnastkowego lub po prostu otwierając zestaw w edytorze tekstów, takim jak Notepad.exe.
Konstruktory
| Rfc2898DeriveBytes(Byte[], Byte[], Int32) |
Nieaktualne.
Inicjuje nowe wystąpienie Rfc2898DeriveBytes klasy przy użyciu hasła, soli i liczby iteracji w celu uzyskania klucza. |
| Rfc2898DeriveBytes(Byte[], Byte[], Int32, HashAlgorithmName) |
Inicjuje nowe wystąpienie Rfc2898DeriveBytes klasy przy użyciu określonego hasła, soli, liczby iteracji i nazwy algorytmu skrótu w celu uzyskania klucza. |
| Rfc2898DeriveBytes(String, Byte[]) |
Nieaktualne.
Inicjuje Rfc2898DeriveBytes nowe wystąpienie klasy przy użyciu hasła i soli w celu uzyskania klucza. |
| Rfc2898DeriveBytes(String, Byte[], Int32) |
Nieaktualne.
Inicjuje nowe wystąpienie Rfc2898DeriveBytes klasy przy użyciu hasła, soli i liczby iteracji w celu uzyskania klucza. |
| Rfc2898DeriveBytes(String, Byte[], Int32, HashAlgorithmName) |
Inicjuje nowe wystąpienie Rfc2898DeriveBytes klasy przy użyciu określonego hasła, soli, liczby iteracji i nazwy algorytmu skrótu w celu uzyskania klucza. |
| Rfc2898DeriveBytes(String, Int32) |
Nieaktualne.
Inicjuje Rfc2898DeriveBytes nowe wystąpienie klasy przy użyciu hasła i rozmiaru soli w celu uzyskania klucza. |
| Rfc2898DeriveBytes(String, Int32, Int32) |
Nieaktualne.
Inicjuje nowe wystąpienie Rfc2898DeriveBytes klasy przy użyciu hasła, rozmiaru soli i liczby iteracji w celu uzyskania klucza. |
| Rfc2898DeriveBytes(String, Int32, Int32, HashAlgorithmName) |
Inicjuje nowe wystąpienie Rfc2898DeriveBytes klasy przy użyciu określonego hasła, rozmiaru soli, liczby iteracji i nazwy algorytmu skrótu w celu uzyskania klucza. |
Właściwości
| HashAlgorithm |
Pobiera algorytm wyznaczania skrótu używany do wyprowadzania bajtów. |
| IterationCount |
Pobiera lub ustawia liczbę iteracji dla operacji. |
| Salt |
Pobiera lub ustawia wartość soli klucza dla operacji. |
Metody
| CryptDeriveKey(String, String, Int32, Byte[]) |
Nieaktualne.
Wyprowadza klucz kryptograficzny z Rfc2898DeriveBytes obiektu . |
| Dispose() |
Po zastąpieniu w klasie pochodnej zwalnia wszystkie zasoby używane przez bieżące wystąpienie DeriveBytes klasy. (Odziedziczone po DeriveBytes) |
| Dispose(Boolean) |
Zwalnia niezarządzane zasoby używane przez klasę Rfc2898DeriveBytes i opcjonalnie zwalnia zarządzane zasoby. |
| Dispose(Boolean) |
Po zastąpieniu w klasie pochodnej zwalnia niezarządzane zasoby używane przez DeriveBytes klasę i opcjonalnie zwalnia zarządzane zasoby. (Odziedziczone po DeriveBytes) |
| Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
| GetBytes(Int32) |
Zwraca pseudolosowy klucz dla tego obiektu. |
| GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
| GetType() |
Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object) |
| MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
| Pbkdf2(Byte[], Byte[], Int32, HashAlgorithmName, Int32) |
Tworzy klucz pochodny PBKDF2 na podstawie bajtów haseł. |
| Pbkdf2(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Int32, HashAlgorithmName, Int32) |
Tworzy klucz pochodny PBKDF2 na podstawie bajtów haseł. |
| Pbkdf2(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Int32, HashAlgorithmName) |
Wypełnia bufor kluczem pochodnym PBKDF2. |
| Pbkdf2(ReadOnlySpan<Char>, ReadOnlySpan<Byte>, Int32, HashAlgorithmName, Int32) |
Tworzy klucz pochodny PBKDF2 na podstawie hasła. |
| Pbkdf2(ReadOnlySpan<Char>, ReadOnlySpan<Byte>, Span<Byte>, Int32, HashAlgorithmName) |
Wypełnia bufor kluczem pochodnym PBKDF2. |
| Pbkdf2(String, Byte[], Int32, HashAlgorithmName, Int32) |
Tworzy klucz pochodny PBKDF2 na podstawie hasła. |
| Reset() |
Resetuje stan operacji. |
| ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |