Rfc3161TimestampRequest.CreateFromData Methode

Definition

Namespace:

System.Security.Cryptography.Pkcs

Assembly:

System.Security.Cryptography.Pkcs.dll

Paket:

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

Quelle:

Rfc3161TimestampRequest.cs

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);

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

Rfc3161TimestampRequest

Eine Rfc3161TimestampRequest, die die ausgewählten Werte darstellt.

Ausnahmen

ArgumentException

hashAlgorithm.Name ist null oder Empty.

CryptographicException

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.

Weitere Informationen

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