search string side menu

Настройки администратора для внедрения КЭДО > Использовать в КЭДО решение «Интеграция с Госключом» / Модуль решения «Интеграция с Госключом»

Модуль решения «Интеграция с Госключом»

После установки бизнес-решения Интеграция с Госключом в разделе Админитрирование > Модули добавится одноимённый модуль. Он содержит:

  • преднастроенные процессы:
    • Отправить документы на подписание в Госключ — запускается, если в задаче подписания документа выбрать Госключ как провайдера электронной подписи и нажать кнопку Отправить в Госключ;
    • Обновление подписи api-ключа — отправляет запрос в сервис rutokensign и обновляет подпись к API-ключу. Запускается по расписанию ежедневно в 23:00 по времени компании, т. к. в Госуслугах есть требование к сроку этой подписи не более 24 часов. Также процесс можно запустить вручную в настройках модуля;
  • методы API:
    • Сформировать zip-файл для Госключа — формирует и отправляет .zip-архив файлов для подписания в сервис node-jszip;
    • Обновить подпись ключа — отправляет запрос на подписание API-ключа, вызывается из процесса Обновление подписи api-ключа;
    • Доступность модуля — обеспечивает корректную работу интеграции в виджетах, например в виджете Массовое подписание;
    • Получить настройки модуля — отправляет данные полей Срок подписания документов по умолчанию, час и Интервал проверки статуса подписания, сек из настроек модуля, а также информацию о запущенных процессах;
    • Получить список процессов — используется в процессе модуля Отправить документы на подписание в Госключ, а также позволяет получить информацию о запущенных процессах в виджетах, например в виджете Массовое подписание.

Настроить модуль интеграции с Госключом

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

  1. Инструменты администратора.
  2. Настройки сервисов.
  3. Настройки авторизации.
  4. Настройки интеграции.
  5. Настройки подписания.

Инструменты администратора

В этом блоке при первичной настройке модуля нужно обновить подпись к API-ключу. Также настройки блока предназначены для решения нестандартных ситуаций:

kedo-goskey-module-settings-1

  • Обновить идентификатор сесси — если идентификатор утерян в результате ошибки сервиса, вы можете вручную задать значение параметра session_id с типом Число (целое) для процесса подписания в сервисе rutokensign. Полученное значение вставьте в поле Идентификатор сессии;
  • Обнулить информацию о процессах — служебная опция. Позволяет удалить данные о запущенных процессах подписания в Госключе, которые хранятся в Namespace.storage в формате .json в свойстве processes_json;
  • Обновить подпись api-ключа — позволяет вручную запустить процесс обновления подписи к API-ключу. Такой процесс по умолчанию запускается ежедневно в 23:00 с учётом часового пояса, настроенного для компании. При первичной настройке модуля выполните вручную обновление подписи к API-ключу.

Настройки сервисов

Здесь настройте интеграцию с сервисами решения, установленными на сервер.

Обратите внимание, поля с паролями к сертификату электронной подписи и к Рутокену в этом блоке доступны только сотруднику, назначенному на роль Ответственный за Госключ:

kedo-goskey-module-settings-2

  • Адрес сервера для использования Rutoken — введите адрес сервера, на котором установлены сервисы rutokensign и signimprover. Затем нажмите кнопку Проверить подключение и дождитесь уведомления о результате.
  • Адрес сервера для архивации документов — если вы используете поставку SaaS, укажите в этом поле адрес сервера, на котором установлен сервис node-jszip. Затем нажмите кнопку Проверить подключение и дождитесь уведомления о результате. Для поставки On-Premises заполнять поле не нужно;
  • Рутокен — чтобы отобразить доступные варианты в этом поле, нажмите Обновить список токенов. Затем выберите токен, подключённый к серверу, на котором установлены сервисы rutokensign и signimprover.

Следующие поля доступны для просмотра и редактирования только сотруднику, назначенному на роль Ответственный за Госключ;

  • Пароль к контейнеру — введите пароль к сертификату, который хранится в устройстве Рутокена;
  • Пароль к Рутокену — укажите пароль к устройству Рутокена.

Настройки авторизации

В этом блоке выполните настройки для использования методов Web API и полученного API-ключа:

kedo-goskey-module-settings-3

  • Токен для api-методов* — введите токен для использования внутреннего WebAPI;
  • Api-ключ (документ)* — выберите элемент приложения API-ключи, созданный ответсвенным за Госключ после получения API-ключа;
  • Api-ключ (строка)* — вставьте строковое значение полученного API-ключа.

Настройки интеграции

В этом блоке заполните поля для интеграции с сервером Госключа:

kedo-goskey-module-settings-4

  • Сервер Госключа* — выберите Тестовый или Боевой;
  • Мнемоника ИС* — введите значение мнемоники вашей системы на странице портала Госуслуг;
  • Краткое наименование организации* — введите значение, указанное на странице портала Госуслуг;
  • Регион организации* — укажите регион регистрации организации.

Настройки подписания

Здесь укажите настройки для подписания документов:

kedo-goskey-module-settings-5

  • Срок подписания документов по умолчанию, час — задайте максимально возможный срок в часах для подписания документов сотрудниками в приложении. Время рассчитывается с момента поступления уведомления в приложении о подписании документов и не может превышать 24 часа. Опция применится, если не настроен другой срок подписания в качестве входного параметра для процесса Отправить документы на подписание в Госключ;
  • Интервал проверки статуса подписания, сек — задайте период в секундах для проверки подписания документов в Госключе. Используется в виджетах подписания, например, в виджете Массовое подписание.

Сохраните настройки модуля. После этого при подписании документов пользователь может выбрать Госключ как провайдера электронной подписи.

kedo-goskey-responsible-actions.html kedo-solution.html