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/PKCS #7 firmado.
Sobrecargas
| Nombre | Description |
|---|---|
| CheckSignature(Boolean) |
El CheckSignature(Boolean) método comprueba las firmas digitales en el mensaje CMS/PKCS #7 firmado y, opcionalmente, valida los certificados de los firmantes. |
| CheckSignature(X509Certificate2Collection, Boolean) |
El CheckSignature(X509Certificate2Collection, Boolean) método comprueba las firmas digitales en el mensaje CMS/PKCS #7 firmado mediante 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
- Source:
- SignedCms.cs
- Source:
- SignedCms.cs
- Source:
- SignedCms.cs
- Source:
- SignedCms.cs
El CheckSignature(Boolean) método comprueba las firmas digitales en el mensaje CMS/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 -> unitPublic Sub CheckSignature (verifySignatureOnly As Boolean)Parámetros
- verifySignatureOnly
- Boolean
Valor Boolean que especifica si solo se comprueban las firmas digitales sin que se validen los certificados de los firmantes.
Si verifySignatureOnly es true, solo 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 tiene ningún uso de clave o si el uso de claves admite firmas digitales o norepudiation.
Excepciones
Se pasó una referencia nula a un método que no lo acepta como argumento válido.
No se pudo completar una operación criptográfica.
Una llamada al método no era 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 de 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 de 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 los certificados, se valida toda la parte incluida de la cadena de certificados.
Este método produce una excepción si se produce un error en 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
- Source:
- SignedCms.cs
- Source:
- SignedCms.cs
- Source:
- SignedCms.cs
- Source:
- SignedCms.cs
El CheckSignature(X509Certificate2Collection, Boolean) método comprueba las firmas digitales en el mensaje CMS/PKCS #7 firmado mediante 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 -> unitPublic Sub CheckSignature (extraStore As X509Certificate2Collection, verifySignatureOnly As Boolean)Parámetros
- extraStore
- X509Certificate2Collection
Objeto X509Certificate2Collection que se puede usar para validar la cadena de certificados. Si no se van a usar certificados adicionales para validar la cadena de certificados, use CheckSignature(Boolean) en lugar de CheckSignature(X509Certificate2Collection, Boolean).
- verifySignatureOnly
- Boolean
Valor Boolean que especifica si solo se comprueban las firmas digitales sin que se validen los certificados de los firmantes.
Si verifySignatureOnly es true, solo 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 tiene ningún uso de clave o si el uso de claves admite firmas digitales o norepudiation.
Excepciones
Se pasó una referencia nula a un método que no lo acepta como argumento válido.
No se pudo completar una operación criptográfica.
Una llamada al método no era 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 los certificados, se valida toda la parte incluida de la cadena de certificados.
Este método produce una excepción si se produce un error en la comprobación de una firma digital o no se cumplen los requisitos de validación.
