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.X509Certificate2static member CreateFromEncryptedPemFile : string * ReadOnlySpan<char> * string -> System.Security.Cryptography.X509Certificates.X509Certificate2Public 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 秘密キー" というラベルの最初の秘密キーが読み込まれます。 証明書と秘密キーを読み込むためのより高度なシナリオでは、 PemEncoding を利用して PEM でエンコードされた値を列挙し、カスタム読み込み動作を適用できます。
パスワードなしで PEM でエンコードされたキーの場合は、 CreateFromPemFile(String, String)を使用します。
