ECDsa.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) |
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) |
Importuje veřejný/privátní klíčpair ze struktury PKCS#8 EncryptedPrivateKeyInfo po dešifrování heslem založeným na znaku a nahradí klíče pro tento objekt. |
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Int32)
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:
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)
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ů přečtených z source
. Tento parametr je považován za neinicializovaný.
Výjimky
Heslo je nesprávné.
-nebo-
Obsah označuje source
, že se má použít funkce KDF (Key Derivation Function), která se má použít, je starší verze PKCS#12 KDF, která vyžaduje Charhesla založená na klíči.
-nebo-
Obsah souboru source
nepředstavuje strukturu PKCS#8 EncryptedPrivateKeyInfo s kódováním ASN.1-BER.
-nebo-
Obsah indikuje source
, že klíč je pro jiný algoritmus než algoritmus reprezentovaný touto instancí.
-nebo-
Obsah představuje source
klíč ve formátu, který není podporován.
-nebo-
Import klíče specifického pro algoritmus se nezdařil.
Poznámky
Bajty hesla se předávají přímo do funkce KDF (Key Derivation Function), kterou používá algoritmus označený obsahem EncryptedPrivateKeyInfo. To umožňuje kompatibilitu s jinými systémy, které při zpracování hesel pomocí PBKDF2 (Funkce odvození klíče založeného na heslech 2) používají jiné kódování textu než UTF-8. Tato metoda podporuje pouze binární kódování (BER/CER/DER) EncryptedPrivateKeyInfo. Pokud je hodnota v kódování Base64 nebo v textovém formátu PEM, volající musí před voláním této metody dekódovat obsah base64.
Platí pro
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, ReadOnlySpan<Byte>, Int32)
Importuje veřejný/privátní klíčpair ze struktury PKCS#8 EncryptedPrivateKeyInfo po dešifrování heslem založeným na znaku a nahradí klíče pro tento 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)
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ů přečtených z source
. Tento parametr je považován za neinicializovaný.
Výjimky
Heslo je nesprávné.
-nebo-
Obsah souboru source
nepředstavuje strukturu PKCS#8 EncryptedPrivateKeyInfo s kódováním ASN.1-BER.
-nebo-
Obsah indikuje source
, že klíč je pro jiný algoritmus než algoritmus reprezentovaný touto instancí.
-nebo-
Obsah představuje source
klíč ve formátu, který není podporován.
-nebo-
Import klíče specifického pro algoritmus se nezdařil.
Poznámky
Pokud obsah source
indikuje algoritmus, který používá PBKDF1 (funkce odvození klíče založeného na heslech 1) nebo PBKDF2 (funkce odvození klíče založeného 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 v kódování Base64 nebo v textovém formátu PEM, volající musí před voláním této metody dekódovat obsah base64.