SignedCms.CheckSignature Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überprüft die digitalen Signaturen auf der signierten CMS/PKCS #7-Nachricht.
Überlädt
| Name | Beschreibung |
|---|---|
| CheckSignature(Boolean) |
Die CheckSignature(Boolean) Methode überprüft die digitalen Signaturen in der signierten CMS/PKCS #7-Nachricht und überprüft optional die Zertifikate der Signierer. |
| CheckSignature(X509Certificate2Collection, Boolean) |
Die CheckSignature(X509Certificate2Collection, Boolean) Methode überprüft die digitalen Signaturen auf der signierten CMS/PKCS #7-Nachricht mithilfe der angegebenen Sammlung von Zertifikaten und überprüft optional die Zertifikate der Signierer. |
CheckSignature(Boolean)
- Quelle:
- SignedCms.cs
- Quelle:
- SignedCms.cs
- Quelle:
- SignedCms.cs
- Quelle:
- SignedCms.cs
- Quelle:
- SignedCms.cs
- Quelle:
- SignedCms.cs
- Quelle:
- SignedCms.cs
- Quelle:
- SignedCms.cs
Die CheckSignature(Boolean) Methode überprüft die digitalen Signaturen in der signierten CMS/PKCS #7-Nachricht und überprüft optional die Zertifikate der Signierer.
public:
void CheckSignature(bool verifySignatureOnly);public void CheckSignature(bool verifySignatureOnly);member this.CheckSignature : bool -> unitPublic Sub CheckSignature (verifySignatureOnly As Boolean)Parameter
- verifySignatureOnly
- Boolean
Ein Boolean Wert, der angibt, ob nur die digitalen Signaturen überprüft werden, ohne dass die Zertifikate der Signierer überprüft werden.
Wenn verifySignatureOnly ja true, werden nur die digitalen Signaturen überprüft. Wenn dies der Grund ist false, werden die digitalen Signaturen überprüft, die Zertifikate der Signierer werden überprüft, und die Zwecke der Zertifikate werden überprüft. Die Zwecke eines Zertifikats gelten als gültig, wenn das Zertifikat keine Schlüsselverwendung hat oder wenn die Schlüsselverwendung digitale Signaturen oder Nichtabstreitbarkeit unterstützt.
Ausnahmen
Ein Nullverweis wurde an eine Methode übergeben, die sie nicht als gültiges Argument akzeptiert.
Ein kryptografischer Vorgang konnte nicht abgeschlossen werden.
Für den aktuellen Zustand des Objekts war ein Methodenaufruf ungültig.
Beispiele
Das folgende Beispiel zeigt die Platzierung zwischen CheckSignature(Boolean) den Schritten, die erforderlich sind, um die Signaturen in einer SignedCms Nachricht zu überprüfen. In diesem Beispiel wird der Nachrichteninhalt nicht getrennt. Der Nachrichteninhalt ist in der SignedCms Nachricht enthalten.
// 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)
Das folgende Beispiel zeigt die Platzierung zwischen CheckSignature(Boolean) den Schritten, die erforderlich sind, um die Signaturen in einer SignedCms Nachricht zu überprüfen. In diesem Beispiel wird der Nachrichteninhalt getrennt, sodass der Nachrichteninhalt unabhängig von der SignedCms Nachricht überprüft werden muss.
// 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)
Hinweise
Diese Methode überprüft alle Signaturen, einschließlich Gegensignaturen, auf der NACHRICHT CMS/PKCS #7. Wenn in der Nachricht signierte Attribute enthalten sind, werden diese Attribute ebenfalls überprüft. Wenn die Option zum Überprüfen von Zertifikaten ausgewählt wird, wird der gesamte enthaltene Teil der Zertifikatkette überprüft.
Diese Methode löst eine Ausnahme aus, wenn die Überprüfung einer digitalen Signatur fehlschlägt oder die Überprüfungsanforderungen nicht erfüllt sind.
Gilt für:
CheckSignature(X509Certificate2Collection, Boolean)
- Quelle:
- SignedCms.cs
- Quelle:
- SignedCms.cs
- Quelle:
- SignedCms.cs
- Quelle:
- SignedCms.cs
- Quelle:
- SignedCms.cs
- Quelle:
- SignedCms.cs
- Quelle:
- SignedCms.cs
- Quelle:
- SignedCms.cs
Die CheckSignature(X509Certificate2Collection, Boolean) Methode überprüft die digitalen Signaturen auf der signierten CMS/PKCS #7-Nachricht mithilfe der angegebenen Sammlung von Zertifikaten und überprüft optional die Zertifikate der Signierer.
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)Parameter
- extraStore
- X509Certificate2Collection
Ein X509Certificate2Collection Objekt, das zum Überprüfen der Zertifikatkette verwendet werden kann. Wenn keine zusätzlichen Zertifikate verwendet werden sollen, um die Zertifikatkette zu überprüfen, verwenden Sie CheckSignature(Boolean) anstelle von CheckSignature(X509Certificate2Collection, Boolean).
- verifySignatureOnly
- Boolean
Ein Boolean Wert, der angibt, ob nur die digitalen Signaturen überprüft werden, ohne dass die Zertifikate der Signierer überprüft werden.
Wenn verifySignatureOnly ja true, werden nur die digitalen Signaturen überprüft. Wenn dies der Grund ist false, werden die digitalen Signaturen überprüft, die Zertifikate der Signierer werden überprüft, und die Zwecke der Zertifikate werden überprüft. Die Zwecke eines Zertifikats gelten als gültig, wenn das Zertifikat keine Schlüsselverwendung hat oder wenn die Schlüsselverwendung digitale Signaturen oder Nichtabstreitbarkeit unterstützt.
Ausnahmen
Ein Nullverweis wurde an eine Methode übergeben, die sie nicht als gültiges Argument akzeptiert.
Ein kryptografischer Vorgang konnte nicht abgeschlossen werden.
Für den aktuellen Zustand des Objekts war ein Methodenaufruf ungültig.
Hinweise
Diese Methode überprüft alle Signaturen, einschließlich Gegensignaturen, auf der NACHRICHT CMS/PKCS #7. Wenn in der Nachricht signierte Attribute enthalten sind, werden diese Attribute ebenfalls überprüft. Wenn die Option zum Überprüfen von Zertifikaten ausgewählt wird, wird der gesamte enthaltene Teil der Zertifikatkette überprüft.
Diese Methode löst eine Ausnahme aus, wenn die Überprüfung einer digitalen Signatur fehlschlägt oder die Überprüfungsanforderungen nicht erfüllt sind.
