SignedCms.CheckSignature Yöntem

Tanım

Ad Alanı:

System.Security.Cryptography.Pkcs

Bütünleştirilmiş Kod:

System.Security.Cryptography.Pkcs.dll

Paket:

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

İmzalı CMS/PKCS #7 iletisindeki dijital imzaları doğrular.

Aşırı Yüklemeler

CheckSignature(Boolean)	CheckSignature(Boolean) yöntemi imzalı CMS/PKCS #7 iletisindeki dijital imzaları doğrular ve isteğe bağlı olarak imzalayanların sertifikalarını doğrular.
CheckSignature(X509Certificate2Collection, Boolean)	yöntemi, CheckSignature(X509Certificate2Collection, Boolean) belirtilen sertifika koleksiyonunu kullanarak imzalı CMS/PKCS #7 iletisindeki dijital imzaları doğrular ve isteğe bağlı olarak imzalayanların sertifikalarını doğrular.

CheckSignature(Boolean)

Kaynak:

SignedCms.cs

CheckSignature(Boolean) yöntemi imzalı CMS/PKCS #7 iletisindeki dijital imzaları doğrular ve isteğe bağlı olarak imzalayanların sertifikalarını doğrular.

public:
 void CheckSignature(bool verifySignatureOnly);

public void CheckSignature (bool verifySignatureOnly);

member this.CheckSignature : bool -> unit

Public Sub CheckSignature (verifySignatureOnly As Boolean)

Parametreler

verifySignatureOnly

Boolean

Boolean İmzalayanların sertifikaları doğrulanmadan yalnızca dijital imzaların doğrulanıp doğrulanmayacağını belirten bir değer.

ise verifySignatureOnlytrue, yalnızca dijital imzalar doğrulanır. ise falsedijital imzalar doğrulanır, imzalayanların sertifikaları doğrulanır ve sertifikaların amaçları doğrulanır. Sertifikanın amacı, sertifikanın anahtar kullanımı yoksa veya anahtar kullanımı dijital imzaları veya reddedilmemelerini destekliyorsa geçerli kabul edilir.

Özel durumlar

ArgumentNullException

Geçerli bir bağımsız değişken olarak kabul etmeyen bir yönteme null başvuru geçirildi.

CryptographicException

Şifreleme işlemi tamamlanamadı.

InvalidOperationException

Nesnenin geçerli durumu için yöntem çağrısı geçersizdi.

Örnekler

Aşağıdaki örnek, bir SignedCms iletideki imzaları doğrulamak için gereken adımlar arasında öğesinin yerleşimini CheckSignature(Boolean) gösterir. Bu örnekte, ileti içeriği ayrılmamış. İleti içeriği iletiye SignedCms eklenir.

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

Aşağıdaki örnek, bir SignedCms iletideki imzaları doğrulamak için gereken adımlar arasında öğesinin yerleşimini CheckSignature(Boolean) gösterir. Bu örnekte, ileti içeriği ayrılmıştır, bu nedenle ileti içeriğinin iletiden SignedCms bağımsız olarak doğrulanmış olması gerekir.

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

Açıklamalar

Bu yöntem, CMS/PKCS #7 iletisinde karşı imzalar da dahil olmak üzere tüm imzaları doğrular. İletiye eklenmiş imzalı öznitelikler varsa, bu öznitelikler de doğrulanır. Sertifikaları doğrulamak için seçeneği seçilirse, sertifika zincirinin dahil edilen kısmının tamamı doğrulanır.

Dijital imza doğrulaması başarısız olursa veya doğrulama gereksinimleri karşılanmazsa bu yöntem bir özel durum oluşturur.

CheckSignature(X509Certificate2Collection, Boolean)

Kaynak:

SignedCms.cs

yöntemi, CheckSignature(X509Certificate2Collection, Boolean) belirtilen sertifika koleksiyonunu kullanarak imzalı CMS/PKCS #7 iletisindeki dijital imzaları doğrular ve isteğe bağlı olarak imzalayanların sertifikalarını doğrular.

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)

Parametreler

extraStore

X509Certificate2Collection

X509Certificate2Collection Sertifika zincirini doğrulamak için kullanılabilecek bir nesne. Sertifika zincirini doğrulamak için kullanılacak ek sertifika yoksa yerine kullanın CheckSignature(Boolean)CheckSignature(X509Certificate2Collection, Boolean).

verifySignatureOnly

Boolean

Boolean İmzalayanların sertifikaları doğrulanmadan yalnızca dijital imzaların doğrulanıp doğrulanmayacağını belirten bir değer.

ise verifySignatureOnlytrue, yalnızca dijital imzalar doğrulanır. ise falsedijital imzalar doğrulanır, imzalayanların sertifikaları doğrulanır ve sertifikaların amaçları doğrulanır. Sertifikanın amacı, sertifikanın anahtar kullanımı yoksa veya anahtar kullanımı dijital imzaları veya reddedilmemelerini destekliyorsa geçerli kabul edilir.

Özel durumlar

ArgumentNullException

Geçerli bir bağımsız değişken olarak kabul etmeyen bir yönteme null başvuru geçirildi.

CryptographicException

Şifreleme işlemi tamamlanamadı.

InvalidOperationException

Nesnenin geçerli durumu için yöntem çağrısı geçersizdi.

Açıklamalar

Bu yöntem, CMS/PKCS #7 iletisinde karşı imzalar da dahil olmak üzere tüm imzaları doğrular. İletiye eklenmiş imzalı öznitelikler varsa, bu öznitelikler de doğrulanır. Sertifikaları doğrulamak için seçeneği seçilirse, sertifika zincirinin dahil edilen kısmının tamamı doğrulanır.

Dijital imza doğrulaması başarısız olursa veya doğrulama gereksinimleri karşılanmazsa bu yöntem bir özel durum oluşturur.