語言

HMACSHA1 建構函式

定義

命名空間:
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

初始化 HMACSHA1 類別的新執行個體。

多載

名稱 Description
HMACSHA1()

初始化一個隨機產生的鍵值的類別新實例 HMACSHA1 。
HMACSHA1(Byte[], Boolean)
已淘汰.

初始化一個新的類別實例 HMACSHA1 ，包含指定的金鑰資料及是否使用受管理版本的 SHA-1 演算法值。
HMACSHA1(Byte[])

初始化一個包含指定金鑰資料的新 HMACSHA1 類別實例。

HMACSHA1()

來源:
HMACSHA1.cs
來源:
HMACSHA1.cs
來源:
HMACSHA1.cs
來源:
HMACSHA1.cs
來源:
HMACSHA1.cs

初始化一個隨機產生的鍵值的類別新實例 HMACSHA1 。

public:
 HMACSHA1();
public HMACSHA1();
Public Sub New ()

備註

HMACSHA1 是一種由 SHA-1 雜湊函數構成的鍵控雜湊演算法，並用作基於雜湊的訊息驗證碼（HMAC）。 HMAC 程序會將秘密金鑰與訊息資料混合，利用雜湊函數雜湊結果，再將該雜湊值與秘密金鑰混合，然後再套用雜湊函數第二次。 輸出雜湊值長度為 160 位元（20 位元組）。

此建構器使用一個 64 位元組、隨機產生的金鑰。

由於 SHA-1 有碰撞問題，Microsoft 建議使用 SHA-256。

另請參閱

適用於

HMACSHA1(Byte[], Boolean)

來源:
HMACSHA1.cs
來源:
HMACSHA1.cs
來源:
HMACSHA1.cs
來源:
HMACSHA1.cs
來源:
HMACSHA1.cs

警告

HMACSHA1 always uses the algorithm implementation provided by the platform. Use a constructor without the useManagedSha1 parameter.

初始化一個新的類別實例 HMACSHA1 ，包含指定的金鑰資料及是否使用受管理版本的 SHA-1 演算法值。

public:
 HMACSHA1(cli::array <System::Byte> ^ key, bool useManagedSha1);
[System.Obsolete("HMACSHA1 always uses the algorithm implementation provided by the platform. Use a constructor without the useManagedSha1 parameter.", DiagnosticId="SYSLIB0030", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public HMACSHA1(byte[] key, bool useManagedSha1);
public HMACSHA1(byte[] key, bool useManagedSha1);
[<System.Obsolete("HMACSHA1 always uses the algorithm implementation provided by the platform. Use a constructor without the useManagedSha1 parameter.", DiagnosticId="SYSLIB0030", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Cryptography.HMACSHA1 : byte[] * bool -> System.Security.Cryptography.HMACSHA1
new System.Security.Cryptography.HMACSHA1 : byte[] * bool -> System.Security.Cryptography.HMACSHA1
Public Sub New (key As Byte(), useManagedSha1 As Boolean)

參數

key
Byte[]

HMAC 計算的祕密金鑰。 金鑰長度可以任意，但若超過 64 位元組，則會透過 SHA-1 雜湊得 20 位元組金鑰。 因此，建議的秘密金鑰大小為 64 位元組。

useManagedSha1
Boolean

true使用 SHA-1 演算法的受管理實作（類別SHA1Managed）;false使用非受管理實作（類別）。SHA1CryptoServiceProvider

屬性
ObsoleteAttribute

備註

由於 SHA-1 發生衝突問題，Microsoft 建議採用基於 SHA-256 或更高層級的安全性模型。

適用於

HMACSHA1(Byte[])

來源:
HMACSHA1.cs
來源:
HMACSHA1.cs
來源:
HMACSHA1.cs
來源:
HMACSHA1.cs
來源:
HMACSHA1.cs

初始化一個包含指定金鑰資料的新 HMACSHA1 類別實例。

public:
 HMACSHA1(cli::array <System::Byte> ^ key);
public:
 HMACSHA1(cli::array <System::Byte> ^ rgbKey);
public HMACSHA1(byte[] key);
public HMACSHA1(byte[] rgbKey);
new System.Security.Cryptography.HMACSHA1 : byte[] -> System.Security.Cryptography.HMACSHA1
new System.Security.Cryptography.HMACSHA1 : byte[] -> System.Security.Cryptography.HMACSHA1
Public Sub New (key As Byte())
Public Sub New (rgbKey As Byte())

參數

keyrgbKey
Byte[]

加密的 HMACSHA1 秘密金鑰。 金鑰長度可以任意，但若長度超過 64 位元組，則會透過雜湊（使用 SHA-1）推導出 64 位元組的金鑰。 因此，建議的秘密金鑰大小為 64 位元組。

例外狀況

ArgumentNullException

參數 key 為 null。

範例

關於如何使用此建構子的範例，請參閱類別。HMACSHA1

備註

HMACSHA1 是一種由 SHA-1 雜湊函數構成的鍵控雜湊演算法，並用作基於雜湊的訊息驗證碼（HMAC）。 HMAC 程序會將秘密金鑰與訊息資料混合，利用雜湊函數雜湊結果，再將該雜湊值與秘密金鑰混合，然後再套用雜湊函數第二次。 輸出雜湊值長度為 160 位元（20 位元組）。

Note

此建構子透過使用 類別 SHA1CryptoServiceProvider 建立一個未受管理的演算法實例。

由於 SHA-1 發生衝突問題，Microsoft 建議採用基於 SHA-256 或更高層級的安全性模型。

另請參閱

適用於