Rfc2898DeriveBytes 构造函数

定义

命名空间:: System.Security.Cryptography

程序集:: netstandard.dll, System.Security.Cryptography.dll

程序集:: netstandard.dll, System.Security.Cryptography.Algorithms.dll

程序集:: System.Security.Cryptography.Algorithms.dll

程序集:: mscorlib.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

初始化 Rfc2898DeriveBytes 类的新实例。

重载

名称	说明
Rfc2898DeriveBytes(String, Byte[])	已过时. 已过时. 使用密码和 salt 来派生密钥初始化类的新实例 Rfc2898DeriveBytes 。
Rfc2898DeriveBytes(String, Int32)	已过时. 已过时. 使用密码和盐大小来派生密钥初始化类的新实例 Rfc2898DeriveBytes 。
Rfc2898DeriveBytes(Byte[], Byte[], Int32)	已过时. 已过时. 使用密码、salt 和迭代次数来派生密钥初始化类的新实例 Rfc2898DeriveBytes 。
Rfc2898DeriveBytes(String, Byte[], Int32)	已过时. 已过时. 使用密码、salt 和迭代次数来派生密钥初始化类的新实例 Rfc2898DeriveBytes 。
Rfc2898DeriveBytes(String, Int32, Int32)	已过时. 已过时. 使用密码、盐大小和迭代次数来派生密钥初始化类的新实例 Rfc2898DeriveBytes 。
Rfc2898DeriveBytes(Byte[], Byte[], Int32, HashAlgorithmName)	已过时. 使用指定的密码、salt、迭代次数和哈希算法名称来派生密钥来初始化类的新实例 Rfc2898DeriveBytes 。
Rfc2898DeriveBytes(String, Byte[], Int32, HashAlgorithmName)	已过时. 使用指定的密码、salt、迭代次数和哈希算法名称来派生密钥来初始化类的新实例 Rfc2898DeriveBytes 。
Rfc2898DeriveBytes(String, Int32, Int32, HashAlgorithmName)	已过时. 使用指定的密码、盐大小、迭代次数和哈希算法名称来派生密钥来初始化类的新实例 Rfc2898DeriveBytes 。

Rfc2898DeriveBytes(String, Byte[])

Source:: Rfc2898DeriveBytes.cs

Source:: Rfc2898DeriveBytes.cs

Source:: Rfc2898DeriveBytes.cs

Source:: Rfc2898DeriveBytes.cs

Source:: Rfc2898DeriveBytes.cs

注意

The constructors on Rfc2898DeriveBytes are obsolete. Use the static Pbkdf2 method instead.

注意

The default hash algorithm and iteration counts in Rfc2898DeriveBytes constructors are outdated and insecure. Use a constructor that accepts the hash algorithm and the number of iterations.

使用密码和 salt 来派生密钥初始化类的新实例 Rfc2898DeriveBytes 。

public:
 Rfc2898DeriveBytes(System::String ^ password, cli::array <System::Byte> ^ salt);

[System.Obsolete("The constructors on Rfc2898DeriveBytes are obsolete. Use the static Pbkdf2 method instead.", DiagnosticId="SYSLIB0060", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public Rfc2898DeriveBytes(string password, byte[] salt);

public Rfc2898DeriveBytes(string password, byte[] salt);

[System.Obsolete("The default hash algorithm and iteration counts in Rfc2898DeriveBytes constructors are outdated and insecure. Use a constructor that accepts the hash algorithm and the number of iterations.", DiagnosticId="SYSLIB0041", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public Rfc2898DeriveBytes(string password, byte[] salt);

[<System.Obsolete("The constructors on Rfc2898DeriveBytes are obsolete. Use the static Pbkdf2 method instead.", DiagnosticId="SYSLIB0060", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.Rfc2898DeriveBytes : string * byte[] -> System.Security.Cryptography.Rfc2898DeriveBytes

new System.Security.Cryptography.Rfc2898DeriveBytes : string * byte[] -> System.Security.Cryptography.Rfc2898DeriveBytes

[<System.Obsolete("The default hash algorithm and iteration counts in Rfc2898DeriveBytes constructors are outdated and insecure. Use a constructor that accepts the hash algorithm and the number of iterations.", DiagnosticId="SYSLIB0041", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.Rfc2898DeriveBytes : string * byte[] -> System.Security.Cryptography.Rfc2898DeriveBytes

Public Sub New (password As String, salt As Byte())

参数

password: String

用于派生密钥的密码。

salt: Byte[]

用于派生密钥的键盐。

属性: ObsoleteAttribute

例外

ArgumentException

指定的盐大小小于 8 个字节，或者迭代计数小于 1。

ArgumentNullException

密码或盐是 null。

示例

下面的代码示例使用该 Rfc2898DeriveBytes 类为 Aes 类创建两个相同的键。然后，它使用密钥加密和解密某些数据。

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 (RandomNumberGenerator rng = RandomNumberGenerator.Create())
            {
                // Fill the array with a random value.
                rng.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 rng As RandomNumberGenerator = RandomNumberGenerator.Create()
                rng.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

注解

盐大小必须为 8 个字节或更大。

RFC 2898 包括用于从密码和盐创建密钥和初始化向量（IV）的方法。可以使用基于密码的密钥派生函数 PBKDF2 通过伪随机函数来派生密钥，该函数允许生成长度几乎无限的密钥。该 Rfc2898DeriveBytes 类可用于从基键和其他参数生成派生密钥。在基于密码的密钥派生函数中，基密钥是密码，其他参数是盐值和迭代计数。

有关 PBKDF2 的详细信息，请参阅 RFC 2898，标题为“PKCS #5：Password-Based 加密规范版本 2.0”。有关完整详细信息，请参阅第 5.2 节“PBKDF2”。

Important

从不对源代码中的密码进行硬编码。硬编码的密码可以通过使用 Ildasm.exe（IL 反汇编程序）从程序集中检索，方法是使用十六进制编辑器，或者只需在文本编辑器（如 Notepad.exe）中打开程序集即可。

另请参阅

加密服务

适用于

Rfc2898DeriveBytes(String, Int32)

Source:: Rfc2898DeriveBytes.cs

Source:: Rfc2898DeriveBytes.cs

Source:: Rfc2898DeriveBytes.cs

Source:: Rfc2898DeriveBytes.cs

Source:: Rfc2898DeriveBytes.cs

注意

The constructors on Rfc2898DeriveBytes are obsolete. Use the static Pbkdf2 method instead.

注意

The default hash algorithm and iteration counts in Rfc2898DeriveBytes constructors are outdated and insecure. Use a constructor that accepts the hash algorithm and the number of iterations.

使用密码和盐大小来派生密钥初始化类的新实例 Rfc2898DeriveBytes 。

public:
 Rfc2898DeriveBytes(System::String ^ password, int saltSize);

[System.Obsolete("The constructors on Rfc2898DeriveBytes are obsolete. Use the static Pbkdf2 method instead.", DiagnosticId="SYSLIB0060", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public Rfc2898DeriveBytes(string password, int saltSize);

public Rfc2898DeriveBytes(string password, int saltSize);

[System.Obsolete("The default hash algorithm and iteration counts in Rfc2898DeriveBytes constructors are outdated and insecure. Use a constructor that accepts the hash algorithm and the number of iterations.", DiagnosticId="SYSLIB0041", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public Rfc2898DeriveBytes(string password, int saltSize);

[<System.Obsolete("The constructors on Rfc2898DeriveBytes are obsolete. Use the static Pbkdf2 method instead.", DiagnosticId="SYSLIB0060", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.Rfc2898DeriveBytes : string * int -> System.Security.Cryptography.Rfc2898DeriveBytes

new System.Security.Cryptography.Rfc2898DeriveBytes : string * int -> System.Security.Cryptography.Rfc2898DeriveBytes

[<System.Obsolete("The default hash algorithm and iteration counts in Rfc2898DeriveBytes constructors are outdated and insecure. Use a constructor that accepts the hash algorithm and the number of iterations.", DiagnosticId="SYSLIB0041", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.Rfc2898DeriveBytes : string * int -> System.Security.Cryptography.Rfc2898DeriveBytes

Public Sub New (password As String, saltSize As Integer)

参数

password: String

用于派生密钥的密码。

saltSize: Int32

希望类生成的随机盐的大小。

属性: ObsoleteAttribute

例外

ArgumentException

指定的盐大小小于 8 个字节。

ArgumentNullException

密码或盐是 null。

注解

盐大小必须为 8 个字节或更大。

有关 PBKDF2 的详细信息，请参阅 RFC 2898，标题为“PKCS #5：Password-Based 加密规范版本 2.0”。有关完整详细信息，请参阅第 5.2 节“PBKDF2”。

Important

另请参阅

加密服务

适用于

Rfc2898DeriveBytes(Byte[], Byte[], Int32)

Source:: Rfc2898DeriveBytes.cs

Source:: Rfc2898DeriveBytes.cs

Source:: Rfc2898DeriveBytes.cs

Source:: Rfc2898DeriveBytes.cs

Source:: Rfc2898DeriveBytes.cs

注意

The constructors on Rfc2898DeriveBytes are obsolete. Use the static Pbkdf2 method instead.

注意

The default hash algorithm and iteration counts in Rfc2898DeriveBytes constructors are outdated and insecure. Use a constructor that accepts the hash algorithm and the number of iterations.

使用密码、salt 和迭代次数来派生密钥初始化类的新实例 Rfc2898DeriveBytes 。

public:
 Rfc2898DeriveBytes(cli::array <System::Byte> ^ password, cli::array <System::Byte> ^ salt, int iterations);

[System.Obsolete("The constructors on Rfc2898DeriveBytes are obsolete. Use the static Pbkdf2 method instead.", DiagnosticId="SYSLIB0060", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public Rfc2898DeriveBytes(byte[] password, byte[] salt, int iterations);

public Rfc2898DeriveBytes(byte[] password, byte[] salt, int iterations);

[System.Obsolete("The default hash algorithm and iteration counts in Rfc2898DeriveBytes constructors are outdated and insecure. Use a constructor that accepts the hash algorithm and the number of iterations.", DiagnosticId="SYSLIB0041", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public Rfc2898DeriveBytes(byte[] password, byte[] salt, int iterations);

[<System.Obsolete("The constructors on Rfc2898DeriveBytes are obsolete. Use the static Pbkdf2 method instead.", DiagnosticId="SYSLIB0060", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.Rfc2898DeriveBytes : byte[] * byte[] * int -> System.Security.Cryptography.Rfc2898DeriveBytes

new System.Security.Cryptography.Rfc2898DeriveBytes : byte[] * byte[] * int -> System.Security.Cryptography.Rfc2898DeriveBytes

[<System.Obsolete("The default hash algorithm and iteration counts in Rfc2898DeriveBytes constructors are outdated and insecure. Use a constructor that accepts the hash algorithm and the number of iterations.", DiagnosticId="SYSLIB0041", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.Rfc2898DeriveBytes : byte[] * byte[] * int -> System.Security.Cryptography.Rfc2898DeriveBytes

Public Sub New (password As Byte(), salt As Byte(), iterations As Integer)

参数

password: Byte[]

用于派生密钥的密码。

salt: Byte[]

用于派生密钥的键盐。

iterations: Int32

操作的迭代数。

属性: ObsoleteAttribute

例外

ArgumentException

指定的盐大小小于 8 个字节，或者迭代计数小于 1。

ArgumentNullException

密码或盐是 null。

注解

盐大小必须为 8 个字节或更大，迭代计数必须大于零。建议的最小迭代数为 1000。

有关 PBKDF2 的详细信息，请参阅 RFC 2898，标题为“PKCS #5：Password-Based 加密规范版本 2.0”。有关完整详细信息，请参阅第 5.2 节“PBKDF2”。

Important

适用于

Rfc2898DeriveBytes(String, Byte[], Int32)

Source:: Rfc2898DeriveBytes.cs

Source:: Rfc2898DeriveBytes.cs

Source:: Rfc2898DeriveBytes.cs

Source:: Rfc2898DeriveBytes.cs

Source:: Rfc2898DeriveBytes.cs

注意

The constructors on Rfc2898DeriveBytes are obsolete. Use the static Pbkdf2 method instead.

注意

The default hash algorithm and iteration counts in Rfc2898DeriveBytes constructors are outdated and insecure. Use a constructor that accepts the hash algorithm and the number of iterations.

使用密码、salt 和迭代次数来派生密钥初始化类的新实例 Rfc2898DeriveBytes 。

public:
 Rfc2898DeriveBytes(System::String ^ password, cli::array <System::Byte> ^ salt, int iterations);

[System.Obsolete("The constructors on Rfc2898DeriveBytes are obsolete. Use the static Pbkdf2 method instead.", DiagnosticId="SYSLIB0060", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public Rfc2898DeriveBytes(string password, byte[] salt, int iterations);

public Rfc2898DeriveBytes(string password, byte[] salt, int iterations);

[System.Obsolete("The default hash algorithm and iteration counts in Rfc2898DeriveBytes constructors are outdated and insecure. Use a constructor that accepts the hash algorithm and the number of iterations.", DiagnosticId="SYSLIB0041", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public Rfc2898DeriveBytes(string password, byte[] salt, int iterations);

[<System.Obsolete("The constructors on Rfc2898DeriveBytes are obsolete. Use the static Pbkdf2 method instead.", DiagnosticId="SYSLIB0060", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.Rfc2898DeriveBytes : string * byte[] * int -> System.Security.Cryptography.Rfc2898DeriveBytes

new System.Security.Cryptography.Rfc2898DeriveBytes : string * byte[] * int -> System.Security.Cryptography.Rfc2898DeriveBytes

[<System.Obsolete("The default hash algorithm and iteration counts in Rfc2898DeriveBytes constructors are outdated and insecure. Use a constructor that accepts the hash algorithm and the number of iterations.", DiagnosticId="SYSLIB0041", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.Rfc2898DeriveBytes : string * byte[] * int -> System.Security.Cryptography.Rfc2898DeriveBytes

Public Sub New (password As String, salt As Byte(), iterations As Integer)

参数

password: String

用于派生密钥的密码。

salt: Byte[]

用于派生密钥的键盐。

iterations: Int32

操作的迭代数。

属性: ObsoleteAttribute

例外

ArgumentException

指定的盐大小小于 8 个字节，或者迭代计数小于 1。

ArgumentNullException

密码或盐是 null。

示例

下面的代码示例使用该 Rfc2898DeriveBytes 类为 Aes 类创建两个相同的键。然后，它使用密钥加密和解密某些数据。

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 (RandomNumberGenerator rng = RandomNumberGenerator.Create())
            {
                // Fill the array with a random value.
                rng.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 rng As RandomNumberGenerator = RandomNumberGenerator.Create()
                rng.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

注解

盐大小必须为 8 个字节或更大，迭代计数必须大于零。建议的最小迭代数为 1000。

有关 PBKDF2 的详细信息，请参阅 RFC 2898，标题为“PKCS #5：Password-Based 加密规范版本 2.0”。有关完整详细信息，请参阅第 5.2 节“PBKDF2”。

Important

另请参阅

加密服务

适用于

Rfc2898DeriveBytes(String, Int32, Int32)

Source:: Rfc2898DeriveBytes.cs

Source:: Rfc2898DeriveBytes.cs

Source:: Rfc2898DeriveBytes.cs

Source:: Rfc2898DeriveBytes.cs

Source:: Rfc2898DeriveBytes.cs

注意

The constructors on Rfc2898DeriveBytes are obsolete. Use the static Pbkdf2 method instead.

注意

The default hash algorithm and iteration counts in Rfc2898DeriveBytes constructors are outdated and insecure. Use a constructor that accepts the hash algorithm and the number of iterations.

使用密码、盐大小和迭代次数来派生密钥初始化类的新实例 Rfc2898DeriveBytes 。

public:
 Rfc2898DeriveBytes(System::String ^ password, int saltSize, int iterations);

[System.Obsolete("The constructors on Rfc2898DeriveBytes are obsolete. Use the static Pbkdf2 method instead.", DiagnosticId="SYSLIB0060", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public Rfc2898DeriveBytes(string password, int saltSize, int iterations);

public Rfc2898DeriveBytes(string password, int saltSize, int iterations);

[System.Obsolete("The default hash algorithm and iteration counts in Rfc2898DeriveBytes constructors are outdated and insecure. Use a constructor that accepts the hash algorithm and the number of iterations.", DiagnosticId="SYSLIB0041", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public Rfc2898DeriveBytes(string password, int saltSize, int iterations);

[<System.Obsolete("The constructors on Rfc2898DeriveBytes are obsolete. Use the static Pbkdf2 method instead.", DiagnosticId="SYSLIB0060", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.Rfc2898DeriveBytes : string * int * int -> System.Security.Cryptography.Rfc2898DeriveBytes

new System.Security.Cryptography.Rfc2898DeriveBytes : string * int * int -> System.Security.Cryptography.Rfc2898DeriveBytes

[<System.Obsolete("The default hash algorithm and iteration counts in Rfc2898DeriveBytes constructors are outdated and insecure. Use a constructor that accepts the hash algorithm and the number of iterations.", DiagnosticId="SYSLIB0041", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.Rfc2898DeriveBytes : string * int * int -> System.Security.Cryptography.Rfc2898DeriveBytes

Public Sub New (password As String, saltSize As Integer, iterations As Integer)

参数

password: String

用于派生密钥的密码。

saltSize: Int32

希望类生成的随机盐的大小。

iterations: Int32

操作的迭代数。

属性: ObsoleteAttribute

例外

ArgumentException

指定的盐大小小于 8 个字节，或者迭代计数小于 1。

ArgumentNullException

密码或盐是 null。

ArgumentOutOfRangeException

iterations 范围不足。此参数需要非负数。

注解

盐大小必须为 8 个字节或更大，迭代计数必须大于零。建议的最小迭代数为 1000。

有关 PBKDF2 的详细信息，请参阅 RFC 2898，标题为“PKCS #5：Password-Based 加密规范版本 2.0”。有关完整详细信息，请参阅第 5.2 节“PBKDF2”。

Important

另请参阅

加密服务

适用于

Rfc2898DeriveBytes(Byte[], Byte[], Int32, HashAlgorithmName)

Source:: Rfc2898DeriveBytes.cs

Source:: Rfc2898DeriveBytes.cs

Source:: Rfc2898DeriveBytes.cs

Source:: Rfc2898DeriveBytes.cs

Source:: Rfc2898DeriveBytes.cs

注意

The constructors on Rfc2898DeriveBytes are obsolete. Use the static Pbkdf2 method instead.

使用指定的密码、salt、迭代次数和哈希算法名称来派生密钥来初始化类的新实例 Rfc2898DeriveBytes 。

public:
 Rfc2898DeriveBytes(cli::array <System::Byte> ^ password, cli::array <System::Byte> ^ salt, int iterations, System::Security::Cryptography::HashAlgorithmName hashAlgorithm);

[System.Obsolete("The constructors on Rfc2898DeriveBytes are obsolete. Use the static Pbkdf2 method instead.", DiagnosticId="SYSLIB0060", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public Rfc2898DeriveBytes(byte[] password, byte[] salt, int iterations, System.Security.Cryptography.HashAlgorithmName hashAlgorithm);

public Rfc2898DeriveBytes(byte[] password, byte[] salt, int iterations, System.Security.Cryptography.HashAlgorithmName hashAlgorithm);

[<System.Obsolete("The constructors on Rfc2898DeriveBytes are obsolete. Use the static Pbkdf2 method instead.", DiagnosticId="SYSLIB0060", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.Rfc2898DeriveBytes : byte[] * byte[] * int * System.Security.Cryptography.HashAlgorithmName -> System.Security.Cryptography.Rfc2898DeriveBytes

new System.Security.Cryptography.Rfc2898DeriveBytes : byte[] * byte[] * int * System.Security.Cryptography.HashAlgorithmName -> System.Security.Cryptography.Rfc2898DeriveBytes

Public Sub New (password As Byte(), salt As Byte(), iterations As Integer, hashAlgorithm As HashAlgorithmName)

参数

password: Byte[]

用于派生密钥的密码。

salt: Byte[]

要用于派生密钥的键盐。

iterations: Int32

操作的迭代数。

hashAlgorithm: HashAlgorithmName

用于派生密钥的哈希算法。

属性: ObsoleteAttribute

例外

ArgumentException

属性Name为或 hashAlgorithmnull。Empty

CryptographicException

哈希算法名称无效。

适用于

Rfc2898DeriveBytes(String, Byte[], Int32, HashAlgorithmName)

Source:: Rfc2898DeriveBytes.cs

Source:: Rfc2898DeriveBytes.cs

Source:: Rfc2898DeriveBytes.cs

Source:: Rfc2898DeriveBytes.cs

Source:: Rfc2898DeriveBytes.cs

注意

The constructors on Rfc2898DeriveBytes are obsolete. Use the static Pbkdf2 method instead.

使用指定的密码、salt、迭代次数和哈希算法名称来派生密钥来初始化类的新实例 Rfc2898DeriveBytes 。

public:
 Rfc2898DeriveBytes(System::String ^ password, cli::array <System::Byte> ^ salt, int iterations, System::Security::Cryptography::HashAlgorithmName hashAlgorithm);

[System.Obsolete("The constructors on Rfc2898DeriveBytes are obsolete. Use the static Pbkdf2 method instead.", DiagnosticId="SYSLIB0060", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public Rfc2898DeriveBytes(string password, byte[] salt, int iterations, System.Security.Cryptography.HashAlgorithmName hashAlgorithm);

public Rfc2898DeriveBytes(string password, byte[] salt, int iterations, System.Security.Cryptography.HashAlgorithmName hashAlgorithm);

[<System.Obsolete("The constructors on Rfc2898DeriveBytes are obsolete. Use the static Pbkdf2 method instead.", DiagnosticId="SYSLIB0060", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.Rfc2898DeriveBytes : string * byte[] * int * System.Security.Cryptography.HashAlgorithmName -> System.Security.Cryptography.Rfc2898DeriveBytes

new System.Security.Cryptography.Rfc2898DeriveBytes : string * byte[] * int * System.Security.Cryptography.HashAlgorithmName -> System.Security.Cryptography.Rfc2898DeriveBytes

Public Sub New (password As String, salt As Byte(), iterations As Integer, hashAlgorithm As HashAlgorithmName)

参数

password: String

用于派生密钥的密码。

salt: Byte[]

要用于派生密钥的键盐。

iterations: Int32

操作的迭代数。

hashAlgorithm: HashAlgorithmName

用于派生密钥的哈希算法。

属性: ObsoleteAttribute

例外

ArgumentException

属性Name为或 hashAlgorithmnull。Empty

CryptographicException

哈希算法名称无效。

适用于

Rfc2898DeriveBytes(String, Int32, Int32, HashAlgorithmName)

Source:: Rfc2898DeriveBytes.cs

Source:: Rfc2898DeriveBytes.cs

Source:: Rfc2898DeriveBytes.cs

Source:: Rfc2898DeriveBytes.cs

Source:: Rfc2898DeriveBytes.cs

注意

The constructors on Rfc2898DeriveBytes are obsolete. Use the static Pbkdf2 method instead.

使用指定的密码、盐大小、迭代次数和哈希算法名称来派生密钥来初始化类的新实例 Rfc2898DeriveBytes 。

public:
 Rfc2898DeriveBytes(System::String ^ password, int saltSize, int iterations, System::Security::Cryptography::HashAlgorithmName hashAlgorithm);

[System.Obsolete("The constructors on Rfc2898DeriveBytes are obsolete. Use the static Pbkdf2 method instead.", DiagnosticId="SYSLIB0060", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public Rfc2898DeriveBytes(string password, int saltSize, int iterations, System.Security.Cryptography.HashAlgorithmName hashAlgorithm);

public Rfc2898DeriveBytes(string password, int saltSize, int iterations, System.Security.Cryptography.HashAlgorithmName hashAlgorithm);

[<System.Obsolete("The constructors on Rfc2898DeriveBytes are obsolete. Use the static Pbkdf2 method instead.", DiagnosticId="SYSLIB0060", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.Rfc2898DeriveBytes : string * int * int * System.Security.Cryptography.HashAlgorithmName -> System.Security.Cryptography.Rfc2898DeriveBytes

new System.Security.Cryptography.Rfc2898DeriveBytes : string * int * int * System.Security.Cryptography.HashAlgorithmName -> System.Security.Cryptography.Rfc2898DeriveBytes

Public Sub New (password As String, saltSize As Integer, iterations As Integer, hashAlgorithm As HashAlgorithmName)

参数

password: String

用于派生密钥的密码。

saltSize: Int32

希望类生成的随机盐的大小。

iterations: Int32

操作的迭代数。

hashAlgorithm: HashAlgorithmName

用于派生密钥的哈希算法。

属性: ObsoleteAttribute

例外

ArgumentOutOfRangeException

saltSize 小于零。

ArgumentException

属性Name为或 hashAlgorithmnull。Empty

CryptographicException

哈希算法名称无效。

适用于

反馈

此页面是否有帮助？