ECDsa.ImportFromEncryptedPem Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
ImportFromEncryptedPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>) |
Импортирует зашифрованный закрытый ключ в формате RFC 7468 в кодировке PEM, заменяя ключи для этого объекта. |
ImportFromEncryptedPem(ReadOnlySpan<Char>, ReadOnlySpan<Byte>) |
Импортирует зашифрованный закрытый ключ в формате RFC 7468 в кодировке PEM, заменяя ключи для этого объекта. |
ImportFromEncryptedPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>)
Импортирует зашифрованный закрытый ключ в формате 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>
Пароль, используемый при расшифровке материала ключа.
Исключения
input
не содержит ключ в кодировке PEM с распознанной меткой.
-или-
input
содержит несколько ключей в кодировке PEM с распознанной меткой.
Неправильный пароль.
-или-
Декодированное из Base 64 содержимое текста PEM из input
не представляет структуру ASN.1-BER PKCS#8 EncryptedPrivateKeyInfo.
-или-
Декодированное из Base 64 содержимое текста PEM из input
указывает ключ для алгоритма, отличного от алгоритма, представленного этим экземпляром.
-или-
Декодированное из Base 64 содержимое текста PEM из input
представляет ключ в неподдерживаемом формате.
-или-
Не удалось выполнить импорт ключа, зависящего от алгоритма.
Комментарии
Если декодированные в base-64 содержимое input
указывают алгоритм, использующий PBKDF1 (функция 1 на основе пароля) или PBKDF2 (функция наследования ключа на основе пароля 2), пароль преобразуется в байты с помощью кодировки UTF-8.
Неподдерживаемые или неправильно сформированные объекты в кодировке PEM будут игнорироваться. При обнаружении нескольких поддерживаемых меток PEM создается исключение, чтобы предотвратить импорт ключа, если ключ является неоднозначным.
Этот метод поддерживает ENCRYPTED PRIVATE KEY
метку PEM.
Применяется к
ImportFromEncryptedPem(ReadOnlySpan<Char>, ReadOnlySpan<Byte>)
Импортирует зашифрованный закрытый ключ в формате 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>
Байты, используемые в качестве пароля при расшифровке материала ключа.
Исключения
input
не содержит ключ в кодировке PEM с распознанной меткой.
-или-
input
содержит несколько ключей в кодировке PEM с распознанной меткой.
Неправильный пароль.
-или-
Декодированное из 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.