SignerInfo Class

 

The SignerInfo class represents a signer associated with a SignedCms object that represents a CMS/PKCS #7 message.

Namespace:   System.Security.Cryptography.Pkcs
Assembly:  System.Security (in System.Security.dll)

System.Object
  System.Security.Cryptography.Pkcs.SignerInfo

[HostProtectionAttribute(SecurityAction.LinkDemand, MayLeakOnAbort = true)]
public sealed class SignerInfo

NameDescription
System_CAPS_pubpropertyCertificate

The Certificate property retrieves the signing certificate associated with the signer information.

System_CAPS_pubpropertyCounterSignerInfos

The CounterSignerInfos property retrieves the set of counter signers associated with the signer information.

System_CAPS_pubpropertyDigestAlgorithm

The DigestAlgorithm property retrieves the Oid object that represents the hash algorithm used in the computation of the signatures.

System_CAPS_pubpropertySignedAttributes

The SignedAttributes property retrieves the CryptographicAttributeObjectCollection collection of signed attributes that is associated with the signer information. Signed attributes are signed along with the rest of the message content.

System_CAPS_pubpropertySignerIdentifier

The SignerIdentifier property retrieves the certificate identifier of the signer associated with the signer information.

System_CAPS_pubpropertyUnsignedAttributes

The UnsignedAttributes property retrieves the CryptographicAttributeObjectCollection collection of unsigned attributes that is associated with the SignerInfo content. Unsigned attributes can be modified without invalidating the signature.

System_CAPS_pubpropertyVersion

The Version property retrieves the signer information version.

NameDescription
System_CAPS_pubmethodCheckHash()

The CheckHash method verifies the data integrity of the CMS/PKCS #7 message signer information. CheckHash is a specialized method used in specific security infrastructure applications in which the subject uses the HashOnly member of the SubjectIdentifierType enumeration when setting up a CmsSigner object. CheckHash does not authenticate the signer information because this method does not involve verifying a digital signature. For general-purpose checking of the integrity and authenticity of CMS/PKCS #7 message signer information and countersignatures, use the CheckSignature(Boolean) or CheckSignature(X509Certificate2Collection, Boolean) methods.

System_CAPS_pubmethodCheckSignature(Boolean)

The CheckSignature(Boolean) method verifies the digital signature of the message and, optionally, validates the certificate.

System_CAPS_pubmethodCheckSignature(X509Certificate2Collection, Boolean)

The CheckSignature(X509Certificate2Collection, Boolean) method verifies the digital signature of the message by using the specified collection of certificates and, optionally, validates the certificate.

System_CAPS_pubmethodComputeCounterSignature()

The ComputeCounterSignature() method prompts the user to select a signing certificate, creates a countersignature, and adds the signature to the CMS/PKCS #7 message. Countersignatures are restricted to one level.

System_CAPS_pubmethodComputeCounterSignature(CmsSigner)

The ComputeCounterSignature(CmsSigner) method creates a countersignature by using the specified signer and adds the signature to the CMS/PKCS #7 message. Countersignatures are restricted to one level.

System_CAPS_pubmethodEquals(Object)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_pubmethodRemoveCounterSignature(Int32)

The RemoveCounterSignature method removes the countersignature at the specified index of the CounterSignerInfos collection.

System_CAPS_pubmethodRemoveCounterSignature(SignerInfo)

The RemoveCounterSignature method removes the countersignature for the specified SignerInfo object.

System_CAPS_pubmethodToString()

Returns a string that represents the current object.(Inherited from Object.)

The signatures represented by the SignerInfo class can be either over message content or a signature. The latter kind of signature is referred to as a countersignature.

This implementation of CMS/PKCS #7 supports only one level of countersignature. That is, a signature can be signed, which forms a countersignature, but that countersignature cannot be signed again.

This class does not have a public constructor; therefore, it cannot be publicly instantiated. It is a read-only class accessible from the SignedCms.SignerInfos property.

.NET Framework
Available since 2.0

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
Show: