Rfc2898DeriveBytes Kelas

Definisi

Ruang nama:

System.Security.Cryptography

Rakitan:

System.Security.Cryptography.dll

Sumber:

Rfc2898DeriveBytes.cs

Menerapkan fungsionalitas derivasi kunci berbasis kata sandi, PBKDF2, dengan menggunakan generator angka acak semu berdasarkan HMACSHA1.

public ref class Rfc2898DeriveBytes : System::Security::Cryptography::DeriveBytes

public class Rfc2898DeriveBytes : System.Security.Cryptography.DeriveBytes

type Rfc2898DeriveBytes = class
    inherit DeriveBytes

Public Class Rfc2898DeriveBytes
Inherits DeriveBytes

Warisan

Object

DeriveBytes

Rfc2898DeriveBytes

Contoh

Contoh kode berikut menggunakan Rfc2898DeriveBytes kelas untuk membuat dua kunci yang identik untuk Aes kelas . Kemudian mengenkripsi dan mendekripsi beberapa data menggunakan kunci.

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

Keterangan

Rfc2898DeriveBytes mengambil kata sandi, garam, dan jumlah perulangan, lalu menghasilkan kunci melalui panggilan ke GetBytes metode .

RFC 2898 mencakup metode untuk membuat kunci dan vektor inisialisasi (IV) dari kata sandi dan garam. Anda dapat menggunakan PBKDF2, fungsi turunan kunci berbasis kata sandi, untuk mendapatkan kunci menggunakan fungsi pseudo-random yang memungkinkan kunci dengan panjang yang hampir tidak terbatas untuk dihasilkan. Kelas Rfc2898DeriveBytes dapat digunakan untuk menghasilkan kunci turunan dari kunci dasar dan parameter lainnya. Dalam fungsi turunan kunci berbasis kata sandi, kunci dasar adalah kata sandi dan parameter lainnya adalah nilai garam dan jumlah perulangan.

Untuk informasi selengkapnya tentang PBKDF2, lihat RFC 2898, berjudul "PKCS #5: Password-Based Spesifikasi Kriptografi Versi 2.0". Lihat bagian 5.2, "PBKDF2," untuk detail selengkapnya.

Penting

Jangan pernah mengodekan kata sandi secara permanen dalam kode sumber Anda. Kata sandi yang dikodekan secara permanen dapat diambil dari perakitan dengan menggunakan Ildasm.exe (Il Disassembler), dengan menggunakan editor heksadesimal, atau dengan hanya membuka perakitan di editor teks seperti Notepad.exe.

Konstruktor

Rfc2898DeriveBytes(Byte[], Byte[], Int32)	Kedaluwarsa. Menginisialisasi instans Rfc2898DeriveBytes baru kelas menggunakan kata sandi, garam, dan jumlah perulangan untuk mendapatkan kunci.
Rfc2898DeriveBytes(Byte[], Byte[], Int32, HashAlgorithmName)	Menginisialisasi instans Rfc2898DeriveBytes baru kelas menggunakan kata sandi, garam, jumlah iterasi, dan nama algoritma hash yang ditentukan untuk mendapatkan kunci.
Rfc2898DeriveBytes(String, Byte[])	Kedaluwarsa. Menginisialisasi instans Rfc2898DeriveBytes baru kelas menggunakan kata sandi dan garam untuk mendapatkan kunci.
Rfc2898DeriveBytes(String, Byte[], Int32)	Kedaluwarsa. Menginisialisasi instans Rfc2898DeriveBytes baru kelas menggunakan kata sandi, garam, dan jumlah perulangan untuk mendapatkan kunci.
Rfc2898DeriveBytes(String, Byte[], Int32, HashAlgorithmName)	Menginisialisasi instans Rfc2898DeriveBytes baru kelas menggunakan kata sandi, garam, jumlah iterasi, dan nama algoritma hash yang ditentukan untuk mendapatkan kunci.
Rfc2898DeriveBytes(String, Int32)	Kedaluwarsa. Menginisialisasi instans Rfc2898DeriveBytes baru kelas menggunakan kata sandi dan ukuran garam untuk mendapatkan kunci.
Rfc2898DeriveBytes(String, Int32, Int32)	Kedaluwarsa. Menginisialisasi instans Rfc2898DeriveBytes baru kelas menggunakan kata sandi, ukuran garam, dan jumlah perulangan untuk mendapatkan kunci.
Rfc2898DeriveBytes(String, Int32, Int32, HashAlgorithmName)	Menginisialisasi instans Rfc2898DeriveBytes baru kelas menggunakan kata sandi, ukuran garam, jumlah iterasi, dan nama algoritma hash yang ditentukan untuk mendapatkan kunci.

Properti

HashAlgorithm	Mendapatkan algoritma hash yang digunakan untuk turunan byte.
IterationCount	Mendapatkan atau mengatur jumlah perulangan untuk operasi.
Salt	Mendapatkan atau mengatur nilai garam kunci untuk operasi.

Metode

CryptDeriveKey(String, String, Int32, Byte[])	Kedaluwarsa. Mendapatkan kunci kriptografi dari Rfc2898DeriveBytes objek .
Dispose()	Saat ditimpa di kelas turunan, merilis semua sumber daya yang digunakan oleh instans DeriveBytes kelas saat ini. (Diperoleh dari DeriveBytes)
Dispose(Boolean)	Merilis sumber daya tidak terkelola yang Rfc2898DeriveBytes digunakan oleh kelas dan secara opsional merilis sumber daya terkelola.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetBytes(Int32)	Mengembalikan kunci pseudo-random untuk objek ini.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
Pbkdf2(Byte[], Byte[], Int32, HashAlgorithmName, Int32)	Membuat kunci turunan PBKDF2 dari byte kata sandi.
Pbkdf2(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Int32, HashAlgorithmName, Int32)	Membuat kunci turunan PBKDF2 dari byte kata sandi.
Pbkdf2(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Int32, HashAlgorithmName)	Mengisi buffer dengan kunci turunan PBKDF2.
Pbkdf2(ReadOnlySpan<Char>, ReadOnlySpan<Byte>, Int32, HashAlgorithmName, Int32)	Membuat kunci turunan PBKDF2 dari kata sandi.
Pbkdf2(ReadOnlySpan<Char>, ReadOnlySpan<Byte>, Span<Byte>, Int32, HashAlgorithmName)	Mengisi buffer dengan kunci turunan PBKDF2.
Pbkdf2(String, Byte[], Int32, HashAlgorithmName, Int32)	Membuat kunci turunan PBKDF2 dari kata sandi.
Reset()	Mereset status operasi.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Lihat juga

• Layanan Kriptografi