Pkcs12KeyBag(ReadOnlyMemory<Byte>, Boolean) Constructor

Definición

Espacio de nombres:

System.Security.Cryptography.Pkcs

Ensamblado:

System.Security.Cryptography.Pkcs.dll

Paquete:

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

Source:

Pkcs12KeyBag.cs

Inicializa una nueva instancia de Pkcs12KeyBag desde un valor PrivateKeyInfo de PKCS#8 con codificación existente.

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)

Parámetros

pkcs8PrivateKey

ReadOnlyMemory<Byte>

Un valor de PrivateKeyInfo de PKCS#8 codificado en BER.

skipCopy

Boolean

true para almacenar pkcs8PrivateKey sin crear una copia defensiva; de lo contrario, false. De manera predeterminada, es false.

Excepciones

CryptographicException

El parámetro pkcs8privateKey no representa un único valor codificado con ASN.1 BER.

Comentarios

Este método valida que pkcs8PrivateKey es un único valor codificado en BER, pero no comprueba que el valor sea un valor PKCS#8 PrivateKeyInfo adecuado.

El transporte de claves privadas en keyBag lo permite el estándar PKCS#12, pero no todos los lectores PFX admiten el emparejamiento de certificados con claves de keyBag. Para obtener la mejor compatibilidad, las claves de transporte en shroudedKeyBag (Pkcs12ShroudedKeyBag).

El comportamiento predeterminado de este método es realizar una copia defensiva de pkcs8PrivateKey. Cuando el skipCopy parámetro es true, se omite esta copia defensiva. Si se omite la copia defensiva y el contenido del cambio durante la vigencia del valor devuelto o de cualquier objeto generado por sus métodos o propiedades, los métodos y propiedades de esos objetos pueden producir resultados sin pkcs8PrivateKey sentido o producir excepciones debido al estado dañado. Por lo tanto, se recomienda a los autores de llamadas usar solo un true valor para el skipCopy parámetro cuando puedan estar razonablemente seguros de que los datos permanecerán intactos.

Consulte también

• AddKeyUnencrypted(AsymmetricAlgorithm)