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