Rfc3161TimestampRequest.CreateFromData Método

Definição

Namespace:

System.Security.Cryptography.Pkcs

Assembly:

System.Security.Cryptography.Pkcs.dll

Pacote:

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

Origem:

Rfc3161TimestampRequest.cs

Cria uma solicitação de carimbo de data/hora pelo hash dos dados fornecidos com um algoritmo especificado.

public static System.Security.Cryptography.Pkcs.Rfc3161TimestampRequest CreateFromData (ReadOnlySpan<byte> data, 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 CreateFromData : ReadOnlySpan<byte> * 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 CreateFromData (data As ReadOnlySpan(Of Byte), 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

Parâmetros

data

ReadOnlySpan<Byte>

Os dados a serem usados para carimbo de data/hora, cujo hash será feito por esse método.

hashAlgorithm

HashAlgorithmName

O algoritmo de hash a ser usado com esta solicitação de carimbo de data/hora.

requestedPolicyId

Oid

O Identificador de Objeto (OID) de uma política de carimbo de data/hora que a Autoridade de Carimbo de Data/Hora (TSA) deve usar, ou null para não expressar preferência.

nonce

Nullable<ReadOnlyMemory<Byte>>

Um nonce (número usado uma vez) opcional para identificar exclusivamente essa solicitação para emparelhá-la com a resposta. O valor é interpretado como um inteiro big-endian não assinado e pode ser normalizado para o formato de codificação.

requestSignerCertificates

Boolean

true para indicar que a Autoridade de Carimbo de Data/Hora (TSA) deve incluir o certificado de autenticação no token de carimbo de data/hora emitido; caso contrário, false.

extensions

X509ExtensionCollection

Uma coleção opcional de extensões a serem incluídas na solicitação.

Retornos

Rfc3161TimestampRequest

Um Rfc3161TimestampRequest que representa os valores escolhidos.

Exceções

ArgumentException

hashAlgorithm.Name é null ou Empty.

CryptographicException

hashAlgorithm não é um algoritmo de hash conhecido.

Comentários

Carimbos de data/hora criptográficos são sempre aplicados a uma combinação do hash de dados e do identificador de algoritmo para o algoritmo de hash usado para hash dos dados. Esse método é uma alternativa conveniente para CreateFromHash(ReadOnlyMemory<Byte>, HashAlgorithmName, Oid, Nullable<ReadOnlyMemory<Byte>>, Boolean, X509ExtensionCollection) quando os dados ainda não foram hash.

O valor nonce neste método é tratado como um inteiro sem sinal de big-endian. Esse método normaliza a entrada para uma codificação BER INTEGER antes de atribuir o valor nonce. O valor normalizado é retornado pelo GetNonce() método .

Confira também

• CreateFromHash(ReadOnlyMemory<Byte>, HashAlgorithmName, Oid, Nullable<ReadOnlyMemory<Byte>>, Boolean, X509ExtensionCollection)
• CreateFromSignerInfo(SignerInfo, HashAlgorithmName, Oid, Nullable<ReadOnlyMemory<Byte>>, Boolean, X509ExtensionCollection)