Pkcs12Builder.SealWithMac Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ü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
- 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
- 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.