DSA.ImportFromEncryptedPem Метод

Определение

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

System.Security.Cryptography

Сборка:

System.Security.Cryptography.dll

Перегрузки

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

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

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

DSA.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

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

        -or-

        The base-64 decoded contents of the PEM text from <code data-dev-comment-type="paramref">input</code> do not represent an ASN.1-BER-encoded PKCS#8 EncryptedPrivateKeyInfo structure.

        -or-

        The base-64 decoded contents of the PEM text from <code data-dev-comment-type="paramref">input</code> indicate the key is for an algorithm other than the algorithm represented by this instance.

        -or-

        The base-64 decoded contents of the PEM text from <code data-dev-comment-type="paramref">input</code> represent the key in a format that is not supported.

        -or-

        The algorithm-specific key import failed.

Комментарии

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

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

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

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

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

DSA.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

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

        -or-

        The base-64 decoded contents of the PEM text from <code data-dev-comment-type="paramref">input</code> do not represent an ASN.1-BER-encoded PKCS#8 EncryptedPrivateKeyInfo structure.

        -or-

        The base-64 decoded contents of the PEM text from <code data-dev-comment-type="paramref">input</code> indicate the key is for an algorithm other than the algorithm represented by this instance.

        -or-

        The base-64 decoded contents of the PEM text from <code data-dev-comment-type="paramref">input</code> represent the key in a format that is not supported.

        -or-

        The algorithm-specific key import failed.

Комментарии

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

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

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