X509Certificate2.CreateFromEncryptedPemFile メソッド

定義

名前空間:

System.Security.Cryptography.X509Certificates

アセンブリ:

System.Security.Cryptography.dll

ソース:

X509Certificate2.cs

RFC 7468 PEM でエンコードされた証明書とパスワードで保護された秘密キーのファイルの内容から、新しい X509 証明書を作成します。

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static System.Security.Cryptography.X509Certificates.X509Certificate2 CreateFromEncryptedPemFile (string certPemFilePath, ReadOnlySpan<char> password, string? keyPemFilePath = default);

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

Public Shared Function CreateFromEncryptedPemFile (certPemFilePath As String, password As ReadOnlySpan(Of Char), Optional keyPemFilePath As String = Nothing) As X509Certificate2

パラメーター

certPemFilePath

String

PEM でエンコードされた X509 証明書のパス。

password

ReadOnlySpan<Char>

暗号化された PEM のパスワード。

keyPemFilePath

String

指定されている場合は、パスワードで保護されて PEM でエンコードされた秘密キーのパス。 指定されていない場合は、certPemFilePath ファイルが秘密キーの読み込みに使用されます。

戻り値

X509Certificate2

秘密キーによる新しい証明書。

属性

UnsupportedOSPlatformAttribute

例外

CryptographicException

certPemFilePath のファイルのパスの内容に PEM でエンコードされた証明書が含まれていないか、その形式が正しくありません。

または

keyPemFilePath のファイルのパス内容にパスワードで保護されて PEM でエンコードされた秘密キーが含まれていないか、その形式が正しくありません。

または

keyPemFilePath のファイルのパス内容に、証明書の公開キーと一致しないキーが含まれています。

または

証明書で不明な公開キー アルゴリズムが使用されています。

または

秘密キーに指定されたパスワードが正しくありません。

ArgumentNullException

certPemFilePath が nullです。

注釈

スローされる可能性がある例外に関するその他のドキュメントを参照してください ReadAllText(String) 。

パスワードで保護された PEM でエンコードされたキーには、常に PEM ラベル "ENCRYPTED PRIVATE KEY" が必要です。

異なるラベルを持つ PEM でエンコードされた項目は無視されます。

PEM でエンコードされた証明書とキーを組み合わせた場合、特定の順序は必要ありません。 証明書の場合、CERTIFICATE ラベルを持つ最初の証明書が読み込まれます。 秘密キーの場合は、"ENCRYPTED 秘密キー" というラベルが付いた最初の秘密キーが読み込まれます。 証明書と秘密キーを読み込む場合のより高度なシナリオでは、PEM でエンコードされた値を列挙し、カスタム読み込み動作を適用するために活用 PemEncoding できます。

パスワードのない PEM でエンコードされたキーの場合は、 を使用します CreateFromPemFile(String, String)。