ECAlgorithm.ImportFromEncryptedPem Metoda

Definicja

Przestrzeń nazw:

System.Security.Cryptography

Zestaw:

System.Security.Cryptography.dll

Przeciążenia

ImportFromEncryptedPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>)	Importuje zaszyfrowany klucz prywatny zakodowany w formacie PEM RFC 7468, zastępując klucze dla tego obiektu.
ImportFromEncryptedPem(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)	Importuje zaszyfrowany klucz prywatny zakodowany w formacie PEM RFC 7468, zastępując klucze dla tego obiektu.

ImportFromEncryptedPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>)

Źródło:

ECAlgorithm.cs

Importuje zaszyfrowany klucz prywatny zakodowany w formacie PEM RFC 7468, zastępując klucze dla tego obiektu.

public:
 override void ImportFromEncryptedPem(ReadOnlySpan<char> input, ReadOnlySpan<char> password);

public override void ImportFromEncryptedPem (ReadOnlySpan<char> input, ReadOnlySpan<char> password);

override this.ImportFromEncryptedPem : ReadOnlySpan<char> * ReadOnlySpan<char> -> unit

Public Overrides Sub ImportFromEncryptedPem (input As ReadOnlySpan(Of Char), password As ReadOnlySpan(Of Char))

Parametry

input

ReadOnlySpan<Char>

Tekst PEM zaszyfrowanego klucza do zaimportowania.

password

ReadOnlySpan<Char>

Hasło do użycia do odszyfrowywania materiału klucza.

Wyjątki

ArgumentException

input nie zawiera klucza zakodowanego w formacie PEM z rozpoznaną etykietą.

-lub-

input zawiera wiele kluczy zakodowanych w formacie PEM z rozpoznaną etykietą.

CryptographicException

Hasło jest niepoprawne.

-lub-

Zdekodowana zawartość tekstu input PEM w formacie base-64 nie reprezentuje struktury PKCS#8 EncryptedPrivateKeyInfo w formacie ASN.1.1.

-lub-

Zdekodowana zawartość tekstu input PEM w formacie base-64 wskazuje, że klucz jest dla algorytmu innego niż algorytm reprezentowany przez to wystąpienie.

-lub-

Zdekodowana zawartość tekstu PEM w formacie base-64 reprezentuje input klucz w formacie, który nie jest obsługiwany.

-lub-

Importowanie klucza specyficznego dla algorytmu nie powiodło się.

Uwagi

W przypadku dekodowania zawartości input base-64 wskazuje algorytm, który używa pbKDF1 (funkcja wyprowadzania klucza opartego na hasłach 1) lub PBKDF2 (funkcja wyprowadzania klucza opartego na hasłach 2), hasło jest konwertowane na bajty za pośrednictwem kodowania UTF-8.

Nieobsługiwane lub źle sformułowane obiekty zakodowane za pomocą protokołu PEM zostaną zignorowane. Jeśli znaleziono wiele obsługiwanych etykiet PEM, zgłaszany jest wyjątek uniemożliwiający importowanie klucza, gdy klucz jest niejednoznaczny.

Ta metoda obsługuje etykietę ENCRYPTED PRIVATE KEY PEM.

ImportFromEncryptedPem(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)

Źródło:

ECAlgorithm.cs

Importuje zaszyfrowany klucz prywatny zakodowany w formacie PEM RFC 7468, zastępując klucze dla tego obiektu.

public:
 override void ImportFromEncryptedPem(ReadOnlySpan<char> input, ReadOnlySpan<System::Byte> passwordBytes);

public override void ImportFromEncryptedPem (ReadOnlySpan<char> input, ReadOnlySpan<byte> passwordBytes);

override this.ImportFromEncryptedPem : ReadOnlySpan<char> * ReadOnlySpan<byte> -> unit

Public Overrides Sub ImportFromEncryptedPem (input As ReadOnlySpan(Of Char), passwordBytes As ReadOnlySpan(Of Byte))

Parametry

input

ReadOnlySpan<Char>

Tekst PEM zaszyfrowanego klucza do zaimportowania.

passwordBytes

ReadOnlySpan<Byte>

Bajty do użycia jako hasło podczas odszyfrowywania materiału klucza.

Wyjątki

ArgumentException

input nie zawiera klucza zakodowanego w formacie PEM z rozpoznaną etykietą.

-lub-

input zawiera wiele kluczy zakodowanych w formacie PEM z rozpoznaną etykietą.

CryptographicException

Hasło jest niepoprawne.

-lub-

Zdekodowana zawartość tekstu input PEM w formacie base-64 nie reprezentuje struktury PKCS#8 EncryptedPrivateKeyInfo w formacie ASN.1.1.

-lub-

Zdekodowana zawartość tekstu input PEM w formacie base-64 wskazuje, że klucz jest dla algorytmu innego niż algorytm reprezentowany przez to wystąpienie.

-lub-

Zdekodowana zawartość tekstu PEM w formacie base-64 reprezentuje input klucz w formacie, który nie jest obsługiwany.

-lub-

Importowanie klucza specyficznego dla algorytmu nie powiodło się.

Uwagi

Bajty haseł są przekazywane bezpośrednio do funkcji wyprowadzania kluczy (KDF) używanej przez algorytm wskazany przez pbeParameters. Umożliwia to zgodność z innymi systemami, które używają kodowania tekstu innego niż UTF-8 podczas przetwarzania haseł za pomocą pbKDF2 (funkcja wyprowadzania kluczy opartych na hasłach 2).

Nieobsługiwane lub źle sformułowane obiekty zakodowane za pomocą protokołu PEM są ignorowane. Jeśli znaleziono wiele obsługiwanych etykiet PEM, zgłaszany jest wyjątek uniemożliwiający importowanie klucza, gdy klucz jest niejednoznaczny.

Ta metoda obsługuje etykietę ENCRYPTED PRIVATE KEY PEM.