AsymmetricAlgorithm.ImportEncryptedPkcs8PrivateKey Methode

Definition

Namespace:

System.Security.Cryptography

Assembly:

System.Security.Cryptography.Primitives.dll

Assembly:

System.Security.Cryptography.dll

Assembly:

netstandard.dll

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

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

CryptographicException

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.

NotImplementedException

Ein abgeleiteter Typ hat diesen Member nicht überschrieben.

Hinweise

Die Kennwortbytes werden direkt an die Key Derivation Function (KDF) übergeben, die von dem algorithmus verwendet wird, der von pbeParameters. 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 base64-decodeieren, bevor diese Methode aufgerufen wird.

Da algorithmusspezifische Unterstützung erforderlich ist, um den Inhalt dieses Datenformats zu interpretieren, ImportEncryptedPkcs8PrivateKey wird standardmäßig ein NotImplementedException Fehler ausgelöst.

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.

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

CryptographicException

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.

NotImplementedException

Ein abgeleiteter Typ hat diesen Member nicht überschrieben.

Hinweise

Wenn der Inhalt source eines Algorithmus angegeben wird, 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 base64-decodeieren, bevor diese Methode aufgerufen wird.

Da algorithmusspezifische Unterstützung erforderlich ist, um den Inhalt dieses Datenformats zu interpretieren, ImportEncryptedPkcs8PrivateKey wird standardmäßig ein NotImplementedException Fehler ausgelöst.