Настройка проверки подписи пакета документов

КриптоПро SVS поддерживает возможность проверки подписи пакета документов как при помощи собственного веб-интерфейса, так и при помощи программного интерфейса.

Пакетная проверка подписи не требует отдельных настроек и работает по умолчанию после развертывания и настройки КриптоПро SVS. Тем не менее, необходимо учитывать следующие настройки, которые могут влиять на работу пакетной проверки подписи.

  1. Регистрация расширений файлов подписи, соответствующих формату подписи.
  2. Ограничения максимального размера пакета документов.
  3. Шаблон отчета.

Регистрация расширений файлов подписи

Данная настройка позволяет КриптоПро SVS определять формат подписи на основании расширений загруженных файлов. При пакетной проверке подписи необходимо соблюдать следующие правила:

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

Пример регистрации распространенных расширений для файлов подписи формата CMS:

Set-VsSignatureFormat -Format CMS -IsEnabled 1 -Extensions sig, p7s, sign, *
Restart-VsInstance

При необходимости список расширений можно увеличить.

Настройка ограничения размера пакета документов

По умолчанию КриптоПро SVS обрабатывает запросы размером не более 5Mb. Для пакетной проверки подписи необходимо увеличить допустимый максимальный размер запроса.

Пример команды для увеличения размера запроса до ~60Mb:

Set-VsEndpointGlobalSettings -DisplayName Verify -MaxMessageSize 60000000
Restart-VsInstance

При необходимости ограничения могут быть увеличены.

Настройка шаблона отчета

Шаблон отчета представляет собой пару следующих документов:

  • Шаблон-контейнер - представляет собой Word-документ (.docx).
  • Шаблон результатов проверки - представляет собой XSL-преобразование (XSL Transform, .XSLT).

По умолчанию КриптоПро SVS использует встроенные в него шаблоны отчетов. В случае если требуется изменить данные шаблоны, следует выполнить следующие действия.

  1. Скопировать образцы шаблонов из директории C:\Program Files\Crypto Pro\DSS\VerificationService\templates для ОС Windows или директории /opt/cprosvs/svsrv/templates/ для *nix-систем в другую удобную директорию за пределами директории, куда установлен КриптоПро SVS. Если скопировать образцы в папки КриптоПро SVS или изменить в данной папке без перемещения, изменения могут быть утеряны при обновлении КриптоПро SVS.
  2. Отредактировать (при необходимости) файлы шаблонов.
  3. Зарегистрировать новые шаблоны отчетов в КриптоПро SVS (требуется перезапуск экземпляра сервиса): 
Set-VsProperties -WordFilePath "<path>\packagereporttemplate.docx"
Set-VsProperties -XsltFilePath "<path>\packagereporttemplate.xslt"
Restart-VsInstance

Формат шаблонов отчетов

Шаблон-контейнер определяет фиксированные части отчета: колонтитул, заголовки, нумерацию страниц и т.п.

Единственное требование к шаблону-контейнеру – наличие метки для размещения результатов проверки пакета документов. Метка представляет собой текст следующего вида: 

<data>

При формировании отчета метка будет замещена результатом проверки пакета документов.

Шаблон результатов проверки представляет собой XSL-преобразование (XSL Transform, XSLT). Результатом применения XSLT должен быть HTML-документ.

В случае если образцы шаблонов отчетов были утеряны, их можно загрузить по следующим ссылкам: