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 standardzie RFC 7468 Z kodowaniem PEM, zastępując klucze dla tego obiektu.
ImportFromEncryptedPem(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)	Importuje zaszyfrowany klucz prywatny zakodowany w standardzie RFC 7468 Z kodowaniem PEM, zastępując klucze dla tego obiektu.

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

Źródło:

ECAlgorithm.cs

Importuje zaszyfrowany klucz prywatny zakodowany w standardzie RFC 7468 Z kodowaniem PEM, 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 używane 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 standardze PEM z rozpoznaną etykietą.

CryptographicException

Hasło jest niepoprawne.

-lub-

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

-lub-

Zdekodowana zawartość tekstu PEM base-64 wskazuje input , że klucz jest algorytmem innym niż algorytm reprezentowany przez to wystąpienie.

-lub-

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

-lub-

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

Uwagi

Gdy zdekodowana zawartość input base-64 wskazuje algorytm używający 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 w formacie PEM zostaną zignorowane. Jeśli zostanie znalezionych wiele obsługiwanych etykiet PEM, zostanie zgłoszony 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 standardzie RFC 7468 Z kodowaniem PEM, 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 używane 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 standardze PEM z rozpoznaną etykietą.

CryptographicException

Hasło jest niepoprawne.

-lub-

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

-lub-

Zdekodowana zawartość tekstu PEM base-64 wskazuje input , że klucz jest algorytmem innym niż algorytm reprezentowany przez to wystąpienie.

-lub-

Zdekodowana zawartość tekstu input PEM base-64 reprezentuje 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 w formacie PEM są ignorowane. Jeśli zostanie znalezionych wiele obsługiwanych etykiet PEM, zostanie zgłoszony wyjątek uniemożliwiający importowanie klucza, gdy klucz jest niejednoznaczny.

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