Настройка и установка СМЭВ‑адаптера 3

Настройка и установка СМЭВ‑адаптера: пошаговая инструкция

Предварительные требования

Перед установкой необходимо подготовить инфраструктуру:

• установить Java‑машину (версия согласно документации СМЭВ);

• развернуть криптопровайдер (сертифицированный, поддерживающий ГОСТ‑алгоритмы);

• настроить СУБД (PostgreSQL/Oracle/MS SQL в соответствии с требованиями);

• обеспечить защищённый канал связи с инфраструктурой электронного правительства.

Шаг 1. Загрузка дистрибутива

1. Получите дистрибутив СМЭВ‑адаптера через официальный канал (личный кабинет участника взаимодействия или доверенный репозиторий).

2. Сохраните архив на целевой сервер.

Шаг 2. Установка адаптера

1. Распакуйте архив дистрибутива.

2. Запустите установочный скрипт/файл (в зависимости от ОС):

   • для Linux — ./install.sh;

   • для Windows — setup.exe.

3. Следуйте подсказкам инсталлятора:

   • укажите путь установки;

   • выберите компоненты (основной адаптер, модули шифрования, логирования);

   • задайте учётные данные администратора.

Шаг 3. Базовая настройка через веб‑интерфейс

1. Откройте браузер и перейдите по адресу:
   http://<IP‑адрес_сервера>:8085
   (порт по умолчанию — 8085).

2. Авторизуйтесь с учётными данными администратора (из документации к адаптеру).

3. Выберите среду СМЭВ:

   • в выпадающем списке — «СМЭВ 3.0 Продуктивная среда» (или «Тестовая среда» для отладки);

   • нажмите «Применить и сохранить» → подтвердите выбор.

4. Проверьте адрес личного кабинета участника взаимодействия (ЛК УВ):

   • перейдите в «Показать расширенные настройки» → «10. ЛК УВ»;

   • в поле «10.1 Адрес» укажите:
     https://lkuv.gosuslugi.ru/catalog/adp/mng;

   • сохраните изменения.

Шаг 4. Регистрация информационной системы

1. В разделе «Информационные системы» нажмите «Добавить».

2. Введите мнемонику вашей ИС (уникальный идентификатор).

3. Укажите:

   • наименование системы;

   • версию ПО;

   • контактные данные администратора.

4. Сохраните запись.

Шаг 5. Настройка электронной подписи (ЭЦП)

1. Перейдите в раздел «2. Подпись».

2. Загрузите сертификат ЭП (формат .cer или .p7b).

3. Укажите:

   • путь к закрытому ключу;

   • пароль контейнера;

   • алгоритм шифрования (ГОСТ Р 34.10‑2012).

4. Нажмите «Проверить подпись» — система выдаст уведомление об успешном тестировании.

Шаг 6. Настройка FTP‑доступа

1. Перейдите в раздел «7. Вложения».

2. Укажите параметры FTP‑сервера:

   • хост (IP/домен);

   • порт (по умолчанию 21);

   • логин и пароль;

   • путь к директории для обмена.

3. Сохраните настройки.

Шаг 7. Регистрация вида сведений (ВС)

1. В главном меню выберите «Виды сведений» → «+ Добавить».

2. Загрузите архив с описанием ВС (получен из ЛК УВ):

   • файл с требованиями к форматам (Требования_к_форматам.zip);

   • эталонные сообщения (etalons.zip).

   • не распаковывайте архивы — загружайте в исходном виде.

3. После загрузки:

   • задайте удобное наименование ВС;

   • перейдите в «Настройки сообщений» → «Добавить»;

   • выберите корневой элемент (например, FNSVipipadrRequest для выписок из ЕГРИП);

   • заполните поля эталонного запроса (пример: 00000000-0000-0000-0000-000000000006).

Шаг 8. Тестирование взаимодействия

1. Отправьте эталонный запрос:

   • в разделе «Исходящие взаимодействия» нажмите «Создать»;

   • выберите зарегистрированный ВС;

   • заполните поля по шаблону;

   • отправьте сообщение.

2. Проверьте ответ:

   • дождитесь уведомления о входящем сообщении;

   • откройте «Новые уведомления» → «Открыть»;

   • убедитесь, что код обработки соответствует эталонному (например, 54).

Шаг 9. Мониторинг и логирование

1. Настройте сбор логов:

   • укажите путь к директории для хранения;

   • задайте период ротации (например, 7 дней).

2. Включите аудит действий пользователей:

   • фиксация входов в систему;

   • регистрация изменений настроек;

   • отслеживание отправки/приёма сообщений.

Типичные ошибки и их устранение

• «Не удаётся подключиться к ЛК УВ» — проверьте адрес в разделе «10. ЛК УВ» и доступность сети.

• «Ошибка подписи» — перепроверьте сертификат и пароль контейнера.

• «FTP‑соединение отклонено» — убедитесь в корректности логина/пароля и открытых портах.

• «ВС не зарегистрирован» — перезагрузите архив с описанием и повторите шаг 7.

Завершение настройки

После успешного тестирования:

1. Переведите адаптер в режим «Продуктивная среда» (если использовался тестовый).

2. Сообщите оператору СМЭВ о готовности к обмену данными.

3. Проведите пилотный обмен с партнёрами по взаимодействию.

Важно! Сохраните резервную копию настроек и сертификатов. Регулярно обновляйте ПО адаптера согласно релизам СМЭВ.