X509Certificate2.CreateFromPemFile(String, String) メソッド

定義

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

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static System.Security.Cryptography.X509Certificates.X509Certificate2 CreateFromPemFile(string certPemFilePath, string? keyPemFilePath = default);
public static System.Security.Cryptography.X509Certificates.X509Certificate2 CreateFromPemFile(string certPemFilePath, string? keyPemFilePath = default);
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member CreateFromPemFile : string * string -> System.Security.Cryptography.X509Certificates.X509Certificate2
static member CreateFromPemFile : string * string -> System.Security.Cryptography.X509Certificates.X509Certificate2
Public Shared Function CreateFromPemFile (certPemFilePath As String, Optional keyPemFilePath As String = Nothing) As X509Certificate2

パラメーター

certPemFilePath
String

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

keyPemFilePath
String

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

返品

秘密キーを持つ新しい証明書。

属性

例外

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

-又は-

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

-又は-

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

-又は-

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

certPemFilePathnullです。

注釈

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

証明書の SubjectPublicKeyInfo によって、秘密キーに対して受け入れられる PEM ラベルが決まります。 RSA 証明書の場合、受け入れられる秘密キー PEM ラベルは "RSA 秘密キー" と "秘密キー" です。 ECDSA 証明書の場合、受け入れられる秘密キー PEM ラベルは "EC 秘密キー" と "秘密キー" です。 DSA 証明書の場合、受け入れられる秘密キー PEM ラベルは "秘密キー" です。

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

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

パスワードで保護された PEM でエンコードされたキーの場合は、 CreateFromEncryptedPemFile(String, ReadOnlySpan<Char>, String) を使用してパスワードを指定します。

適用対象