МенеджерКриптографии.ПроверитьПодписьАсинх (CryptoManager.VerifySignatureAsync)

МенеджерКриптографии (CryptoManager)

ПроверитьПодписьАсинх (VerifySignatureAsync)

Доступен, начиная с версии 8.3.18.

Вариант синтаксиса: Проверка подписи заданных данных или проверка отсоединенной подписи

Синтаксис:

ПроверитьПодписьАсинх(<ИсходныеДанные>, <Подпись>, <ПроверятьДополнительныеАтрибуты>)

Параметры:

<ИсходныеДанные> (обязательный)

Тип: Строка, ДвоичныеДанные, Поток, ПотокВПамяти, ФайловыйПоток.
Исходные данные для проверки.
Данные могут размещаться в файле (в этом случае указывается имя файла) или представлены как ДвоичныеДанные, Поток, ПотокВПамяти или ФайловыйПоток.

<Подпись> (обязательный)

Тип: Строка, ДвоичныеДанные, Поток, ПотокВПамяти, ФайловыйПоток.
Подпись или подписи для проверки.
Исходные данные могут быть размещены в файле (в этом случае указывается имя файла) или представлены как ДвоичныеДанные, Поток, ПотокВПамяти или ФайловыйПоток.

<ПроверятьДополнительныеАтрибуты> (необязательный)

Тип: Булево.
Параметр устанавливает правила проверки подписи:

Истина (по умолчанию) – выполняется проверка подписи и всех неподписанных атрибутов, которые позволяет проверить данный тип подписи. Например, на документе установлена подпись CAdES-T, в таком случае выполняется следующая проверка:
- Проверяется корректность подписи.
- Выполняется проверка всех используемых сертификатов в подписи (по цепочкам из данных подписи и хранилищу сертификатов модуля криптографии/ОС).
- Выполняется проверка всех неподписанных атрибутов:
  - Проверка доверенной метки времени.
  - Действительность метки TSP/OCSP (если они содержатся в подписи).
Ложь – выполняется только проверка подписи.

Например, на документе установлена подпись CAdES-T, в таком случае выполнится только проверка подписи. Как будто указана только CAdES-BES. Этот флаг необходим для поддержки обратной совместимости для новых форматов. Также этот флаг позволит самостоятельно выполнять проверку неподписанных атрибутов.
Значение по умолчанию: Истина.

Описание варианта метода:

Выполняет проверку отсоединенной электронной подписи в формате PKCS#7. В случае неверной подписи или другой ошибки, будет вызвано исключение.

Вариант синтаксиса: Проверка присоединенной подписи

Синтаксис:

ПроверитьПодписьАсинх(<Подпись>, <ПроверятьДополнительныеАтрибуты>)

Параметры:

<Подпись> (обязательный)

Тип: Строка, ДвоичныеДанные, Поток, ПотокВПамяти, ФайловыйПоток.
Электронная подпись для проверки.
Если параметр типа Строка, то обозначает имя файла с подписью.
Если параметр типа ДвоичныеДанные или Поток, ПотокВПамяти, ФайловыйПоток, то он задает данные подписи.

<ПроверятьДополнительныеАтрибуты> (необязательный)

Тип: Булево.
Параметр устанавливает правила проверки подписи:

Истина (по умолчанию) – выполняется проверка подписи и всех неподписанных атрибутов, которые позволяет проверить данный тип подписи. Например, на документе установлена подпись CAdES-T, в таком случае выполняется следующая проверка:
- Проверяется корректность подписи.
- Выполняется проверка всех используемых сертификатов в подписи (по цепочкам из данных подписи и хранилищу сертификатов модуля криптографии/ОС).
- Выполняется проверка всех неподписанных атрибутов:
  - Проверка доверенной метки времени.
  - Действительность метки TSP/OCSP (если они содержатся в подписи).
Ложь – выполняется только проверка подписи.

Описание варианта метода:

Выполняет проверку присоединенной электронной подписи в формате PKCS#7. В случае неверной подписи или другой ошибки, будет вызвано исключение.

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

Тип: Обещание.
Результат выполнения обещания - объект СертификатКриптографии, с помощью которого была произведена подпись (если сертификат включен в данные подписи).

Описание:

Асинхронная функция. Проверяет действительность подписи.
Проверяет все имеющиеся подписи.
Формат исходных данных - CMS (базируется на PKCS#7).

Доступность:

Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

См. также:

МенеджерКриптографии, метод НачатьПроверкуПодписи
МенеджерКриптографии, метод ПроверитьПодпись

Использование в версии:

Доступен, начиная с версии 8.3.18.

Методическая информация