AsymmetricAlgorithm.ImportEncryptedPkcs8PrivateKey Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Přetížení
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Int32) |
Při přepsání v odvozené třídě importuje veřejný/privátní klíčpair ze struktury PKCS#8 EncryptedPrivateKeyInfo po dešifrování pomocí bajtového hesla a nahradí klíče pro tento objekt. |
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, ReadOnlySpan<Byte>, Int32) |
Při přepsání v odvozené třídě importuje veřejný/privátní klíčpair z PKCS#8 EncryptedPrivateKeyInfo struktury po dešifrování pomocí hesla založeného na znaku a nahraďte klíče pro tento objekt. |
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Int32)
Při přepsání v odvozené třídě importuje veřejný/privátní klíčpair ze struktury PKCS#8 EncryptedPrivateKeyInfo po dešifrování pomocí bajtového hesla a nahradí klíče pro tento 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)
Parametry
- passwordBytes
- ReadOnlySpan<Byte>
Bajty, které se mají použít jako heslo při dešifrování materiálu klíče.
- source
- ReadOnlySpan<Byte>
Bajty struktury PKCS#8 EncryptedPrivateKeyInfo v kódování ASN.1-BER.
- bytesRead
- Int32
Když tato metoda vrátí, obsahuje hodnotu, která označuje počet bajtů načtených z source
. Tento parametr se považuje za neinicializovaný.
Výjimky
Heslo je nesprávné.
-nebo-
Obsah source
označující funkci odvození klíče (KDF), která se má použít, je starší verze PKCS#12 KDF, která vyžaduje Charhesla založená na jazyce.
-nebo-
Obsah source
nepředstavuje strukturu PKCS#8 EncryptedPrivateKeyInfo s kódováním ASN.1-BER.
-nebo-
Obsah indikace source
, že klíč je pro algoritmus jiný než algoritmus reprezentovaný touto instancí.
-nebo-
Obsah source
představuje klíč ve formátu, který není podporován.
-nebo-
Import klíče specifického pro algoritmus selhal.
Odvozený typ nepřepíše tento člen.
Poznámky
Bajty hesla se předávají přímo do funkce KDF (Key Derivation Function), kterou používá algoritmus označený pbeParameters
.
To umožňuje kompatibilitu s jinými systémy, které používají kódování textu jiné než UTF-8 při zpracování hesel pomocí PBKDF2 (funkce odvození klíče založeného na heslech 2).
Tato metoda podporuje pouze binární kódování (BER/CER/DER) encryptedPrivateKeyInfo. Pokud je hodnota kódování Base64 nebo ve formátu textu PEM, volající musí před voláním této metody dekódovat obsah base64.
Vzhledem k tomu, že podpora specifická pro algoritmus je nutná k interpretaci obsahu tohoto formátu dat, ImportEncryptedPkcs8PrivateKey vyvolá NotImplementedException ve výchozím nastavení hodnotu.
Platí pro
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, ReadOnlySpan<Byte>, Int32)
Při přepsání v odvozené třídě importuje veřejný/privátní klíčpair z PKCS#8 EncryptedPrivateKeyInfo struktury po dešifrování pomocí hesla založeného na znaku a nahraďte klíče pro tento 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)
Parametry
- password
- ReadOnlySpan<Char>
Heslo, které se má použít k dešifrování materiálu klíče.
- source
- ReadOnlySpan<Byte>
Bajty struktury PKCS#8 EncryptedPrivateKeyInfo v kódování ASN.1-BER.
- bytesRead
- Int32
Když tato metoda vrátí, obsahuje hodnotu, která označuje počet bajtů načtených z source
. Tento parametr se považuje za neinicializovaný.
Výjimky
Heslo je nesprávné.
-nebo-
Obsah source
nepředstavuje strukturu PKCS#8 EncryptedPrivateKeyInfo s kódováním ASN.1-BER.
-nebo-
Obsah indikace source
, že klíč je pro algoritmus jiný než algoritmus reprezentovaný touto instancí.
-nebo-
Obsah source
představuje klíč ve formátu, který není podporován.
-nebo-
Import klíče specifického pro algoritmus selhal.
Odvozený typ nepřepíše tento člen.
Poznámky
Pokud obsah indikuje source
algoritmus, který používá PBKDF1 (funkce odvození klíče na základě hesla 1) nebo PBKDF2 (funkce odvození klíče založené na heslech 2), heslo se převede na bajty prostřednictvím kódování UTF-8.
Tato metoda podporuje pouze binární kódování (BER/CER/DER) encryptedPrivateKeyInfo. Pokud je hodnota kódování Base64 nebo ve formátu textu PEM, volající musí před voláním této metody dekódovat obsah base64.
Vzhledem k tomu, že podpora specifická pro algoritmus je nutná k interpretaci obsahu tohoto formátu dat, ImportEncryptedPkcs8PrivateKey vyvolá NotImplementedException ve výchozím nastavení hodnotu.