SignedCms.CheckSignature Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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)
- Source:
- SignedCms.cs
- Source:
- SignedCms.cs
- Source:
- SignedCms.cs
- Source:
- SignedCms.cs
- Source:
- SignedCms.cs
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
Une référence null a été passée à une méthode pour laquelle cet argument n'est pas valide.
Une opération de chiffrement n'a pas pu être terminée.
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.
S’applique à
CheckSignature(X509Certificate2Collection, Boolean)
- Source:
- SignedCms.cs
- Source:
- SignedCms.cs
- Source:
- SignedCms.cs
- Source:
- SignedCms.cs
- Source:
- SignedCms.cs
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
Une référence null a été passée à une méthode pour laquelle cet argument n'est pas valide.
Une opération de chiffrement n'a pas pu être terminée.
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.