SignedCms.CheckSignature Méthode

Définition

Espace de noms:

System.Security.Cryptography.Pkcs

Assembly:

System.Security.Cryptography.Pkcs.dll

Vérifie les signatures numériques du message CMS/PKCS signé #7.

Surcharges

CheckSignature(Boolean)	La méthode CheckSignature(Boolean) vérifie les signatures numériques sur le message CMS/PKCS #7 signé et, facultativement, valide les certificats des signataires.
CheckSignature(X509Certificate2Collection, Boolean)	La méthode CheckSignature(X509Certificate2Collection, Boolean) vérifie les signatures numériques du message CMS/PKCS #7 signé à l'aide de la collection spécifiée de certificats et, facultativement, valide les certificats des signataires.

CheckSignature(Boolean)

La méthode CheckSignature(Boolean) vérifie les signatures numériques sur le message CMS/PKCS #7 signé et, facultativement, valide les certificats des signataires.

public:
 void CheckSignature(bool verifySignatureOnly);

public void CheckSignature (bool verifySignatureOnly);

member this.CheckSignature : bool -> unit

Public Sub CheckSignature (verifySignatureOnly As Boolean)

Paramètres

verifySignatureOnly

Boolean

Valeur Boolean qui spécifie si seules les signatures numériques sont vérifiées sans validation des certificats des signataires.

Si verifySignatureOnly est true, seules les signatures numériques sont vérifiées. Si sa valeur est false, les signatures numériques sont vérifiées, les certificats des signataires sont validés et les objectifs des certificats sont validés. Les objectifs d'un certificat sont considérés comme valides si le certificat n'est pas utilisé dans le cadre d'une clé ou si l'utilisation de la clé prend en charge les signatures numériques ou la non-répudiation.

Exceptions

ArgumentNullException

Une référence null a été passée à une méthode pour laquelle cet argument n'est pas valide.

CryptographicException

Une opération de chiffrement n'a pas pu être terminée.

InvalidOperationException

Un appel de méthode n'était pas valide pour l'état en cours de l'objet.

Exemples

L’exemple suivant montre le placement de CheckSignature(Boolean) parmi les étapes nécessaires pour vérifier les signatures sur un SignedCms message. Dans cet exemple, le contenu du message n’est pas détaché. Le contenu du message est inclus dans le SignedCms message.

// 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)

L’exemple suivant montre le placement de CheckSignature(Boolean) parmi les étapes nécessaires pour vérifier les signatures sur un SignedCms message. Dans cet exemple, le contenu du message étant détaché, le contenu du message doit être vérifié indépendamment du SignedCms message.

// 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)

Remarques

Cette méthode vérifie toutes les signatures, y compris les contresignatures, sur le message CMS/PKCS #7. S’il existe des attributs signés inclus dans le message, ces attributs sont également vérifiés. Si l’option est choisie pour valider les certificats, toute la partie incluse de la chaîne de certificats est validée.

Cette méthode lève une exception si la vérification d’une signature numérique échoue ou si des exigences de validation ne sont pas remplies.

CheckSignature(X509Certificate2Collection, Boolean)

La méthode CheckSignature(X509Certificate2Collection, Boolean) vérifie les signatures numériques du message CMS/PKCS #7 signé à l'aide de la collection spécifiée de certificats et, facultativement, valide les certificats des signataires.

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)

Paramètres

extraStore

X509Certificate2Collection

Objet X509Certificate2Collection pouvant être utilisé pour valider la chaîne du certificat. Si aucun certificat supplémentaire n'est utilisé pour valider la chaîne du certificat, utilisez CheckSignature(Boolean) au lieu de CheckSignature(X509Certificate2Collection, Boolean).

verifySignatureOnly

Boolean

Valeur Boolean qui spécifie si seules les signatures numériques sont vérifiées sans validation des certificats des signataires.

Si verifySignatureOnly est true, seules les signatures numériques sont vérifiées. Si sa valeur est false, les signatures numériques sont vérifiées, les certificats des signataires sont validés et les objectifs des certificats sont validés. Les objectifs d'un certificat sont considérés comme valides si le certificat n'est pas utilisé dans le cadre d'une clé ou si l'utilisation de la clé prend en charge les signatures numériques ou la non-répudiation.

Exceptions

ArgumentNullException

Une référence null a été passée à une méthode pour laquelle cet argument n'est pas valide.

CryptographicException

Une opération de chiffrement n'a pas pu être terminée.

InvalidOperationException

Un appel de méthode n'était pas valide pour l'état en cours de l'objet.

Remarques

Cette méthode vérifie toutes les signatures, y compris les contresignatures, sur le message CMS/PKCS #7. S’il existe des attributs signés inclus dans le message, ces attributs sont également vérifiés. Si l’option est choisie pour valider les certificats, toute la partie incluse de la chaîne de certificats est validée.

Cette méthode lève une exception si la vérification d’une signature numérique échoue ou si des exigences de validation ne sont pas remplies.