Rfc3161TimestampRequest.CreateFromData Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Crea una richiesta di timestamp eseguendo l'hash dei dati forniti con un algoritmo specificato.
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);
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
Parametri
- data
- ReadOnlySpan<Byte>
Dati di cui indicare il timestamp, di cui questo metodo eseguirà l'hash.
- hashAlgorithm
- HashAlgorithmName
Algoritmo hash da usare con questa richiesta di timestamp.
- requestedPolicyId
- Oid
Identificatore di oggetto (OID) di un criterio di timestamp che deve essere usato dall'autorità timestamp oppure null
per non esprimere alcuna preferenza.
- nonce
- Nullable<ReadOnlyMemory<Byte>>
Parametro nonce (numero usato una sola volta) facoltativo che consente di identificare in modo univoco la richiesta per l'associazione con la risposta. Il valore viene interpretato come un intero big-endian senza segno e può essere normalizzato nel formato di codifica.
- requestSignerCertificates
- Boolean
true
per indicare che l'autorità timestamp deve includere il certificato di firma nel token timestamp emesso; in caso contrario, false
.
- extensions
- X509ExtensionCollection
Raccolta opzionale di estensioni da includere nella richiesta.
Restituisce
Oggetto Rfc3161TimestampRequest che rappresenta i valori scelti.
Eccezioni
hashAlgorithm
non è un algoritmo hash noto.
Commenti
I timestamp crittografici vengono sempre applicati a una combinazione dell'hash dei dati e dell'identificatore dell'algoritmo per l'algoritmo hash usato per l'hash dei dati. Questo metodo è un'alternativa conveniente a CreateFromHash(ReadOnlyMemory<Byte>, HashAlgorithmName, Oid, Nullable<ReadOnlyMemory<Byte>>, Boolean, X509ExtensionCollection) quando i dati non sono già stati hash.
Il valore nonce in questo metodo viene considerato come intero senza segno, big-endian. Questo metodo normalizza l'input in una codifica INTEGER BER prima di assegnare il valore nonce. Il valore normalizzato viene restituito dal GetNonce() metodo .