Freigeben über


Pkcs12Builder.SealWithMac Methode

Definition

Überlädt

SealWithMac(ReadOnlySpan<Char>, HashAlgorithmName, Int32)

Versiegelt die PFX-Datei, um weitere Änderungen zu verhindern. Hierzu wird mit einem Kennwort aus einem Bereich auf den Inhalt ein kennwortbasierter Nachrichtenauthentifizierungscode (MAC) angewendet.

SealWithMac(String, HashAlgorithmName, Int32)

Versiegelt die PFX-Datei, um weitere Änderungen zu verhindern. Hierzu wird mit einem Kennwort aus einer Zeichenfolge auf den Inhalt ein kennwortbasierter Nachrichtenauthentifizierungscode (MAC) angewendet.

SealWithMac(ReadOnlySpan<Char>, HashAlgorithmName, Int32)

Quelle:
Pkcs12Builder.cs
Quelle:
Pkcs12Builder.cs
Quelle:
Pkcs12Builder.cs
Quelle:
Pkcs12Builder.cs

Versiegelt die PFX-Datei, um weitere Änderungen zu verhindern. Hierzu wird mit einem Kennwort aus einem Bereich auf den Inhalt ein kennwortbasierter Nachrichtenauthentifizierungscode (MAC) angewendet.

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)

Parameter

password
ReadOnlySpan<Char>

Das Kennwort, das als Schlüssel zum Berechnen des Nachrichtenauthentifizierungscodes (Message Authentication Code, MAC) verwendet werden soll.

hashAlgorithm
HashAlgorithmName

Der Hashalgorithmus, der beim Berechnen des Nachrichtenauthentifizierungscodes (MAC) verwendet werden soll.

iterationCount
Int32

Die Anzahl von Iterationen für die Schlüsselableitungsfunktion (Key Derivation Function, KDF), die beim Berechnen des Nachrichtenauthentifizierungscodes (MAC) verwendet wird.

Ausnahmen

Der iterationCount-Parameter ist kleiner oder gleich 0.

Die PFX-Datei ist bereits versiegelt (IsSealed ist true).

Hinweise

Jeder Hashalgorithmus, den diese Methode akzeptiert, kann von der Pkcs12Info -Klasse verarbeitet werden. Einige Optionen des Hashalgorithmus können in X509Certificate2 oder X509Certificate2Collection.Import auf einigen Betriebssystemen zu Fehlern führen, da diese Methoden von Systembibliotheken für die Unterstützung abhängig sind.

Der Hashalgorithmus, der bei einer Neuinstallation von Windows 7 beim Exportieren als Export PKCS#12 PFX verwendet wird, weist SHA1 eine Iterationsanzahl von 2000 auf. Aufgrund von Kollisionsproblemen mit SHA1 empfiehlt Microsoft ein Sicherheitsmodell, das auf SHA256 oder besser basiert; Einige PFX-Leser unterstützen jedoch möglicherweise nur SHA1.

Gilt für:

SealWithMac(String, HashAlgorithmName, Int32)

Quelle:
Pkcs12Builder.cs
Quelle:
Pkcs12Builder.cs
Quelle:
Pkcs12Builder.cs
Quelle:
Pkcs12Builder.cs

Versiegelt die PFX-Datei, um weitere Änderungen zu verhindern. Hierzu wird mit einem Kennwort aus einer Zeichenfolge auf den Inhalt ein kennwortbasierter Nachrichtenauthentifizierungscode (MAC) angewendet.

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);
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)

Parameter

password
String

Das Kennwort, das als Schlüssel zum Berechnen des Nachrichtenauthentifizierungscodes (Message Authentication Code, MAC) verwendet werden soll.

hashAlgorithm
HashAlgorithmName

Der Hashalgorithmus, der beim Berechnen des Nachrichtenauthentifizierungscodes (MAC) verwendet werden soll.

iterationCount
Int32

Die Anzahl von Iterationen für die Schlüsselableitungsfunktion (Key Derivation Function, KDF), die beim Berechnen des Nachrichtenauthentifizierungscodes (MAC) verwendet wird.

Ausnahmen

Der iterationCount-Parameter ist kleiner oder gleich 0.

Die PFX-Datei ist bereits versiegelt (IsSealed ist true).

Hinweise

Jeder Hashalgorithmus, den diese Methode akzeptiert, kann von der Pkcs12Info -Klasse verarbeitet werden. Einige Optionen des Hashalgorithmus können in X509Certificate2 oder X509Certificate2Collection.Import auf einigen Betriebssystemen zu Fehlern führen, da diese Methoden von Systembibliotheken für die Unterstützung abhängig sind.

Der Hashalgorithmus, der bei einer Neuinstallation von Windows 7 beim Exportieren als X509Certificate.Export PKCS#12 PFX verwendet wird, weist SHA1 eine Iterationsanzahl von 2000 auf. Aufgrund von Kollisionsproblemen mit SHA1 empfiehlt Microsoft ein Sicherheitsmodell, das auf SHA256 oder besser basiert; Einige PFX-Leser unterstützen jedoch möglicherweise nur SHA1.

Gilt für: