SignedCms.CheckSignature Metodo

Definizione

Spazio dei nomi:

System.Security.Cryptography.Pkcs

Assembly:

System.Security.Cryptography.Pkcs.dll

Pacchetto:

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

Verifica le firme digitali nei messaggi CMS/PKCS #7 firmati.

Overload

CheckSignature(Boolean)	Il metodo CheckSignature(Boolean) verifica le firme digitali nel messaggio CMS/PKCS #7 firmato e, facoltativamente, convalida i certificati del firmatario.
CheckSignature(X509Certificate2Collection, Boolean)	Il metodo CheckSignature(X509Certificate2Collection, Boolean) verifica le firme digitali nel messaggio CMS/PKCS #7 firmato utilizzando l'insieme di certificati specificato e, facoltativamente, convalida i certificati del firmatario.

CheckSignature(Boolean)

Origine:

SignedCms.cs

Il metodo CheckSignature(Boolean) verifica le firme digitali nel messaggio CMS/PKCS #7 firmato e, facoltativamente, convalida i certificati del firmatario.

public:
 void CheckSignature(bool verifySignatureOnly);

public void CheckSignature (bool verifySignatureOnly);

member this.CheckSignature : bool -> unit

Public Sub CheckSignature (verifySignatureOnly As Boolean)

Parametri

verifySignatureOnly

Boolean

Valore Boolean che specifica se vengono solo verificate le firme digitali senza convalidare i certificati dei firmatari.

Se verifySignatureOnly è true, vengono verificate solo le firme digitali. Se è false, vengono verificate le firme digitali e vengono convalidati i certificati dei firmatari e gli scopi dei certificati. Gli scopi di un certificato sono considerati validi se il certificato non prevede l'utilizzo della chiave o se l'utilizzo della chiave supporta le firme digitali o il non-rifiuto.

Eccezioni

ArgumentNullException

È stato passato un riferimento null a un metodo che non lo accetta come argomento valido.

CryptographicException

Impossibile completare un'operazione di crittografia.

InvalidOperationException

Una chiamata al metodo non era valida per lo stato corrente dell'oggetto.

Esempio

Nell'esempio seguente viene illustrato il posizionamento di CheckSignature(Boolean) tra i passaggi necessari per verificare le firme in un SignedCms messaggio. In questo esempio il contenuto del messaggio non viene scollegato. Il contenuto del messaggio è incluso nel SignedCms messaggio.

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

Nell'esempio seguente viene illustrato il posizionamento di CheckSignature(Boolean) tra i passaggi necessari per verificare le firme in un SignedCms messaggio. In questo esempio il contenuto del messaggio viene scollegato, quindi il contenuto del messaggio deve essere verificato indipendentemente dal SignedCms messaggio.

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

Commenti

Questo metodo verifica tutte le firme, incluse le controfirma, nel messaggio CMS/PKCS #7. Se sono presenti attributi firmati inclusi nel messaggio, questi attributi vengono verificati anche. Se si sceglie di convalidare i certificati, viene convalidata l'intera parte inclusa della catena di certificati.

Questo metodo genera un'eccezione se la verifica di una firma digitale ha esito negativo o se non vengono soddisfatti i requisiti di convalida.

CheckSignature(X509Certificate2Collection, Boolean)

Origine:

SignedCms.cs

Il metodo CheckSignature(X509Certificate2Collection, Boolean) verifica le firme digitali nel messaggio CMS/PKCS #7 firmato utilizzando l'insieme di certificati specificato e, facoltativamente, convalida i certificati del firmatario.

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)

Parametri

extraStore

X509Certificate2Collection

Oggetto X509Certificate2Collection che può essere utilizzato per convalidare la catena di certificati. Se non devono essere utilizzati certificati aggiuntivi per convalidare la catena di certificati, utilizzare il metodo CheckSignature(Boolean) invece di CheckSignature(X509Certificate2Collection, Boolean).

verifySignatureOnly

Boolean

Valore Boolean che specifica se vengono solo verificate le firme digitali senza convalidare i certificati dei firmatari.

Se verifySignatureOnly è true, vengono verificate solo le firme digitali. Se è false, vengono verificate le firme digitali e vengono convalidati i certificati dei firmatari e gli scopi dei certificati. Gli scopi di un certificato sono considerati validi se il certificato non prevede l'utilizzo della chiave o se l'utilizzo della chiave supporta le firme digitali o il non-rifiuto.

Eccezioni

ArgumentNullException

È stato passato un riferimento null a un metodo che non lo accetta come argomento valido.

CryptographicException

Impossibile completare un'operazione di crittografia.

InvalidOperationException

Una chiamata al metodo non era valida per lo stato corrente dell'oggetto.

Commenti

Questo metodo verifica tutte le firme, incluse le controfirma, nel messaggio CMS/PKCS #7. Se sono presenti attributi firmati inclusi nel messaggio, questi attributi vengono verificati anche. Se si sceglie di convalidare i certificati, viene convalidata l'intera parte inclusa della catena di certificati.

Questo metodo genera un'eccezione se la verifica di una firma digitale ha esito negativo o se non vengono soddisfatti i requisiti di convalida.