AsymmetricAlgorithm.ImportEncryptedPkcs8PrivateKey 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
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Int32) |
Wenn das Element in eine abgeleitete Klasse überschrieben wird, wird das öffentliche/private Schlüsselpaar aus einer PKCS#8-EncryptedPrivateKeyInfo-Struktur nach der Entschlüsselung mit einem bytebasierten Kennwort importiert und ersetzt die Schlüssel für dieses Objekt. |
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, ReadOnlySpan<Byte>, Int32) |
Wenn das Element in eine abgeleitete Klasse überschrieben wird, wird das öffentliche/private Schlüsselpaar aus einer PKCS#8-EncryptedPrivateKeyInfo-Struktur nach der Entschlüsselung mit einem zeichenbasierten Kennwort importiert und ersetzt die Schlüssel für dieses Objekt. |
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Int32)
- Quelle:
- AsymmetricAlgorithm.cs
- Quelle:
- AsymmetricAlgorithm.cs
- Quelle:
- AsymmetricAlgorithm.cs
Wenn das Element in eine abgeleitete Klasse überschrieben wird, wird das öffentliche/private Schlüsselpaar aus einer PKCS#8-EncryptedPrivateKeyInfo-Struktur nach der Entschlüsselung mit einem bytebasierten Kennwort importiert und ersetzt die Schlüssel für dieses Objekt.
public:
virtual void ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<System::Byte> passwordBytes, ReadOnlySpan<System::Byte> source, [Runtime::InteropServices::Out] int % bytesRead);
public virtual void ImportEncryptedPkcs8PrivateKey (ReadOnlySpan<byte> passwordBytes, ReadOnlySpan<byte> source, out int bytesRead);
abstract member ImportEncryptedPkcs8PrivateKey : ReadOnlySpan<byte> * ReadOnlySpan<byte> * int -> unit
override this.ImportEncryptedPkcs8PrivateKey : ReadOnlySpan<byte> * ReadOnlySpan<byte> * int -> unit
Public Overridable Sub ImportEncryptedPkcs8PrivateKey (passwordBytes As ReadOnlySpan(Of Byte), source As ReadOnlySpan(Of Byte), ByRef bytesRead As Integer)
Parameter
- passwordBytes
- ReadOnlySpan<Byte>
Die Bytes, die als Kennwort bei der Entschlüsselung des Schlüsselmaterials verwendet werden.
- source
- ReadOnlySpan<Byte>
Die Bytes einer PKCS#8-EncryptedPrivateKeyInfo-Struktur in der ASN.1-BER-Codierung.
- bytesRead
- Int32
In der Rückgabe dieser Methode ist die Anzahl der Bytes enthalten, die aus source
gelesen wurden. Dieser Parameter wird nicht initialisiert behandelt.
Ausnahmen
Das Kennwort ist falsch.
- oder -
Der Inhalt von source
gibt an, dass die anzuwendende Schlüsselableitungsfunktion die Legacy-PKCS#12-KDF ist, die Char-basierte Kennwörter erfordert.
- oder -
Der Inhalt von source
stellt keine ASN.1-BER-codierte PKCS#8-EncryptedPrivateKeyInfo-Struktur dar.
- oder -
Der Inhalt von source
gibt an, dass der Schlüssel für einen anderen Algorithmus als den von dieser Instanz dargestellten Algorithmus gilt.
- oder -
Der Inhalt von source
stellt den Schlüssel in einem Format dar, das nicht unterstützt wird.
- oder -
Fehler beim Importieren des algorithmusspezifischen Schlüssels.
Ein abgeleiteter Typ hat diesen Member nicht überschrieben.
Hinweise
Die Kennwortbytes werden direkt an die Schlüsselableitungsfunktion (Key Deivation Function, KDF) übergeben, die vom durch pbeParameters
angegebenen Algorithmus verwendet wird.
Dies ermöglicht die Kompatibilität mit anderen Systemen, die bei der Verarbeitung von Kennwörtern mit PBKDF2 (Kennwortbasierte Schlüsselableitungsfunktion 2) eine andere Textcodierung als UTF-8 verwenden.
Diese Methode unterstützt nur die binäre Codierung (BER/CER/DER) von EncryptedPrivateKeyInfo. Wenn der Wert Base64-codiert oder im PEM-Textformat ist, muss der Aufrufer den Inhalt base64 decodieren, bevor er diese Methode aufruft.
Da algorithmusspezifische Unterstützung erforderlich ist, um den Inhalt dieses Datenformats zu interpretieren, ImportEncryptedPkcs8PrivateKey löst standardmäßig eine aus NotImplementedException .
Gilt für:
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, ReadOnlySpan<Byte>, Int32)
- Quelle:
- AsymmetricAlgorithm.cs
- Quelle:
- AsymmetricAlgorithm.cs
- Quelle:
- AsymmetricAlgorithm.cs
Wenn das Element in eine abgeleitete Klasse überschrieben wird, wird das öffentliche/private Schlüsselpaar aus einer PKCS#8-EncryptedPrivateKeyInfo-Struktur nach der Entschlüsselung mit einem zeichenbasierten Kennwort importiert und ersetzt die Schlüssel für dieses Objekt.
public:
virtual void ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<char> password, ReadOnlySpan<System::Byte> source, [Runtime::InteropServices::Out] int % bytesRead);
public virtual void ImportEncryptedPkcs8PrivateKey (ReadOnlySpan<char> password, ReadOnlySpan<byte> source, out int bytesRead);
abstract member ImportEncryptedPkcs8PrivateKey : ReadOnlySpan<char> * ReadOnlySpan<byte> * int -> unit
override this.ImportEncryptedPkcs8PrivateKey : ReadOnlySpan<char> * ReadOnlySpan<byte> * int -> unit
Public Overridable Sub ImportEncryptedPkcs8PrivateKey (password As ReadOnlySpan(Of Char), source As ReadOnlySpan(Of Byte), ByRef bytesRead As Integer)
Parameter
- password
- ReadOnlySpan<Char>
Das Kennwort, das bei der Entschlüsselung des Schlüsselmaterials verwendet werden soll.
- source
- ReadOnlySpan<Byte>
Die Bytes einer PKCS#8-EncryptedPrivateKeyInfo-Struktur in der ASN.1-BER-Codierung.
- bytesRead
- Int32
In der Rückgabe dieser Methode ist die Anzahl der Bytes enthalten, die aus source
gelesen wurden. Dieser Parameter wird nicht initialisiert behandelt.
Ausnahmen
Das Kennwort ist falsch.
- oder -
Der Inhalt von source
stellt keine ASN.1-BER-codierte PKCS#8-EncryptedPrivateKeyInfo-Struktur dar.
- oder -
Der Inhalt von source
gibt an, dass der Schlüssel für einen anderen Algorithmus als den von dieser Instanz dargestellten Algorithmus gilt.
- oder -
Der Inhalt von source
stellt den Schlüssel in einem Format dar, das nicht unterstützt wird.
- oder -
Fehler beim Importieren des algorithmusspezifischen Schlüssels.
Ein abgeleiteter Typ hat diesen Member nicht überschrieben.
Hinweise
Wenn der Inhalt von source
auf einen Algorithmus hinweist, der PBKDF1 (Kennwortbasierte Schlüsselableitungsfunktion 1) oder PBKDF2 (Kennwortbasierte Schlüsselableitungsfunktion 2) verwendet, wird das Kennwort über die UTF-8-Codierung in Bytes konvertiert.
Diese Methode unterstützt nur die binäre Codierung (BER/CER/DER) von EncryptedPrivateKeyInfo. Wenn der Wert Base64-codiert oder im PEM-Textformat ist, muss der Aufrufer den Inhalt base64 decodieren, bevor er diese Methode aufruft.
Da algorithmusspezifische Unterstützung erforderlich ist, um den Inhalt dieses Datenformats zu interpretieren, ImportEncryptedPkcs8PrivateKey löst standardmäßig eine aus NotImplementedException .