Pkcs12Builder.SealWithMac Metoda

Definicja

Przestrzeń nazw:

System.Security.Cryptography.Pkcs

Zestaw:

System.Security.Cryptography.Pkcs.dll

Pakiet:

System.Security.Cryptography.Pkcs v9.0.0-preview.3.24172.9

Przeciążenia

SealWithMac(ReadOnlySpan<Char>, HashAlgorithmName, Int32)	Uszczelnia plik PFX przed dalszymi zmianami, stosując kod uwierzytelniania komunikatów oparty na haśle (MAC) w zawartości z hasłem z zakresu.
SealWithMac(String, HashAlgorithmName, Int32)	Uszczelnia plik PFX przed dalszymi zmianami, stosując kod uwierzytelniania komunikatów oparty na hasłach (MAC) na zawartości z hasłem z ciągu.

SealWithMac(ReadOnlySpan<Char>, HashAlgorithmName, Int32)

Źródło:

Pkcs12Builder.cs

Uszczelnia plik PFX przed dalszymi zmianami, stosując kod uwierzytelniania komunikatów oparty na haśle (MAC) w zawartości z hasłem z zakresu.

public:
 void SealWithMac(ReadOnlySpan<char> password, System::Security::Cryptography::HashAlgorithmName hashAlgorithm, int iterationCount);

public void SealWithMac (ReadOnlySpan<char> password, System.Security.Cryptography.HashAlgorithmName hashAlgorithm, int iterationCount);

member this.SealWithMac : ReadOnlySpan<char> * System.Security.Cryptography.HashAlgorithmName * int -> unit

Public Sub SealWithMac (password As ReadOnlySpan(Of Char), hashAlgorithm As HashAlgorithmName, iterationCount As Integer)

Parametry

password

ReadOnlySpan<Char>

Hasło do użycia jako klucz do przetwarzania komputera MAC.

hashAlgorithm

HashAlgorithmName

Algorytm skrótu do użycia podczas przetwarzania komputera MAC.

iterationCount

Int32

Liczba iteracji funkcji wyprowadzania kluczy (KDF) używana podczas przetwarzania komputera MAC.

Wyjątki

ArgumentOutOfRangeException

Parametr iterationCount jest mniejszy lub równy 0.

InvalidOperationException

Plik PFX jest już zapieczętowany (IsSealed to true).

Uwagi

Dowolny algorytm skrótu akceptowany przez tę metodę może zostać przetworzony przez klasę Pkcs12Info . Niektóre opcje algorytmu skrótu mogą powodować błędy w X509Certificate2 niektórych systemach operacyjnych lub X509Certificate2Collection.Import w niektórych systemach operacyjnych, ponieważ te metody zależą od bibliotek systemowych do obsługi.

Algorytm skrótu używany podczas nowej instalacji systemu Windows 7 podczas eksportowania za pośrednictwem Export jako PKCS#12 PFX ma SHA1 liczbę iteracji 2000. Ze względu na problemy z kolizją z algorytmem SHA1 firma Microsoft zaleca model zabezpieczeń oparty na algorytmie SHA256 lub lepszym; jednak niektórzy czytelnicy PFX mogą obsługiwać tylko algorytm SHA1.

SealWithMac(String, HashAlgorithmName, Int32)

Źródło:

Pkcs12Builder.cs

Uszczelnia plik PFX przed dalszymi zmianami, stosując kod uwierzytelniania komunikatów oparty na hasłach (MAC) na zawartości z hasłem z ciągu.

public:
 void SealWithMac(System::String ^ password, System::Security::Cryptography::HashAlgorithmName hashAlgorithm, int iterationCount);

public void SealWithMac (string? password, System.Security.Cryptography.HashAlgorithmName hashAlgorithm, int iterationCount);

member this.SealWithMac : string * System.Security.Cryptography.HashAlgorithmName * int -> unit

Public Sub SealWithMac (password As String, hashAlgorithm As HashAlgorithmName, iterationCount As Integer)

Parametry

password

String

Hasło do użycia jako klucz do przetwarzania komputera MAC.

hashAlgorithm

HashAlgorithmName

Algorytm skrótu do użycia podczas przetwarzania komputera MAC.

iterationCount

Int32

Liczba iteracji funkcji wyprowadzania kluczy (KDF) używana podczas przetwarzania komputera MAC.

Wyjątki

ArgumentOutOfRangeException

Parametr iterationCount jest mniejszy lub równy 0.

InvalidOperationException

Plik PFX jest już zapieczętowany (IsSealed to true).

Uwagi

Dowolny algorytm skrótu akceptowany przez tę metodę może zostać przetworzony przez klasę Pkcs12Info . Niektóre opcje algorytmu skrótu mogą powodować błędy w X509Certificate2 niektórych systemach operacyjnych lub X509Certificate2Collection.Import w niektórych systemach operacyjnych, ponieważ te metody zależą od bibliotek systemowych do obsługi.

Algorytm skrótu używany podczas nowej instalacji systemu Windows 7 podczas eksportowania za pośrednictwem X509Certificate.Export jako PKCS#12 PFX ma SHA1 liczbę iteracji 2000. Ze względu na problemy z kolizją z algorytmem SHA1 firma Microsoft zaleca model zabezpieczeń oparty na algorytmie SHA256 lub lepszym; jednak niektórzy czytelnicy PFX mogą obsługiwać tylko algorytm SHA1.