﻿# Использовать Госключ для подписания документов в КЭДО

> [HTML Version](kedo-goskey-integration.html)

Чтобы подписывать документы в **ELMA365 КЭДО** через мобильное приложение [Госключ](https://www.gosuslugi.ru/goskey), вы можете использовать бизнес-решение **Интеграция с Госключом**. Оно позволяет сотрудникам бесплатно выпускать электронную подпись.

Если интеграция настроена и сотрудник получил сертификат электронной подписи, он может в задаче подписания документа выбрать Госключ как провайдера ЭП и нажать кнопку **Отправить в Госключ**. Затем выполняется подписание документа в мобильном приложении Госключ. Если документы подписаны, в ELMA365 задача подписания автоматически завершается.

Обратите внимание, для корректной интеграции с Госключом используется API-ключ, который нужно получить на портале Госуслуг. Он ежедневно удостоверяется со стороны компании. Для этого в решении предусмотрен процесс, который запускается автоматически. Обновление API-ключа выполняется также с помощью обезличенного сертификата юридического лица и сервисов решения.

## Состав решения «Интеграция с Госключом»

Решение содержит:

- раздел **Документы Госключа **— со служебными приложениями для обмена данными между ELMA365 и Госключом:

	- **Zip-файлы запросов** — хранит документы, отправленные в Госключ в виде **.zip**-архивов;

	- **XML-файлы** — хранит файлы формата **.xml** с описанием отправленных в Госключ документов. Эти файлы входят в состав zip-архивов и размещены в текущем приложении для их автоматического подписания;

	- **API-ключи** — содержит API-ключи в формате **.txt**. Элемент приложения создаётся вручную после получения API-ключа на портале Госуслуг;

- модуль **Интеграция с Госключом **— настраивает интеграцию с Госключом, а также обеспечивает обмен данными между сервисом и ELMA365;

- сервисы **rutokensign**, **signimprover** и **node-jszip** — устанавливаются на сервер и обеспечивают работу решения.

## Первичная настройка интеграции с Госключом

Основные действия по настройке интеграции выполняет администратор системы. Она состоит из следующих этапов:

1. Установить решение **Интеграция с Госключом**. Для этого обратитесь к вашему менеджеру ELMA365, который предоставит файл формата **.e365 **для [импорта решения](upload-solution-file.md) и файлы для установки сервисов.

2. [Установить сервисы решения](kedo-goskey-install-services.md) на сервер.

3. Назначить сотрудника на роль **Ответственный за Госключ**.

4. Получить API-ключ на портале Госуслуг и загрузить его в раздел **Документы Госключа > API-ключи**. Эти действия выполняет сотрудник, назначенный на роль [Ответственный за Госключ](kedo-goskey-responsible-actions.md).

5. [Настроить модуль](kedo-goskey-module-settings.md) **Интеграция с Госключом**.