Сервис оправдательных документов
Сервис оправдательных документов (ОД) выполнен в виде веб-службы и применяется:
- для прикрепления к документам файлов (оправдательных документов) - обращение выполняется через клиентское приложение, установленное на компьютере пользователя,
- для наложения ЭП - обращение выполняется через клиентское приложение, установленное на компьютере пользователя,
- в режиме "Сохраненные отчеты" - обращение выполняется через сервер СУБД (через модуль xpks.dll), таймаут ожидания ответа сервиса ОД составляет 15 секунд, указанное время не подлежит корректировке.
Устанавливается на отдельном сервере:
-
для OC Windows - в IIS, описано в документе «Работа с оправдательными документами», размещенном на странице продукта на сайте компании.
-
для ОС Linux - в "WEB-СЕРВЕР-КС ДОКЕР", описано в документе «Руководство администратора. Установка WEB-Сервер-КС», размещенном на странице продукта на сайте компании.
При SSL-соединении соответствие сертификата проверяется только в том случае, если задана настройка "Проверять хост сертификата в https соединениях":
Если настройка включена, то доменное имя (host) сервера, на котором установлен сертификат для создания SSL/TSL соединений, должно совпадать с доменным именем получателя сертификат "Кому выдан".
Например, если сертификат сервера выдан на klon.reg.ru, то и адрес Сервиса ОД должен быть вида "https://klon.reg.ru/UploadService/" , а не "https://10.20.30.1/UploadService/" .
Версию сервиса можно определить в браузере, набрав адрес в виде:
"https://<адрес сервиса ОД до каталога>/uploadservice.ashx" .
Откроется страница сервиса с отображением его версии.
Например: "https://10.20.30.40/UploadService/uploadservice.ashx" , результат: Кейсистемс Сервис оправдательных документов, версия: 3.3.7250 .
С версии комплекса "Бюджет-СМАРТ" 19.2 требуемая версия Сервиса ОД - не ниже 3.3.
После установки сервиса необходимо убедиться, что пользователю IIS, от имени которого выполняется пул UploadService, даны полные права на папку хранилища файлов (см в файле конфигурации параметр "Storage.Location") и папку APP_DATA\ со всеми вложенными папками (независимо от места хранения файлов). Пользователь Windows по умолчанию IIS_IUSRS - это встроенная группа, используемая службами IIS (с Windows 7, ранее IIS_WPG).
В дополнительных параметрах пула приложений сервиса ОД (если у него персональный пул приложений) следует указать учетную запись LocalSystem, иначе сервис не сможет сохранять ОД из-за отсутствия прав записи на диск по любому локальному пути.
В случае наличия нескольких каналов (адресов) подключения к IIS (основного и резервного) рекомендуется применять параметр UseAppServiceHost в файле конфигурации сервиса приложений.
При необходимости анализа ошибок, выполнения отладки или проверки установки/функционирования:
Лог сервиса находится по пути ...\wwwroot\
Лог модуля ЭП находится в папке с установленным сервисом ОД ...\wwwroot\