Руководство по установке#

Адаптер предназначен для автоматизации информационного взаимодействия между информационными системами ведомства и многофункциональными центрами (МФЦ) через единую шину СМЭВ 3. Основной задачей является гарантированный прием заявлений на предоставление государственных и муниципальных услуг, поданных гражданами в МФЦ.

Подключение к формам-концентраторам#

Перед установкой требуется получить доступ к виду сведений (ВС).

Подключение выполняется в порядке, указанном в руководстве.

Если на проекте подключение к СМЭВ 3 не выполнялось, то нужно это сделать.

Получение в ЛК УВ доступа к ВС в тестовой и продуктивной среде в качестве инициатора#

Примечание

Если ранее на проекте был получен доступ для интеграции с ЕПГУ, повторно получать доступ к виду сведений не нужно.

В личном кабинете участника взаимодействия (ЛК УВ) необходимо получить доступ к виду сведений (ВС) «Универсальный вид сведений для приема событий электронного заявления на портале государственных услуг (функций)».

Доступ необходимо получить сначала в тестовой среде, а затем в продуктивной.

../../../_images/event_service10.png
  1. Выберите версию, по которой будете тестировать:

../../../_images/event_service11.png
  1. Выберите роль. Роль для Межведа всегда будет инициатор, а для услуг – ответчик.

../../../_images/event_service12.png
  1. Подтвердите получение доступа:

../../../_images/event_service13.png
  1. Дождитесь сообщения:

../../../_images/event_service14.png
  1. Затем в доступах системы выполните сортировку по дате и найдите ВС, к которому был получен доступ в тестовой среде. Доступ в тестовой среде дается сразу после подтверждения. У ВС будет зеленая метка «Доступ в ТСМЭВ3 получен».

../../../_images/event_service15.png
  1. Аналогичным образом выполните подключение ВС в продуктивной среде.

  2. После получения доступа к ВС проведите тестирование ВС при помощи утилиты SmevMezhvedTestContour:

    • Распакуйте архив SmevMezhvedTestContour.zip в каталог /home/GEMS/SmevMezhvedTestContour.

    • В файле appsettings.json в теге Enabled установите значение true для вида сведений EventService. Если проверку в тестовом контуре нужно выполнить для одного ВС, то true нужно установить только для него.

    ../../../_images/event_service.png
    • Запустите SmevTestContourTestingApp:

    dotnet Gems.Smev.TestContourCheckingApplication.dll
    

Результаты тестирования нужно проверить в ЛК УВ, нажав «Посмотреть статус» на выбранном ВС. После успешного прохождения тестирования все этапы будут отмечены зеленым.

../../../_images/event_service16.png

У ВС появится зеленая метка «Доступ в ПСМЭВ3 получен».

../../../_images/event_service17.png

Получение в ЛК УВ доступа к ВС в тестовой и продуктивной среде в качестве ответчика для услуг ЕПГУ#

Подсказка

Данный процесс необходимо будет пройти по каждой услуге по мере появления информации от заказчика.

В ЛК УВ получите доступ к ВС для оказания необходимой услуги.

Доступ необходимо получить сначала в тестовой среде, а затем в продуктивной.

../../../_images/event_service18.png
  1. Введите наименование и выберите ВС, к которому необходимо получить доступ:

../../../_images/event_service19.png
  1. Выберите версию, по которой будете тестировать:

../../../_images/event_service20.png
  1. Выберите роль, с которой получаете доступ. Роль для Межведа всегда будет инициатор, а для услуг – ответчик.

../../../_images/event_service21.png
  1. Укажите код маршрутизации. Рекомендуем использовать значение ОКТМО региона. Нажмите «Продолжить».

../../../_images/event_service22.png
  1. Подтвердите получение доступа:

../../../_images/event_service23.png
  1. Дождитесь сообщения:

../../../_images/event_service24.png

Полученный доступ к указанному ВС будет отображаться в поиске на главной странице с той версией, на которую был выполнен запрос. Доступ в тестовой среде дается сразу после подтверждения. У ВС будет метка «Доступ в ТСМЭВ3 получен».

../../../_images/event_service25.png
  1. Аналогичным образом выполните подключение ВС по услуге в продуктивной среде.

  2. После начала процедуры подтверждения технической готовности нажмите «Получить статус»:

../../../_images/event_service26.png

У ВС появится статус доступа «В процессе тестирования»:

../../../_images/event_service27.png
  1. Перейдите в статус доступа и нажмите кнопку «Отправить запрос»:

../../../_images/event_service28.png
  1. Дождитесь сообщения:

../../../_images/event_service29.png
  1. После получения доступа к ВС проведите тестирование ВС при помощи утилиты SmevProducerEmulator:

    • На сервер положите утилиту SmevProducerEmulator.

    • В файле appsettings.json укажите номер сертификата и пароль:

    ../../../_images/event_service9.png
    • Перейдите в папку с утилитой и запустите ее командой:

    dotnet Gems.Smev.ProducerEmulator.dll
    
    • По окончании работы утилиты перейдите в каталог \ProducerEmulator\EnvelopeFiles\<дата запуска утилиты>. В нем появится каталог с наименованием, соответствующим номеру, указанному в заявке – службой эксплуатации СМЭВ был направлен запрос: a324b918-f12c-11eb-a91a-c0b88376c776.

    • Проверьте, что в каталоге присутствуют 6 файлов:

      • AckRequest.xml

      • AckResponse.xml

      • GetRequestRequest.xml

      • GetRequestResponse.xml

      • SendResponseRequest.xml

      • SendResponseResponse.xml

Результаты тестирования нужно проверить в ЛК УВ, нажав «Посмотреть статус» на выбранном ВС. После успешного прохождения тестирования все этапы будут отмечены зеленым.

У ВС появится метка «Доступ в ПСМЭВ получен».

../../../_images/event_service30.png

Важно

Не удаляйте утилиту и полученные результаты с сервера. Часто информация от заказчиков поступает позднее, чем СМЭВ направляет запросы для прохождения тестирования. Утилита в процессе работы получает все запросы и повторно их получить не будет возможности.

Установка#

Чтобы установить модуль, обеспечивающий прием заявлений из МФЦ:

  1. Убедитесь в наличии модуля Module.Onyx. Модуль уже присутствует, если вы получили пакет с дистрибутивами для проекта.

  2. Установите компонент БД Common.Onyx.

  3. Укажите следующие переменные в файле vars.yml:

Название переменной

Значение по умолчанию

Описание переменной

vars.yml:

gvONYX_INSTALL_DIR

/opt/Onyx

Директория, в которую будет установлен сервис

gvONYX_PORT

Порт, на котором будет развернут сервис

gvSMEV_URL

http://172.20.3.12:7500/smev/v1.1/ws?wsdl

Адрес единого сервиса СМЭВ v1.1

gvSMEV_URL_2

http://172.20.3.12:7500/smev/v1.2/ws?wsdl

Адрес единого сервиса СМЭВ v1.2

gvSMEV_FILESTORAGE_URL

Адрес файлового хранилища СМЭВ. Актуальные адреса для обращений к СМЭВ3 можно взять на сайте Единой системы контекстных справок

gvSMEV_FILESTORAGE_USERNAME

username

Пользователь файлового хранилища СМЭВ. Для S3 необходимо использовать неанонимного пользователя

gvSMEV_FILESTORAGE_PASSWORD

password

Пароль от файлового хранилища СМЭВ

gvSMEV_FILESTORAGE_BUCKET

Наименование bucket в СМЭВе. Используется единый bucket attachment. Данная переменная обязательна при использовании файлового хранилища типа S3, для Ftp не является обязательной

gvSMEV_FILESTORAGE_TYPE

Ftp

Тип файлового хранилища. Может быть Ftp или S3

  1. Обновите Geometa с модулем Module.Onyx с помощью тега install_ias и Onyx с помощью тега install_onyx.

  2. Заполните настройки сервиса в Consul.

  3. Заполните настройки СМЭВ.

    6.1. Если на проекте есть установленный сервис запросов СМЭВ, убедитесь, что в настройках СМЭВ в Конфигураторе заполнена информация:

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

    • серийный номер сертификата X.XXX;

    • пароль контейнера закрытого ключа сертификата.

    6.2. Если СМЭВ на проекте отсутствует, необходимо установить компонент БД Common.SMEV и заполнить настройки.

  4. Запросите код ведомства, коды услуг и коды целей. Коды целей указаны в ФРГУ и запрашиваются у заказчика для настройки приложения. Коды прописываются в настройках услуг (таблица onyx.global_settings).

  5. Заполните настройки услуг:

    8.1. Создайте в таблице onyx.global_settings запись с id = Onyx.

    8.2. Заполните столбец [value] уникальными настройками для каждого проекта.

  6. Перезапустите приложение из каталога (по умолчанию /opt/Onyx), в который установлен Onyx, командой:

docker-compose down && docker-compose up -d