SignedCms.CheckSignature Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Controleert de digitale handtekeningen op het ondertekende CMS/PKCS #7-bericht.
Overloads
| Name | Description |
|---|---|
| CheckSignature(Boolean) |
De CheckSignature(Boolean) methode controleert de digitale handtekeningen op het ondertekende CMS/PKCS #7-bericht en valideert desgewenst de certificaten van de ondertekenaars. |
| CheckSignature(X509Certificate2Collection, Boolean) |
De CheckSignature(X509Certificate2Collection, Boolean) methode controleert de digitale handtekeningen op het ondertekende CMS/PKCS #7-bericht met behulp van de opgegeven verzameling certificaten en valideert desgewenst de certificaten van de ondertekenaars. |
CheckSignature(Boolean)
- Bron:
- SignedCms.cs
- Bron:
- SignedCms.cs
- Bron:
- SignedCms.cs
- Bron:
- SignedCms.cs
- Bron:
- SignedCms.cs
- Bron:
- SignedCms.cs
- Bron:
- SignedCms.cs
- Bron:
- SignedCms.cs
De CheckSignature(Boolean) methode controleert de digitale handtekeningen op het ondertekende CMS/PKCS #7-bericht en valideert desgewenst de certificaten van de ondertekenaars.
public:
void CheckSignature(bool verifySignatureOnly);public void CheckSignature(bool verifySignatureOnly);member this.CheckSignature : bool -> unitPublic Sub CheckSignature (verifySignatureOnly As Boolean)Parameters
- verifySignatureOnly
- Boolean
Een Boolean waarde die aangeeft of alleen de digitale handtekeningen worden geverifieerd zonder dat de certificaten van de ondertekenaars worden gevalideerd.
Als verifySignatureOnly dat het is true, worden alleen de digitale handtekeningen geverifieerd. Als dat het is false, worden de digitale handtekeningen geverifieerd, worden de certificaten van de ondertekenaars gevalideerd en worden de doeleinden van de certificaten gevalideerd. De doeleinden van een certificaat worden als geldig beschouwd als het certificaat geen sleutelgebruik heeft of als het sleutelgebruik digitale handtekeningen of niet-onderzoek ondersteunt.
Uitzonderingen
Er is een null-verwijzing doorgegeven aan een methode die deze niet accepteert als een geldig argument.
Een cryptografische bewerking kan niet worden voltooid.
Een methode-aanroep is ongeldig voor de huidige status van het object.
Voorbeelden
In het volgende voorbeeld ziet u de plaatsing van CheckSignature(Boolean) de stappen die nodig zijn om de handtekeningen voor een SignedCms bericht te controleren. In dit voorbeeld wordt de inhoud van het bericht niet losgekoppeld. De inhoud van het bericht is opgenomen in het SignedCms bericht.
// 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)
In het volgende voorbeeld ziet u de plaatsing van CheckSignature(Boolean) de stappen die nodig zijn om de handtekeningen voor een SignedCms bericht te controleren. In dit voorbeeld wordt de inhoud van het bericht losgekoppeld, zodat de inhoud van het bericht onafhankelijk van het SignedCms bericht moet worden geverifieerd.
// 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)
Opmerkingen
Met deze methode worden alle handtekeningen, inclusief tegentekens, gecontroleerd op het bericht CMS/PKCS #7. Als er ondertekende kenmerken zijn opgenomen in het bericht, worden deze kenmerken ook geverifieerd. Als de optie wordt gekozen om certificaten te valideren, wordt het volledige deel van de certificaatketen gevalideerd.
Deze methode genereert een uitzondering als de verificatie van een digitale handtekening mislukt of als niet aan de validatievereisten wordt voldaan.
Van toepassing op
CheckSignature(X509Certificate2Collection, Boolean)
- Bron:
- SignedCms.cs
- Bron:
- SignedCms.cs
- Bron:
- SignedCms.cs
- Bron:
- SignedCms.cs
- Bron:
- SignedCms.cs
- Bron:
- SignedCms.cs
- Bron:
- SignedCms.cs
- Bron:
- SignedCms.cs
De CheckSignature(X509Certificate2Collection, Boolean) methode controleert de digitale handtekeningen op het ondertekende CMS/PKCS #7-bericht met behulp van de opgegeven verzameling certificaten en valideert desgewenst de certificaten van de ondertekenaars.
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)Parameters
- extraStore
- X509Certificate2Collection
Een X509Certificate2Collection object dat kan worden gebruikt om de certificaatketen te valideren. Als er geen extra certificaten moeten worden gebruikt om de certificaatketen te valideren, gebruikt CheckSignature(Boolean) u in plaats van CheckSignature(X509Certificate2Collection, Boolean).
- verifySignatureOnly
- Boolean
Een Boolean waarde die aangeeft of alleen de digitale handtekeningen worden geverifieerd zonder dat de certificaten van de ondertekenaars worden gevalideerd.
Als verifySignatureOnly dat het is true, worden alleen de digitale handtekeningen geverifieerd. Als dat het is false, worden de digitale handtekeningen geverifieerd, worden de certificaten van de ondertekenaars gevalideerd en worden de doeleinden van de certificaten gevalideerd. De doeleinden van een certificaat worden als geldig beschouwd als het certificaat geen sleutelgebruik heeft of als het sleutelgebruik digitale handtekeningen of niet-onderzoek ondersteunt.
Uitzonderingen
Er is een null-verwijzing doorgegeven aan een methode die deze niet accepteert als een geldig argument.
Een cryptografische bewerking kan niet worden voltooid.
Een methode-aanroep is ongeldig voor de huidige status van het object.
Opmerkingen
Met deze methode worden alle handtekeningen, inclusief tegentekens, gecontroleerd op het bericht CMS/PKCS #7. Als er ondertekende kenmerken zijn opgenomen in het bericht, worden deze kenmerken ook geverifieerd. Als de optie wordt gekozen om certificaten te valideren, wordt het volledige deel van de certificaatketen gevalideerd.
Deze methode genereert een uitzondering als de verificatie van een digitale handtekening mislukt of als niet aan de validatievereisten wordt voldaan.
