Rfc3161TimestampRequest.CreateFromHash Метод

Определение

Пространство имен:

System.Security.Cryptography.Pkcs

Сборка:

System.Security.Cryptography.Pkcs.dll

Пакет:

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

Перегрузки

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

Идентификатор объекта для политики меток времени, которую должен использовать центр меток времени, или значение null, если нет предпочитаемых значений.

nonce

Nullable<ReadOnlyMemory<Byte>>

Необязательное значение, используемое для однозначного сопоставления запроса с ответом, или значение null, если ключ nonce не должен включаться в запрос.

requestSignerCertificates

Boolean

Значение true указывает, что центр меток времени должен содержать сертификат для подписи в выданном маркере метки времени. В противном случае — значение false.

extensions

X509ExtensionCollection

Необязательная коллекция расширений, которую следует включить в запрос.

Возвращаемое значение

Rfc3161TimestampRequest

Класс Rfc3161TimestampRequest, представляющий выбранные значения.

Исключения

CryptographicException

hashAlgorithm — неизвестный алгоритм хэширования.

Комментарии

Этот метод использует hashAlgorithm параметр для определения идентификатора объекта (OID) для включения в запрос метки времени. При создании запроса для метки времени на основе хэш-алгоритма, который не поддерживается этим методом, используйте перегрузку CreateFromHash(ReadOnlyMemory<Byte>, Oid, Oid, Nullable<ReadOnlyMemory<Byte>>, Boolean, X509ExtensionCollection) .

Значение nonce в этом методе обрабатывается как целое число без знака с большим байтом. Этот метод нормализует входные данные в кодировке BER INTEGER перед назначением значения nonce. Нормализованное значение возвращается методом 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.

requestedPolicyId

Oid

Идентификатор объекта, для политики меток времени, которую должен использовать центр меток времени, или значение null, если нет предпочитаемых значений.

nonce

Nullable<ReadOnlyMemory<Byte>>

Необязательный элемент nonce (однократно используемое число), который обеспечивает уникальную идентификацию этого запроса, чтобы связать его с ответом. Значение интерпретируется как целое число без знака с обратным порядком байтов. Оно может быть нормализовано в формат кодирования.

requestSignerCertificates

Boolean

Значение true указывает, что центр меток времени должен содержать сертификат для подписи в выданном маркере метки времени. В противном случае — значение false.

extensions

X509ExtensionCollection

Необязательная коллекция расширений, которую следует включить в запрос.

Возвращаемое значение

Rfc3161TimestampRequest

Класс Rfc3161TimestampRequest, представляющий выбранные значения.

Исключения

ArgumentNullException

hashAlgorithmId имеет значение null.

CryptographicException

hashAlgorithmId.Value не является допустимым идентификатором OID.

Комментарии

Значение nonce в этом методе обрабатывается как целое число без знака с большим байтом. Этот метод нормализует входные данные в кодировке BER INTEGER перед назначением значения nonce. Нормализованное значение возвращается методом GetNonce() .