Freigeben über


ECDsa.ImportEncryptedPkcs8PrivateKey Methode

Definition

Überlädt

ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Int32)

Importiert das Paar aus öffentlichem und privatem Schlüssel aus einer PKCS#8-EncryptedPrivateKeyInfo-Struktur nach der Entschlüsselung mit einem bytebasierten Kennwort und ersetzt die Schlüssel für dieses Objekt.

ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, ReadOnlySpan<Byte>, Int32)

Importiert das Paar aus öffentlichem und privatem Schlüssel aus einer PKCS#8-EncryptedPrivateKeyInfo-Struktur nach der Entschlüsselung mit einem zeichenbasierten Kennwort und ersetzt die Schlüssel für dieses Objekt.

ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Int32)

Importiert das Paar aus öffentlichem und privatem Schlüssel aus einer PKCS#8-EncryptedPrivateKeyInfo-Struktur nach der Entschlüsselung mit einem bytebasierten Kennwort und ersetzt die Schlüssel für dieses Objekt.

public:
 override void ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<System::Byte> passwordBytes, ReadOnlySpan<System::Byte> source, [Runtime::InteropServices::Out] int % bytesRead);
public override void ImportEncryptedPkcs8PrivateKey (ReadOnlySpan<byte> passwordBytes, ReadOnlySpan<byte> source, out int bytesRead);
override this.ImportEncryptedPkcs8PrivateKey : ReadOnlySpan<byte> * ReadOnlySpan<byte> * int -> unit
Public Overrides 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.

Hinweise

Die Kennwortbytes werden direkt an die Schlüsselableitungsfunktion (Key Deivation Function, KDF) übergeben, die vom Algorithmus verwendet wird, der durch den EncryptedPrivateKeyInfo-Inhalt angegeben 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.

Gilt für:

ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, ReadOnlySpan<Byte>, Int32)

Importiert das Paar aus öffentlichem und privatem Schlüssel aus einer PKCS#8-EncryptedPrivateKeyInfo-Struktur nach der Entschlüsselung mit einem zeichenbasierten Kennwort und ersetzt die Schlüssel für dieses Objekt.

public:
 override void ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<char> password, ReadOnlySpan<System::Byte> source, [Runtime::InteropServices::Out] int % bytesRead);
public override void ImportEncryptedPkcs8PrivateKey (ReadOnlySpan<char> password, ReadOnlySpan<byte> source, out int bytesRead);
override this.ImportEncryptedPkcs8PrivateKey : ReadOnlySpan<char> * ReadOnlySpan<byte> * int -> unit
Public Overrides 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.

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.

Gilt für: