Rfc3161TimestampRequest.CreateFromSignerInfo Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Creates a timestamp request by hashing the signature of the provided signer with a specified algorithm.
public static System.Security.Cryptography.Pkcs.Rfc3161TimestampRequest CreateFromSignerInfo (System.Security.Cryptography.Pkcs.SignerInfo signerInfo, System.Security.Cryptography.HashAlgorithmName hashAlgorithm, System.Security.Cryptography.Oid? requestedPolicyId = default, ReadOnlyMemory<byte>? nonce = default, bool requestSignerCertificates = false, System.Security.Cryptography.X509Certificates.X509ExtensionCollection? extensions = default);
public static System.Security.Cryptography.Pkcs.Rfc3161TimestampRequest CreateFromSignerInfo (System.Security.Cryptography.Pkcs.SignerInfo signerInfo, System.Security.Cryptography.HashAlgorithmName hashAlgorithm, System.Security.Cryptography.Oid requestedPolicyId = default, ReadOnlyMemory<byte>? nonce = default, bool requestSignerCertificates = false, System.Security.Cryptography.X509Certificates.X509ExtensionCollection extensions = default);
static member CreateFromSignerInfo : System.Security.Cryptography.Pkcs.SignerInfo * System.Security.Cryptography.HashAlgorithmName * System.Security.Cryptography.Oid * Nullable<ReadOnlyMemory<byte>> * bool * System.Security.Cryptography.X509Certificates.X509ExtensionCollection -> System.Security.Cryptography.Pkcs.Rfc3161TimestampRequest
Public Shared Function CreateFromSignerInfo (signerInfo As SignerInfo, hashAlgorithm As HashAlgorithmName, Optional requestedPolicyId As Oid = Nothing, Optional nonce As Nullable(Of ReadOnlyMemory(Of Byte)) = Nothing, Optional requestSignerCertificates As Boolean = false, Optional extensions As X509ExtensionCollection = Nothing) As Rfc3161TimestampRequest
Parameters
- signerInfo
- SignerInfo
The CMS signer information to build a timestamp request for.
- hashAlgorithm
- HashAlgorithmName
The hash algorithm to use with this timestamp request.
- requestedPolicyId
- Oid
The Object Identifier (OID) for the timestamp policy that the Timestamp Authority (TSA) should use, or null
to express no preference.
- nonce
- Nullable<ReadOnlyMemory<Byte>>
An optional nonce (number used once) to uniquely identify this request to pair it with the response. The value is interpreted as an unsigned big-endian integer and may be normalized to the encoding format.
- requestSignerCertificates
- Boolean
true
to indicate the Timestamp Authority (TSA) must include the signing certificate in the issued timestamp token; otherwise, false
.
- extensions
- X509ExtensionCollection
An optional collection of extensions to include in the request.
Returns
An Rfc3161TimestampRequest representing the chosen values.
Exceptions
signerInfo
is null
.
hashAlgorithm
is not a known hash algorithm.
Remarks
This constructor creates a timestamp for the signature value of a SignerInfo value, per the recommendation of IETF RFC 3161 Appendix A (Signature Time-stamp attribute using CMS).
The nonce value in this method is treated as an unsigned, big-endian integer. This method normalizes the input to a BER INTEGER encoding before assigning the nonce value. The normalized value is returned by the GetNonce() method.