AsymmetricAlgorithm.ImportEncryptedPkcs8PrivateKey メソッド

定義

名前空間:

System.Security.Cryptography

アセンブリ:

netstandard.dll, System.Security.Cryptography.dll

オーバーロード

ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Int32)	派生クラスでオーバーライドされるときに、バイトベースのパスワードを使用して暗号化解除した後に、PKCS#8 EncryptedPrivateKeyInfo 構造体から公開/秘密キー ペアをインポートし、このオブジェクトのキーを置き換えます。
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, ReadOnlySpan<Byte>, Int32)	派生クラスでオーバーライドされるときに、char ベースのパスワードを使用して暗号化解除した後に、PKCS#8 EncryptedPrivateKeyInfo 構造体から公開/秘密キー ペアをインポートし、このオブジェクトのキーを置き換えます。

ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Int32)

ソース:

AsymmetricAlgorithm.cs

派生クラスでオーバーライドされるときに、バイトベースのパスワードを使用して暗号化解除した後に、PKCS#8 EncryptedPrivateKeyInfo 構造体から公開/秘密キー ペアをインポートし、このオブジェクトのキーを置き換えます。

C#

public virtual void ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<byte> passwordBytes, ReadOnlySpan<byte> source, out int bytesRead);

パラメーター

passwordBytes

ReadOnlySpan<Byte>

キー マテリアルを暗号化解除するときにパスワードとして使用するバイト。

source

ReadOnlySpan<Byte>

ASN.1-BER エンコードでの PKCS#8 EncryptedPrivateKeyInfo 構造体のバイト。

bytesRead

Int32

このメソッドが戻るときに、source から読み込まれたバイト数を示す値が含まれます。 このパラメーターは初期化前として処理されます。

例外

CryptographicException

パスワードが正しくありません。

または

source のコンテンツは、適用するキー派生関数 (KDF) が、Char ベースのパスワードを必要とするレガシの PKCS#12 KDF であることを示しています。

または

source のコンテンツは、ASN.1-BER でエンコードされた PKCS#8 EncryptedPrivateKeyInfo 構造体を表していません。

または

source のコンテンツは、そのキーが、このインスタンスで表されているアルゴリズム以外のアルゴリズム用であることを示しています。

または

source のコンテンツは、サポートされていない形式のキーを表しています。

または

アルゴリズム固有のキーのインポートに失敗しました。

NotImplementedException

派生タイプはこのメンバーをオーバーライドしていません。

注釈

パスワード バイトは、 によって pbeParameters示されるアルゴリズムによって使用されるキー派生関数 (KDF) に直接渡されます。 これにより、PBKDF2 でパスワードを処理するときに UTF-8 以外のテキスト エンコードを使用する他のシステムとの互換性が可能になります (パスワードベースのキー派生関数 2)。

このメソッドでは、EncryptedPrivateKeyInfo のバイナリ (BER/CER/DER) エンコードのみがサポートされます。 値が Base64 エンコードまたは PEM テキスト形式の場合、呼び出し元は、このメソッドを呼び出す前に、内容を Base64 デコードする必要があります。

このデータ形式の内容を解釈するにはアルゴリズム固有のサポートが必要であるため、 ImportEncryptedPkcs8PrivateKey 既定では が NotImplementedException スローされます。

ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, ReadOnlySpan<Byte>, Int32)

ソース:

AsymmetricAlgorithm.cs

派生クラスでオーバーライドされるときに、char ベースのパスワードを使用して暗号化解除した後に、PKCS#8 EncryptedPrivateKeyInfo 構造体から公開/秘密キー ペアをインポートし、このオブジェクトのキーを置き換えます。

C#

public virtual void ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<char> password, ReadOnlySpan<byte> source, out int bytesRead);

パラメーター

password

ReadOnlySpan<Char>

キー マテリアルの暗号化に使用するパスワード。

source

ReadOnlySpan<Byte>

ASN.1-BER エンコードでの PKCS#8 EncryptedPrivateKeyInfo 構造体のバイト。

bytesRead

Int32

このメソッドが戻るときに、source から読み込まれたバイト数を示す値が含まれます。 このパラメーターは初期化前として処理されます。

例外

CryptographicException

パスワードが正しくありません。

または

source のコンテンツは、ASN.1-BER でエンコードされた PKCS#8 EncryptedPrivateKeyInfo 構造体を表していません。

または

source のコンテンツは、そのキーが、このインスタンスで表されているアルゴリズム以外のアルゴリズム用であることを示しています。

または

source のコンテンツは、サポートされていない形式のキーを表しています。

または

アルゴリズム固有のキーのインポートに失敗しました。

NotImplementedException

派生タイプはこのメンバーをオーバーライドしていません。

注釈

の source 内容が PBKDF1 (パスワード ベースのキー派生関数 1) または PBKDF2 (パスワード ベースのキー派生関数 2) を使用するアルゴリズムを示している場合、パスワードは UTF-8 エンコードを介してバイトに変換されます。

このメソッドでは、EncryptedPrivateKeyInfo のバイナリ (BER/CER/DER) エンコードのみがサポートされます。 値が Base64 エンコードまたは PEM テキスト形式の場合、呼び出し元は、このメソッドを呼び出す前に、内容を Base64 デコードする必要があります。

このデータ形式の内容を解釈するにはアルゴリズム固有のサポートが必要であるため、 ImportEncryptedPkcs8PrivateKey 既定では が NotImplementedException スローされます。