IncrementalHash.CreateHMAC メソッド

リファレンス

定義

名前空間:: System.Security.Cryptography

アセンブリ:: System.Security.Cryptography.Algorithms.dll

アセンブリ:: System.Security.Cryptography.dll

アセンブリ:: System.Core.dll

アセンブリ:: netstandard.dll

アセンブリ:: mscorlib.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

オーバーロード

CreateHMAC(HashAlgorithmName, Byte[])	指定したハッシュアルゴリズムとキーを使用してハッシュベースメッセージ認証コード (HMAC) アルゴリズムの IncrementalHash を作成します。
CreateHMAC(HashAlgorithmName, ReadOnlySpan<Byte>)	`hashAlgorithm` によって指定されているハッシュアルゴリズムと、`key` によって指定されているキーを利用して、ハッシュベースのメッセージ認証コード (HMAC) アルゴリズムに対する IncrementalHash を作成します。

CreateHMAC(HashAlgorithmName, Byte[])

指定したハッシュアルゴリズムとキーを使用してハッシュベースメッセージ認証コード (HMAC) アルゴリズムの IncrementalHash を作成します。

public:
 static System::Security::Cryptography::IncrementalHash ^ CreateHMAC(System::Security::Cryptography::HashAlgorithmName hashAlgorithm, cli::array <System::Byte> ^ key);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static System.Security.Cryptography.IncrementalHash CreateHMAC (System.Security.Cryptography.HashAlgorithmName hashAlgorithm, byte[] key);

public static System.Security.Cryptography.IncrementalHash CreateHMAC (System.Security.Cryptography.HashAlgorithmName hashAlgorithm, byte[] key);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member CreateHMAC : System.Security.Cryptography.HashAlgorithmName * byte[] -> System.Security.Cryptography.IncrementalHash

static member CreateHMAC : System.Security.Cryptography.HashAlgorithmName * byte[] -> System.Security.Cryptography.IncrementalHash

Public Shared Function CreateHMAC (hashAlgorithm As HashAlgorithmName, key As Byte()) As IncrementalHash

パラメーター

hashAlgorithm: HashAlgorithmName

HMAC 内で実行するハッシュアルゴリズムの名前。

key: Byte[]

HMAC の秘密鍵。キーの長さは任意で指定できますが、指定したハッシュアルゴリズムの出力サイズよりも長いキーは、サイズのキーが正しくなるようにハッシュされます。そのため、推奨される秘密鍵のサイズは、指定したハッシュアルゴリズムの出力サイズです。

戻り値

IncrementalHash

IncrementalHash クラスのインスタンスは、指定したハッシュアルゴリズムをすぐに計算できます。

属性: UnsupportedOSPlatformAttribute

例外

ArgumentNullException

key が nullです。

ArgumentException

hashAlgorithm.Name は、null または空の文字列です。

CryptographicException

hashAlgorithm は既知のハッシュアルゴリズムではありません。

適用対象

CreateHMAC(HashAlgorithmName, ReadOnlySpan<Byte>)

hashAlgorithm によって指定されているハッシュアルゴリズムと、key によって指定されているキーを利用して、ハッシュベースのメッセージ認証コード (HMAC) アルゴリズムに対する IncrementalHash を作成します。

public:
 static System::Security::Cryptography::IncrementalHash ^ CreateHMAC(System::Security::Cryptography::HashAlgorithmName hashAlgorithm, ReadOnlySpan<System::Byte> key);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static System.Security.Cryptography.IncrementalHash CreateHMAC (System.Security.Cryptography.HashAlgorithmName hashAlgorithm, ReadOnlySpan<byte> key);

public static System.Security.Cryptography.IncrementalHash CreateHMAC (System.Security.Cryptography.HashAlgorithmName hashAlgorithm, ReadOnlySpan<byte> key);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member CreateHMAC : System.Security.Cryptography.HashAlgorithmName * ReadOnlySpan<byte> -> System.Security.Cryptography.IncrementalHash

static member CreateHMAC : System.Security.Cryptography.HashAlgorithmName * ReadOnlySpan<byte> -> System.Security.Cryptography.IncrementalHash

Public Shared Function CreateHMAC (hashAlgorithm As HashAlgorithmName, key As ReadOnlySpan(Of Byte)) As IncrementalHash

パラメーター

hashAlgorithm: HashAlgorithmName

HMAC 内で実行するハッシュアルゴリズムの名前。

key: ReadOnlySpan<Byte>

HMAC の秘密鍵。キーは任意の長さにすることができますが、hashAlgorithm によって指定されたハッシュアルゴリズムの出力サイズより長いキーは、正しいサイズのキーになるように (hashAlgorithm によって指定されているアルゴリズムを使用して) ハッシュされます。そのため、推奨される秘密鍵のサイズは、hashAlgorithm によって指定されているハッシュの出力サイズです。