AsymmetricAlgorithm.ImportEncryptedPkcs8PrivateKey Methode

Definition

Ü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 pbeParametersangegebenen 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 .

Gilt für: