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

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

ПроверитьПодпись (VerifySignature)

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

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

Синтаксис:

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

Параметры:

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

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

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

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

<Сертификат> (необязательный)

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

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

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

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

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

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

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

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

Синтаксис:

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

Параметры:

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

<Сертификат> (необязательный)

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

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

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

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

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

Описание:

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

Для работы метода на веб-клиенте необходимо предварительно подключить расширение работы с криптографией. В веб-клиенте метод поддерживается только в браузере Internet Explorer, если в конфигурации используется режим синхронных вызовов расширений платформы и внешних компонент.

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

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

Примечание:

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

См. также:

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

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

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

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