X509Certificate2.CreateFromEncryptedPemFile メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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);
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
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
ファイルが秘密キーの読み込みに使用されます。
戻り値
秘密キーによる新しい証明書。
- 属性
例外
certPemFilePath
のファイルのパスの内容に PEM でエンコードされた証明書が含まれていないか、その形式が正しくありません。
または
keyPemFilePath
のファイルのパス内容にパスワードで保護されて PEM でエンコードされた秘密キーが含まれていないか、その形式が正しくありません。
または
keyPemFilePath
のファイルのパス内容に、証明書の公開キーと一致しないキーが含まれています。
または
証明書で不明な公開キー アルゴリズムが使用されています。
または
秘密キーに指定されたパスワードが正しくありません。
certPemFilePath
が null
です。
注釈
スローされる可能性がある例外に関するその他のドキュメントを参照してください ReadAllText(String) 。
パスワードで保護された PEM でエンコードされたキーには、常に PEM ラベル "ENCRYPTED PRIVATE KEY" が必要です。
異なるラベルを持つ PEM でエンコードされた項目は無視されます。
PEM でエンコードされた証明書とキーを組み合わせた場合、特定の順序は必要ありません。 証明書の場合、CERTIFICATE ラベルを持つ最初の証明書が読み込まれます。 秘密キーの場合は、"ENCRYPTED 秘密キー" というラベルが付いた最初の秘密キーが読み込まれます。 証明書と秘密キーを読み込む場合のより高度なシナリオでは、PEM でエンコードされた値を列挙し、カスタム読み込み動作を適用するために活用 PemEncoding できます。
パスワードのない PEM でエンコードされたキーの場合は、 を使用します CreateFromPemFile(String, String)。