ECAlgorithm.ImportFromEncryptedPem Метод

Определение

Пространство имен:

System.Security.Cryptography

Сборка:

System.Security.Cryptography.dll

Перегрузки

ImportFromEncryptedPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>)	Импортирует зашифрованный закрытый ключ в формате RFC 7468 в кодировке PEM, заменяя ключи для этого объекта.
ImportFromEncryptedPem(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)	Импортирует зашифрованный закрытый ключ в формате RFC 7468 в кодировке PEM, заменяя ключи для этого объекта.

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

Исходный код:

ECAlgorithm.cs

Импортирует зашифрованный закрытый ключ в формате RFC 7468 в кодировке PEM, заменяя ключи для этого объекта.

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))

Параметры

input

ReadOnlySpan<Char>

Текст PEM зашифрованного ключа для импорта.

password

ReadOnlySpan<Char>

Пароль, используемый при расшифровке материала ключа.

Исключения

ArgumentException

input не содержит ключ в кодировке PEM с распознанной меткой.

-или-

input содержит несколько ключей в кодировке PEM с распознанной меткой.

CryptographicException

Неправильный пароль.

-или-

Декодированное из Base 64 содержимое текста PEM из input не представляет структуру ASN.1-BER PKCS#8 EncryptedPrivateKeyInfo.

-или-

Декодированное из Base 64 содержимое текста PEM из input указывает ключ для алгоритма, отличного от алгоритма, представленного этим экземпляром.

-или-

Декодированное из Base 64 содержимое текста PEM из input представляет ключ в неподдерживаемом формате.

-или-

Не удалось выполнить импорт ключа, зависящего от алгоритма.

Комментарии

Если декодированные содержимое input элемента Base-64 указывают на алгоритм, использующий PBKDF1 (функция наследования ключа на основе пароля 1) или PBKDF2 (функция наследования ключа на основе пароля 2), пароль преобразуется в байты с помощью кодировки UTF-8.

Неподдерживаемые или неправильно сформированные объекты в кодировке PEM будут игнорироваться. При обнаружении нескольких поддерживаемых меток PEM создается исключение, чтобы предотвратить импорт ключа, если ключ является неоднозначным.

Этот метод поддерживает ENCRYPTED PRIVATE KEY метку PEM.

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

Исходный код:

ECAlgorithm.cs

Импортирует зашифрованный закрытый ключ в формате RFC 7468 в кодировке PEM, заменяя ключи для этого объекта.

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))

Параметры

input

ReadOnlySpan<Char>

Текст PEM зашифрованного ключа для импорта.

passwordBytes

ReadOnlySpan<Byte>

Байты, используемые в качестве пароля при расшифровке материала ключа.

Исключения

ArgumentException

input не содержит ключ в кодировке PEM с распознанной меткой.

-или-

input содержит несколько ключей в кодировке PEM с распознанной меткой.

CryptographicException

Неправильный пароль.

-или-

Декодированное из Base 64 содержимое текста PEM из input не представляет структуру ASN.1-BER PKCS#8 EncryptedPrivateKeyInfo.

-или-

Декодированное из Base 64 содержимое текста PEM из input указывает ключ для алгоритма, отличного от алгоритма, представленного этим экземпляром.

-или-

Декодированное из Base 64 содержимое текста PEM из input представляет ключ в неподдерживаемом формате.

-или-

Не удалось выполнить импорт ключа, зависящего от алгоритма.

Комментарии

Байты паролей передаются непосредственно в функцию наследования ключей (KDF), используемую алгоритмом, указанным .pbeParameters Это обеспечивает совместимость с другими системами, которые используют кодировку текста, отличающуюся от UTF-8, при обработке паролей с помощью PBKDF2 (функция 2 наследования ключа на основе пароля).

Неподдерживаемые или неправильно сформированные объекты в кодировке PEM игнорируются. При обнаружении нескольких поддерживаемых меток PEM создается исключение, чтобы предотвратить импорт ключа, если ключ является неоднозначным.

Этот метод поддерживает ENCRYPTED PRIVATE KEY метку PEM.