SignedCms.CheckSignature Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
- Source:
- SignedCms.cs
- Source:
- SignedCms.cs
- 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
Se ha pasado una referencia nula a un método que no la acepta como argumento válido.
No se pudo finalizar una operación criptográfica.
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.
Se aplica a
CheckSignature(X509Certificate2Collection, Boolean)
- Source:
- SignedCms.cs
- Source:
- SignedCms.cs
- Source:
- SignedCms.cs
- 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
Se ha pasado una referencia nula a un método que no la acepta como argumento válido.
No se pudo finalizar una operación criptográfica.
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.