Pkcs12KeyBag(ReadOnlyMemory<Byte>, Boolean) Constructeur

Définition

Espace de noms:

System.Security.Cryptography.Pkcs

Assembly:

System.Security.Cryptography.Pkcs.dll

Paquet:

System.Security.Cryptography.Pkcs v9.0.0-preview.5.24306.7

Source:

Pkcs12KeyBag.cs

Initialise une nouvelle instance de Pkcs12KeyBag à partir d’une valeur PrivateKeyInfo PKCS#8 codée existante.

public Pkcs12KeyBag (ReadOnlyMemory<byte> pkcs8PrivateKey, bool skipCopy = false);

new System.Security.Cryptography.Pkcs.Pkcs12KeyBag : ReadOnlyMemory<byte> * bool -> System.Security.Cryptography.Pkcs.Pkcs12KeyBag

Public Sub New (pkcs8PrivateKey As ReadOnlyMemory(Of Byte), Optional skipCopy As Boolean = false)

Paramètres

pkcs8PrivateKey

ReadOnlyMemory<Byte>

Valeur PrivateKeyInfo PKCS#8 codée BER.

skipCopy

Boolean

true pour stocker pkcs8PrivateKey sans effectuer de copie défensive ; sinon, false. La valeur par défaut est false.

Exceptions

CryptographicException

Le paramètre pkcs8privateKey ne représente pas une seule valeur encodée en ASN.1 BER.

Remarques

Cette méthode valide qu’il pkcs8PrivateKey s’agit d’une seule valeur encodée par BER, mais elle ne vérifie pas que la valeur est une valeur PKCS#8 PrivateKeyInfo appropriée.

Le transport de clés privées dans un KeyBag est autorisé par la norme PKCS#12, mais tous les lecteurs PFX ne prennent pas en charge l’association de certificats avec des clés à partir d’un KeyBag. Pour une prise en charge optimale, transportez les clés dans un ShroudedKeyBag (Pkcs12ShroudedKeyBag).

Le comportement par défaut de cette méthode consiste à effectuer une copie défensive de pkcs8PrivateKey. Lorsque le skipCopy paramètre est true, cette copie défensive est ignorée. Si la copie défensive est ignorée et que le contenu de pkcs8PrivateKey la modification pendant la durée de vie de la valeur retournée ou de tout objet produit par ses méthodes ou propriétés, les méthodes et les propriétés de ces objets peuvent produire des résultats absurdes ou lever des exceptions en raison de l’état endommagé. Il est donc conseillé aux appelants d’utiliser une true valeur pour le skipCopy paramètre uniquement lorsqu’ils peuvent être raisonnablement assurés que les données resteront intactes.

Voir aussi

• AddKeyUnencrypted(AsymmetricAlgorithm)