Rfc3161TimestampRequest.CreateFromData Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Erstellt eine Zeitstempelanforderung, indem für die angegebenen Daten mit einem angegebenen Algorithmus ein Hashwert berechnet wird.
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
Parameter
- data
- ReadOnlySpan<Byte>
Die mit dem Zeitstempel zu versehenden Daten, für die von dieser Methode ein Hashwert berechnet wird.
- hashAlgorithm
- HashAlgorithmName
Der mit dieser Zeitstempelanforderung zu verwendende Hashalgorithmus.
- requestedPolicyId
- Oid
Der Objektbezeichner (OID) für eine Zeitstempelrichtlinie, die den Timestamp Authority (TSA) verwenden soll, oder null
, um keine Einstellung auszudrücken.
- nonce
- Nullable<ReadOnlyMemory<Byte>>
Eine optionale Nonce (einmal verwendete Zahl) zur eindeutigen Identifizierung dieser Anforderung, um sie mit der Antwort zu koppeln. Der Wert wird als vorzeichenlose Big-Endian-Ganzzahl interpretiert und kann auf das Codierungsformat normiert werden.
- requestSignerCertificates
- Boolean
true
, um anzugeben, dass die Timestamp Authority (TSA) das Signaturzertifikat in das ausgestellte Zeitstempeltoken aufnehmen muss, ansonsten false
.
- extensions
- X509ExtensionCollection
Eine optionale Auflistung von Erweiterungen, die in die Anforderung aufgenommen werden sollen.
Gibt zurück
Eine Rfc3161TimestampRequest, die die ausgewählten Werte darstellt.
Ausnahmen
hashAlgorithm
ist kein bekannter Hashalgorithmus.
Hinweise
Kryptografische Zeitstempel werden immer auf eine Kombination aus dem Datenhash und dem Algorithmusbezeichner für den Hashalgorithmus angewendet, der zum Hashen der Daten verwendet wird. Diese Methode ist eine praktische Alternative zu dem Zeitpunkt, CreateFromHash(ReadOnlyMemory<Byte>, HashAlgorithmName, Oid, Nullable<ReadOnlyMemory<Byte>>, Boolean, X509ExtensionCollection) in dem die Daten noch nicht gehasht wurden.
Der Noncewert in dieser Methode wird als ganzzahliger Big-Endian-Wert ohne Vorzeichen behandelt. Diese Methode normalisiert die Eingabe in eine BER INTEGER-Codierung, bevor der Noncewert zugewiesen wird. Der normalisierte Wert wird von der GetNonce() -Methode zurückgegeben.