X509Certificate2.CreateFromPem Метод

Определение

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

System.Security.Cryptography.X509Certificates

Сборки:

netstandard.dll, System.Security.Cryptography.dll

Создает новый сертификат X509 из содержимого сертификата в кодировке RFC 7468 PEM.

Перегрузки

Имя	Описание
CreateFromPem(ReadOnlySpan<Char>)	Создает новый сертификат X509 из содержимого сертификата в кодировке RFC 7468 PEM.
CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>)	Создает новый сертификат X509 из содержимого сертификата в кодировке RFC 7468 PEM и закрытого ключа.

CreateFromPem(ReadOnlySpan<Char>)

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

X509Certificate2.cs

Создает новый сертификат X509 из содержимого сертификата в кодировке RFC 7468 PEM.

public:
 static System::Security::Cryptography::X509Certificates::X509Certificate2 ^ CreateFromPem(ReadOnlySpan<char> certPem);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static System.Security.Cryptography.X509Certificates.X509Certificate2 CreateFromPem(ReadOnlySpan<char> certPem);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member CreateFromPem : ReadOnlySpan<char> -> System.Security.Cryptography.X509Certificates.X509Certificate2

Public Shared Function CreateFromPem (certPem As ReadOnlySpan(Of Char)) As X509Certificate2

Параметры

certPem

ReadOnlySpan<Char>

Текст сертификата X509 в кодировке PEM.

Возвращаемое значение

X509Certificate2

Новый сертификат X509.

Атрибуты

UnsupportedOSPlatformAttribute

Исключения

CryptographicException

Содержимое certPem не содержит сертификат в кодировке PEM или неправильно сформирован.

Комментарии

При этом загружается первый хорошо сформированный PEM с меткой CERTIFICATE.

Для сертификатов, закодированных в кодировке PEM, используйте CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>)закрытый ключ.

Для сертификатов в кодировке PEM в файле используйте X509Certificate2(String).

CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>)

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

X509Certificate2.cs

Создает новый сертификат X509 из содержимого сертификата в кодировке RFC 7468 PEM и закрытого ключа.

public:
 static System::Security::Cryptography::X509Certificates::X509Certificate2 ^ CreateFromPem(ReadOnlySpan<char> certPem, ReadOnlySpan<char> keyPem);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static System.Security.Cryptography.X509Certificates.X509Certificate2 CreateFromPem(ReadOnlySpan<char> certPem, ReadOnlySpan<char> keyPem);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member CreateFromPem : ReadOnlySpan<char> * ReadOnlySpan<char> -> System.Security.Cryptography.X509Certificates.X509Certificate2

Public Shared Function CreateFromPem (certPem As ReadOnlySpan(Of Char), keyPem As ReadOnlySpan(Of Char)) As X509Certificate2

Параметры

certPem

ReadOnlySpan<Char>

Текст сертификата X509 в кодировке PEM.

keyPem

ReadOnlySpan<Char>

Текст закрытого ключа в кодировке PEM.

Возвращаемое значение

X509Certificate2

Новый сертификат с закрытым ключом.

Атрибуты

UnsupportedOSPlatformAttribute

Исключения

CryptographicException

Содержимое certPem не содержит сертификат в кодировке PEM или неправильно сформирован.

–или–

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

–или–

Содержимое keyPem содержит ключ, который не соответствует открытому ключу в сертификате.

–или–

Сертификат использует алгоритм неизвестного открытого ключа.

Комментарии

SubjectPublicKeyInfo из сертификата определяет, какие метки PEM принимаются для закрытого ключа. Для сертификатов RSA приняты метки PEM закрытого ключа: RSA PRIVATE KEY и PRIVATE KEY. Для сертификатов ECDSA приняты метки PEM закрытого ключа: EC PRIVATE KEY и PRIVATE KEY. Для сертификатов DSA принятое метка PEM закрытого ключа — PRIVATE KEY.

Элементы с кодировкой PEM, имеющие другую метку, игнорируются.

Если сертификат с кодировкой PEM и закрытый ключ находятся в одном тексте, используйте ту же строку для обоих certPem и keyPem, например, CreateFromPem(combinedCertAndKey, combinedCertAndKey);. Объединенные сертификаты в кодировке PEM и ключи не требуют определенного порядка. Для сертификата загружается первый сертификат с меткой CERTIFICATE. Для закрытого ключа загружается первый закрытый ключ с допустимой меткой. Более сложные сценарии загрузки сертификатов и закрытых ключей могут использовать PemEncoding для перечисления значений в кодировке PEM и применения любого пользовательского поведения загрузки.

Для ключей, защищенных паролем в кодировке PEM, используйте CreateFromEncryptedPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>, ReadOnlySpan<Char>) для указания пароля.