SignedCms.CheckSignature Metode

Definisi

Ruang nama:

System.Security.Cryptography.Pkcs

Rakitan:

System.Security.Cryptography.Pkcs.dll

Memverifikasi tanda tangan digital pada pesan CMS/PKCS #7 yang ditandatangani.

Overload

CheckSignature(Boolean)	Metode ini CheckSignature(Boolean) memverifikasi tanda tangan digital pada pesan CMS/PKCS #7 yang ditandatangani dan, secara opsional, memvalidasi sertifikat penanda tangan.
CheckSignature(X509Certificate2Collection, Boolean)	Metode ini CheckSignature(X509Certificate2Collection, Boolean) memverifikasi tanda tangan digital pada pesan CMS/PKCS #7 yang ditandatangani dengan menggunakan koleksi sertifikat yang ditentukan dan, secara opsional, memvalidasi sertifikat penanda tangan.

CheckSignature(Boolean)

Sumber:

SignedCms.cs

Metode ini CheckSignature(Boolean) memverifikasi tanda tangan digital pada pesan CMS/PKCS #7 yang ditandatangani dan, secara opsional, memvalidasi sertifikat penanda tangan.

public:
 void CheckSignature(bool verifySignatureOnly);

public void CheckSignature (bool verifySignatureOnly);

member this.CheckSignature : bool -> unit

Public Sub CheckSignature (verifySignatureOnly As Boolean)

Parameter

verifySignatureOnly

Boolean

Boolean Nilai yang menentukan apakah hanya tanda tangan digital yang diverifikasi tanpa sertifikat penanda tangan yang divalidasi.

Jika verifySignatureOnly adalah true, hanya tanda tangan digital yang diverifikasi. Jika ya false, tanda tangan digital diverifikasi, sertifikat penanda tangan divalidasi, dan tujuan sertifikat divalidasi. Tujuan sertifikat dianggap valid jika sertifikat tidak memiliki penggunaan kunci atau jika penggunaan kunci mendukung tanda tangan digital atau nonrepudiasi.

Pengecualian

ArgumentNullException

Referensi null diteruskan ke metode yang tidak menerimanya sebagai argumen yang valid.

CryptographicException

Operasi kriptografi tidak dapat diselesaikan.

InvalidOperationException

Panggilan metode tidak valid untuk status objek saat ini.

Contoh

Contoh berikut menunjukkan penempatan CheckSignature(Boolean) di antara langkah-langkah yang diperlukan untuk memverifikasi tanda tangan pada SignedCms pesan. Dalam contoh ini, konten pesan tidak dilepas. Konten pesan disertakan SignedCms dalam pesan.

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

Contoh berikut menunjukkan penempatan CheckSignature(Boolean) di antara langkah-langkah yang diperlukan untuk memverifikasi tanda tangan pada SignedCms pesan. Dalam contoh ini, konten pesan dilepas, sehingga konten pesan harus diverifikasi secara independen dari SignedCms pesan.

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

Keterangan

Metode ini memverifikasi semua tanda tangan, termasuk countersignature, pada pesan CMS/PKCS #7. Jika ada atribut yang ditandatangani yang disertakan dengan pesan, atribut ini juga diverifikasi. Jika opsi dipilih untuk memvalidasi sertifikat, seluruh bagian rantai sertifikat yang disertakan divalidasi.

Metode ini memberikan pengecualian jika verifikasi tanda tangan digital gagal atau persyaratan validasi apa pun tidak terpenuhi.

CheckSignature(X509Certificate2Collection, Boolean)

Sumber:

SignedCms.cs

Metode ini CheckSignature(X509Certificate2Collection, Boolean) memverifikasi tanda tangan digital pada pesan CMS/PKCS #7 yang ditandatangani dengan menggunakan koleksi sertifikat yang ditentukan dan, secara opsional, memvalidasi sertifikat penanda tangan.

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)

Parameter

extraStore

X509Certificate2Collection

Objek X509Certificate2Collection yang dapat digunakan untuk memvalidasi rantai sertifikat. Jika tidak ada sertifikat tambahan yang akan digunakan untuk memvalidasi rantai sertifikat, gunakan CheckSignature(Boolean) alih-alih CheckSignature(X509Certificate2Collection, Boolean).

verifySignatureOnly

Boolean

Boolean Nilai yang menentukan apakah hanya tanda tangan digital yang diverifikasi tanpa sertifikat penanda tangan yang divalidasi.

Jika verifySignatureOnly adalah true, hanya tanda tangan digital yang diverifikasi. Jika ya false, tanda tangan digital diverifikasi, sertifikat penanda tangan divalidasi, dan tujuan sertifikat divalidasi. Tujuan sertifikat dianggap valid jika sertifikat tidak memiliki penggunaan kunci atau jika penggunaan kunci mendukung tanda tangan digital atau nonrepudiasi.

Pengecualian

ArgumentNullException

Referensi null diteruskan ke metode yang tidak menerimanya sebagai argumen yang valid.

CryptographicException

Operasi kriptografi tidak dapat diselesaikan.

InvalidOperationException

Panggilan metode tidak valid untuk status objek saat ini.

Keterangan

Metode ini memverifikasi semua tanda tangan, termasuk countersignature, pada pesan CMS/PKCS #7. Jika ada atribut yang ditandatangani yang disertakan dengan pesan, atribut ini juga diverifikasi. Jika opsi dipilih untuk memvalidasi sertifikat, seluruh bagian rantai sertifikat yang disertakan divalidasi.

Metode ini memberikan pengecualian jika verifikasi tanda tangan digital gagal atau persyaratan validasi apa pun tidak terpenuhi.