HKDF.DeriveKey 方法

定義

命名空間:

System.Security.Cryptography

組件:

System.Security.Cryptography.dll

多載

DeriveKey(HashAlgorithmName, Byte[], Int32, Byte[], Byte[])	執行金鑰衍生 HKDF 擴展和擷取函數。
DeriveKey(HashAlgorithmName, ReadOnlySpan<Byte>, Span<Byte>, ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)	執行金鑰衍生 HKDF 擴展和擷取函數。

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

來源:

HKDF.cs

執行金鑰衍生 HKDF 擴展和擷取函數。

public static byte[] DeriveKey (System.Security.Cryptography.HashAlgorithmName hashAlgorithmName, byte[] ikm, int outputLength, byte[]? salt = default, byte[]? info = default);

static member DeriveKey : System.Security.Cryptography.HashAlgorithmName * byte[] * int * byte[] * byte[] -> byte[]

Public Shared Function DeriveKey (hashAlgorithmName As HashAlgorithmName, ikm As Byte(), outputLength As Integer, Optional salt As Byte() = Nothing, Optional info As Byte() = Nothing) As Byte()

參數

hashAlgorithmName

HashAlgorithmName

用於 HMAC 作業的哈希演算法。

ikm

Byte[]

輸入金鑰產製原料。

outputLength

Int32

輸出金鑰產製原料的長度。

salt

Byte[]

選用的 salt 值 (非秘密的隨機值)。 如未提供，則預設為與所指定雜湊演算法的輸出相同長度的位元組陣列。

info

Byte[]

選用的內容和應用程式特有資訊。

傳回

Byte[]

輸出金鑰產製原料。

例外狀況

ArgumentNullException

ikm 為 null。

ArgumentOutOfRangeException

outputLength 小於 1。

DeriveKey(HashAlgorithmName, ReadOnlySpan<Byte>, Span<Byte>, ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)

來源:

HKDF.cs

執行金鑰衍生 HKDF 擴展和擷取函數。

public:
 static void DeriveKey(System::Security::Cryptography::HashAlgorithmName hashAlgorithmName, ReadOnlySpan<System::Byte> ikm, Span<System::Byte> output, ReadOnlySpan<System::Byte> salt, ReadOnlySpan<System::Byte> info);

public static void DeriveKey (System.Security.Cryptography.HashAlgorithmName hashAlgorithmName, ReadOnlySpan<byte> ikm, Span<byte> output, ReadOnlySpan<byte> salt, ReadOnlySpan<byte> info);

static member DeriveKey : System.Security.Cryptography.HashAlgorithmName * ReadOnlySpan<byte> * Span<byte> * ReadOnlySpan<byte> * ReadOnlySpan<byte> -> unit

Public Shared Sub DeriveKey (hashAlgorithmName As HashAlgorithmName, ikm As ReadOnlySpan(Of Byte), output As Span(Of Byte), salt As ReadOnlySpan(Of Byte), info As ReadOnlySpan(Of Byte))

參數

hashAlgorithmName

HashAlgorithmName

用於 HMAC 作業的哈希演算法。

ikm

ReadOnlySpan<Byte>

輸入金鑰產製原料。

output

Span<Byte>

代表輸出金鑰產製原料的輸出緩衝區。

salt

ReadOnlySpan<Byte>

salt 值 (非秘密的隨機值)。

info

ReadOnlySpan<Byte>

內容和應用程式的特有資訊 (可以是空的範圍)。

例外狀況

ArgumentException

ikm 是空的，或大於允許的最大長度。