SignedCms.CheckSignature Metoda

Definicja

Przestrzeń nazw:

System.Security.Cryptography.Pkcs

Zestaw:

System.Security.Cryptography.Pkcs.dll

Pakiet:

System.Security.Cryptography.Pkcs v9.0.0-preview.4.24266.19

Weryfikuje podpisy cyfrowe w podpisanym komunikacie CMS/PKCS #7.

Przeciążenia

CheckSignature(Boolean)	Metoda CheckSignature(Boolean) weryfikuje podpisy cyfrowe w podpisanym komunikacie CMS/PKCS #7 i opcjonalnie weryfikuje certyfikaty osób podpisujących.
CheckSignature(X509Certificate2Collection, Boolean)	Metoda CheckSignature(X509Certificate2Collection, Boolean) weryfikuje podpisy cyfrowe w podpisanym komunikacie CMS/PKCS #7 przy użyciu określonej kolekcji certyfikatów i, opcjonalnie, weryfikuje certyfikaty osoby podpisujących.

CheckSignature(Boolean)

Źródło:

SignedCms.cs

Metoda CheckSignature(Boolean) weryfikuje podpisy cyfrowe w podpisanym komunikacie CMS/PKCS #7 i opcjonalnie weryfikuje certyfikaty osób podpisujących.

public:
 void CheckSignature(bool verifySignatureOnly);

public void CheckSignature (bool verifySignatureOnly);

member this.CheckSignature : bool -> unit

Public Sub CheckSignature (verifySignatureOnly As Boolean)

Parametry

verifySignatureOnly

Boolean

Boolean Wartość określająca, czy tylko podpisy cyfrowe są weryfikowane bez weryfikowania certyfikatów osoby podpisujące.

Jeśli verifySignatureOnly parametr ma truewartość , tylko podpisy cyfrowe są weryfikowane. Jeśli jest falseto , podpisy cyfrowe są weryfikowane, certyfikaty osoby podpisujących są weryfikowane, a cele certyfikatów są weryfikowane. Cele certyfikatu są uznawane za ważne, jeśli certyfikat nie ma użycia klucza lub jeśli użycie klucza obsługuje podpisy cyfrowe lub nieoddanie.

Wyjątki

ArgumentNullException

Odwołanie o wartości null zostało przekazane do metody, która nie akceptuje jej jako prawidłowego argumentu.

CryptographicException

Nie można ukończyć operacji kryptograficznych.

InvalidOperationException

Wywołanie metody było nieprawidłowe dla bieżącego stanu obiektu.

Przykłady

W poniższym przykładzie pokazano umieszczanie CheckSignature(Boolean) spośród kroków niezbędnych do zweryfikowania podpisów SignedCms w komunikacie. W tym przykładzie zawartość wiadomości nie jest odłączona. Zawartość wiadomości jest dołączona do SignedCms wiadomości.

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

W poniższym przykładzie pokazano umieszczanie CheckSignature(Boolean) spośród kroków niezbędnych do zweryfikowania podpisów SignedCms w komunikacie. W tym przykładzie zawartość komunikatu jest odłączona, więc zawartość wiadomości musi zostać zweryfikowana niezależnie SignedCms od wiadomości.

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

Uwagi

Ta metoda weryfikuje wszystkie podpisy, w tym kontrapisy, w komunikacie CMS/PKCS #7. Jeśli w komunikacie znajdują się podpisane atrybuty, te atrybuty również są weryfikowane. Jeśli opcja zostanie wybrana do weryfikacji certyfikatów, zostanie zweryfikowana cała dołączona część łańcucha certyfikatów.

Ta metoda zgłasza wyjątek, jeśli weryfikacja podpisu cyfrowego nie powiedzie się lub nie zostaną spełnione jakiekolwiek wymagania dotyczące weryfikacji.

CheckSignature(X509Certificate2Collection, Boolean)

Źródło:

SignedCms.cs

Metoda CheckSignature(X509Certificate2Collection, Boolean) weryfikuje podpisy cyfrowe w podpisanym komunikacie CMS/PKCS #7 przy użyciu określonej kolekcji certyfikatów i, opcjonalnie, weryfikuje certyfikaty osoby podpisujących.

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)

Parametry

extraStore

X509Certificate2Collection

Obiekt X509Certificate2Collection , który może służyć do weryfikowania łańcucha certyfikatów. Jeśli do weryfikacji łańcucha certyfikatów nie mają być używane żadne dodatkowe certyfikaty, użyj polecenia CheckSignature(Boolean) zamiast CheckSignature(X509Certificate2Collection, Boolean).

verifySignatureOnly

Boolean

Boolean Wartość określająca, czy tylko podpisy cyfrowe są weryfikowane bez weryfikowania certyfikatów osoby podpisujące.

Jeśli verifySignatureOnly parametr ma truewartość , tylko podpisy cyfrowe są weryfikowane. Jeśli jest falseto , podpisy cyfrowe są weryfikowane, certyfikaty osoby podpisujących są weryfikowane, a cele certyfikatów są weryfikowane. Cele certyfikatu są uznawane za ważne, jeśli certyfikat nie ma użycia klucza lub jeśli użycie klucza obsługuje podpisy cyfrowe lub nieoddanie.

Wyjątki

ArgumentNullException

Odwołanie o wartości null zostało przekazane do metody, która nie akceptuje jej jako prawidłowego argumentu.

CryptographicException

Nie można ukończyć operacji kryptograficznych.

InvalidOperationException

Wywołanie metody było nieprawidłowe dla bieżącego stanu obiektu.

Uwagi

Ta metoda weryfikuje wszystkie podpisy, w tym kontrapisy, w komunikacie CMS/PKCS #7. Jeśli w komunikacie znajdują się podpisane atrybuty, te atrybuty również są weryfikowane. Jeśli opcja zostanie wybrana do weryfikacji certyfikatów, zostanie zweryfikowana cała dołączona część łańcucha certyfikatów.

Ta metoda zgłasza wyjątek, jeśli weryfikacja podpisu cyfrowego nie powiedzie się lub nie zostaną spełnione jakiekolwiek wymagania dotyczące weryfikacji.