SignedCms.CheckSignature Método

Definición

Espacio de nombres:

System.Security.Cryptography.Pkcs

Ensamblado:

System.Security.Cryptography.Pkcs.dll

Paquete:

System.Security.Cryptography.Pkcs v8.0.0

Comprueba las firmas digitales en el mensaje CMS o PKCS #7 firmado.

Sobrecargas

CheckSignature(Boolean)	El método CheckSignature(Boolean) comprueba las firmas digitales en el mensaje CMS o PKCS #7 firmado y, opcionalmente, valida los certificados de los firmantes.
CheckSignature(X509Certificate2Collection, Boolean)	El método CheckSignature(X509Certificate2Collection, Boolean) comprueba las firmas digitales en el mensaje CMS o PKCS #7 firmado utilizando la colección especificada de certificados y, opcionalmente, valida los certificados de los firmantes.

CheckSignature(Boolean)

Source:

SignedCms.cs

El método CheckSignature(Boolean) comprueba las firmas digitales en el mensaje CMS o PKCS #7 firmado y, opcionalmente, valida los certificados de los firmantes.

public:
 void CheckSignature(bool verifySignatureOnly);

public void CheckSignature (bool verifySignatureOnly);

member this.CheckSignature : bool -> unit

Public Sub CheckSignature (verifySignatureOnly As Boolean)

Parámetros

verifySignatureOnly

Boolean

Valor Boolean que especifica si sólo se comprueban las firmas digitales sin los certificados de los firmantes que se están validando.

Si verifySignatureOnly es true, sólo se comprueban las firmas digitales. Si es false, se comprueban las firmas digitales, se validan los certificados de los firmantes y se validan los propósitos de los certificados. Los propósitos de un certificado se consideran válidos si el certificado no presenta ningún uso de la clave o si el uso de la clave admite firmas digitales o no rechazo.

Excepciones

ArgumentNullException

Se ha pasado una referencia nula a un método que no la acepta como argumento válido.

CryptographicException

No se pudo finalizar una operación criptográfica.

InvalidOperationException

Llamada a método no válida para el estado actual del objeto.

Ejemplos

En el ejemplo siguiente se muestra la ubicación de CheckSignature(Boolean) entre los pasos necesarios para comprobar las firmas en un SignedCms mensaje. En este ejemplo, el contenido del mensaje no está desasociado. El contenido del mensaje se incluye en el SignedCms mensaje.

// Create a new, nondetached SignedCms message.
SignedCms signedCms = new SignedCms();

// encodedMessage is the encoded message received from
// the sender.
signedCms.Decode(encodedMessage);

// Verify the signature without validating the
// certificate.
signedCms.CheckSignature(true);

' Create a new, nondetached SignedCms message.
Dim signedCms As New SignedCms()

' encodedMessage is the encoded message received from 
' the sender.
signedCms.Decode(encodedMessage)

' Verify the signature without validating the 
' certificate.
signedCms.CheckSignature(True)

En el ejemplo siguiente se muestra la ubicación de CheckSignature(Boolean) entre los pasos necesarios para comprobar las firmas en un SignedCms mensaje. En este ejemplo, el contenido del mensaje se desasocia, por lo que el contenido del mensaje debe comprobarse independientemente del SignedCms mensaje.

// Create a ContentInfo object from the inner content obtained
// independently from encodedMessage.
ContentInfo contentInfo = new ContentInfo(innerContent);

// Create a new, detached SignedCms message.
SignedCms signedCms = new SignedCms(contentInfo, true);

// encodedMessage is the encoded message received from
// the sender.
signedCms.Decode(encodedMessage);

// Verify the signature without validating the
// certificate.
signedCms.CheckSignature(true);

' Create a ContentInfo object from the inner content obtained 
' independently from encodedMessage.
Dim contentInfo As New ContentInfo(innerContent)

' Create a new, detached SignedCms message.
Dim signedCms As New SignedCms(contentInfo, True)

' encodedMessage is the encoded message received from 
' the sender.
signedCms.Decode(encodedMessage)

' Verify the signature without validating the 
' certificate.
signedCms.CheckSignature(True)

Comentarios

Este método comprueba todas las firmas, incluidas las contrafirmas, en el mensaje CMS/PKCS #7. Si hay atributos firmados incluidos con el mensaje, también se comprueban estos atributos. Si se elige la opción para validar certificados, se valida toda la parte incluida de la cadena de certificados.

Este método produce una excepción si no se cumple la comprobación de una firma digital o no se cumplen los requisitos de validación.

CheckSignature(X509Certificate2Collection, Boolean)

Source:

SignedCms.cs

El método CheckSignature(X509Certificate2Collection, Boolean) comprueba las firmas digitales en el mensaje CMS o PKCS #7 firmado utilizando la colección especificada de certificados y, opcionalmente, valida los certificados de los firmantes.

public:
 void CheckSignature(System::Security::Cryptography::X509Certificates::X509Certificate2Collection ^ extraStore, bool verifySignatureOnly);

public void CheckSignature (System.Security.Cryptography.X509Certificates.X509Certificate2Collection extraStore, bool verifySignatureOnly);

member this.CheckSignature : System.Security.Cryptography.X509Certificates.X509Certificate2Collection * bool -> unit

Public Sub CheckSignature (extraStore As X509Certificate2Collection, verifySignatureOnly As Boolean)

Parámetros

extraStore

X509Certificate2Collection

Objeto X509Certificate2Collection que se puede utilizar para validar la cadena de certificados. Si no se van a utilizar certificados adicionales para validar la cadena de certificados, utilice CheckSignature(Boolean) en lugar de CheckSignature(X509Certificate2Collection, Boolean).

verifySignatureOnly

Boolean

Valor Boolean que especifica si sólo se comprueban las firmas digitales sin los certificados de los firmantes que se están validando.

Si verifySignatureOnly es true, sólo se comprueban las firmas digitales. Si es false, se comprueban las firmas digitales, se validan los certificados de los firmantes y se validan los propósitos de los certificados. Los propósitos de un certificado se consideran válidos si el certificado no presenta ningún uso de la clave o si el uso de la clave admite firmas digitales o no rechazo.

Excepciones

ArgumentNullException

Se ha pasado una referencia nula a un método que no la acepta como argumento válido.

CryptographicException

No se pudo finalizar una operación criptográfica.

InvalidOperationException

Llamada a método no válida para el estado actual del objeto.

Comentarios

Este método comprueba todas las firmas, incluidas las contrafirmas, en el mensaje CMS/PKCS #7. Si hay atributos firmados incluidos con el mensaje, también se comprueban estos atributos. Si se elige la opción para validar certificados, se valida toda la parte incluida de la cadena de certificados.

Este método produce una excepción si no se cumple la comprobación de una firma digital o no se cumplen los requisitos de validación.