Rfc3161TimestampRequest.CreateFromHash メソッド

定義

名前空間:

System.Security.Cryptography.Pkcs

アセンブリ:

System.Security.Cryptography.Pkcs.dll

パッケージ:

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

オーバーロード

CreateFromHash(ReadOnlyMemory<Byte>, HashAlgorithmName, Oid, Nullable<ReadOnlyMemory<Byte>>, Boolean, X509ExtensionCollection)	事前計算済みのハッシュ値およびハッシュ アルゴリズムの名前を使用して、タイムスタンプ要求を作成します。
CreateFromHash(ReadOnlyMemory<Byte>, Oid, Oid, Nullable<ReadOnlyMemory<Byte>>, Boolean, X509ExtensionCollection)	事前計算済みのハッシュ値およびハッシュ アルゴリズムのオブジェクト識別子を使用して、タイムスタンプ要求を作成します。

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

ソース:

Rfc3161TimestampRequest.cs

事前計算済みのハッシュ値およびハッシュ アルゴリズムの名前を使用して、タイムスタンプ要求を作成します。

public static System.Security.Cryptography.Pkcs.Rfc3161TimestampRequest CreateFromHash (ReadOnlyMemory<byte> hash, 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 CreateFromHash : ReadOnlyMemory<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 CreateFromHash (hash As ReadOnlyMemory(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

パラメーター

hash

ReadOnlyMemory<Byte>

タイムスタンプを付ける事前計算済みのハッシュ値です。

hashAlgorithm

HashAlgorithmName

hash を生成するために使用されるハッシュ アルゴリズム。

requestedPolicyId

Oid

タイムスタンプ局 (TSA) で使用する必要があるタイムスタンプ ポリシーのオブジェクト識別子 (OID) です。null の場合は優先設定がありません。

nonce

Nullable<ReadOnlyMemory<Byte>>

要求を応答に一意に一致させるために使用される省略可能な値。null の場合は要求に nonce が含まれません。

requestSignerCertificates

Boolean

発行されたタイムスタンプ トークンの署名証明書がタイムスタンプ局 (TSA) に含まれる必要がある場合は true。それ以外の場合は false。

extensions

X509ExtensionCollection

要求に含める拡張の、省略可能なコレクション。

戻り値

Rfc3161TimestampRequest

選択した値を表す Rfc3161TimestampRequest です。

例外

CryptographicException

hashAlgorithm は既知のハッシュ アルゴリズムではありません。

注釈

このメソッドは、 パラメーターを hashAlgorithm 使用して、タイムスタンプ要求に含めるオブジェクト識別子 (OID) を決定します。 このメソッドがサポートしていないハッシュ アルゴリズムに基づいてタイムスタンプの要求を作成する場合は、 オーバーロードを使用します CreateFromHash(ReadOnlyMemory<Byte>, Oid, Oid, Nullable<ReadOnlyMemory<Byte>>, Boolean, X509ExtensionCollection) 。

このメソッドの nonce 値は、符号なし、ビッグ エンディアン整数として扱われます。 このメソッドは、nonce 値を割り当てる前に、入力を BER INTEGER エンコードに正規化します。 正規化された値は、 メソッドによって GetNonce() 返されます。

こちらもご覧ください

• CreateFromData(ReadOnlySpan<Byte>, HashAlgorithmName, Oid, Nullable<ReadOnlyMemory<Byte>>, Boolean, X509ExtensionCollection)
• CreateFromHash(ReadOnlyMemory<Byte>, Oid, Oid, Nullable<ReadOnlyMemory<Byte>>, Boolean, X509ExtensionCollection)

CreateFromHash(ReadOnlyMemory<Byte>, Oid, Oid, Nullable<ReadOnlyMemory<Byte>>, Boolean, X509ExtensionCollection)

ソース:

Rfc3161TimestampRequest.cs

事前計算済みのハッシュ値およびハッシュ アルゴリズムのオブジェクト識別子を使用して、タイムスタンプ要求を作成します。

public static System.Security.Cryptography.Pkcs.Rfc3161TimestampRequest CreateFromHash (ReadOnlyMemory<byte> hash, System.Security.Cryptography.Oid hashAlgorithmId, System.Security.Cryptography.Oid? requestedPolicyId = default, ReadOnlyMemory<byte>? nonce = default, bool requestSignerCertificates = false, System.Security.Cryptography.X509Certificates.X509ExtensionCollection? extensions = default);

static member CreateFromHash : ReadOnlyMemory<byte> * System.Security.Cryptography.Oid * System.Security.Cryptography.Oid * Nullable<ReadOnlyMemory<byte>> * bool * System.Security.Cryptography.X509Certificates.X509ExtensionCollection -> System.Security.Cryptography.Pkcs.Rfc3161TimestampRequest

Public Shared Function CreateFromHash (hash As ReadOnlyMemory(Of Byte), hashAlgorithmId As Oid, 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

パラメーター

hash

ReadOnlyMemory<Byte>

タイムスタンプを付ける事前計算済みのハッシュ値です。

hashAlgorithmId

Oid

hash を生成したハッシュ アルゴリズムのオブジェクト識別子 (OID) です。

requestedPolicyId

Oid

タイムスタンプ局 (TSA) で使う必要があるタイムスタンプ ポリシーのオブジェクト識別子 (OID) です。null の場合は優先設定がありません。

nonce

Nullable<ReadOnlyMemory<Byte>>

この要求を一意に識別して応答とペアリングするための、省略可能な nonce (一度だけ使われる数) です。 値は、符号なしのビッグ エンディアンの整数として解釈され、エンコード形式に正規化されることがあります。

requestSignerCertificates

Boolean

発行されたタイムスタンプ トークンの署名証明書がタイムスタンプ局 (TSA) に含まれる必要がある場合は true。それ以外の場合は false。

extensions

X509ExtensionCollection

要求に含める拡張の、省略可能なコレクション。

戻り値

Rfc3161TimestampRequest

選択した値を表す Rfc3161TimestampRequest です。

例外

ArgumentNullException

hashAlgorithmId は null です。

CryptographicException

hashAlgorithmId。Value が有効な OID ではありません。

注釈

このメソッドの nonce 値は、符号なし、ビッグ エンディアン整数として扱われます。 このメソッドは、nonce 値を割り当てる前に、入力を BER INTEGER エンコードに正規化します。 正規化された値は、 メソッドによって GetNonce() 返されます。