Быстрый старт СМЭВ4

Чем полезен Быстрый старт?

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

Быстрый старт помогает в рамках одного пользовательского интерфейса выполнить все необходимые шаги для начала работы потребителя данных в СМЭВ4:

1. Зарегистрировать тестовую информационную систему (ИС) для обменов;

2. Сгенерировать для неё тестовый сертификат;

3. Скачать установочный пакет ПО Агент СМЭВ4 с предустановленной конфигурацией;

4. Получить доступы к тестовым регламентированным запросам (РЗ) без необходимости согласования со стороны Поставщика;

5. Осуществить тестирование своей ИС со стороны Потребителя.

Если сертификат для ИС сгенерирован в ЛК УВ (что доступно для среды разработки и тестовой среды), то на выходе вы получите полностью заполненный конфигурационный файл и полный комплект для установки агента с помощью docker.

  Важно!

Через «Быстрый старт» доступно формирование конфигурации агента СМЭВ4 только для роли Потребитель. Для формирования конфигурации для роли Поставщик можно воспользоваться образцами файлов конфигурирования соответствующих версий агента расположенных в разделе ПО для Участников СМЭВ

Рассмотрим последовательность шагов с нуля до работающего агента-потребителя СМЭВ4.

Действия в ЛК УВ

Для выполнения действий в ЛК УВ вам необходимо иметь к нему доступ.

В случае, если доступа пока нет, можно воспользоваться созданием демо-организации. Для этого авторизуйтесь в ЛК УВ со своей личной учетной записью ЕСИА под частным лицом и создайте демо-организацию.

Подробнее о создании описано в п 5.11 «Упрощенный доступ в ЛК УВ для работы в среде разработки СМЭВ» руководства пользователя ЛК УВ.

Далее в левом верхнем углу интерфейса ЛК УВ выберите созданную организацию для работы в ЛК УВ от её имени.

После успешной авторизации в ЛК УВ от имени организации, на вкладке «СМЭВ4» выберите «Быстрый старт СМЭВ4» (рисунок 1).

Рисунок 1. Быстрый старт СМЭВ4

Первое окно функционала «Быстрый старт» несёт информативный характер. Изучив информации о каждом шаге в разделах по ссылкам «подробнее», перейдите далее, нажав кнопку «Начать» (рисунок 2).

Рисунок 2. Начать «Быстрый старт»

Следующим шагом выберете среду, для которой хотите сформировать установочный пакет агента СМЭВ4. Например, тестовую среду (рисунок 3).

Рисунок 3. Выбор среды

Любое взаимодействие в СМЭВ происходит от имени информационной системы (ИС) участника взаимодействия.

ИС должна быть зарегистрирована в СМЭВ. Для каждой ИС необходимо прикрепить сертификат электронной подписи.

Если ваша ИС уже зарегистрирована в ЛК УВ, то выберете её, найдя по имени или мнемонике. Если нет, то зарегистрируйте, перейдя по ссылке «добавить новую систему» (рисунок 4).

Рисунок 4. Переход на регистрацию новой ИС

Зарегистрируйте новую ИС, согласно п. 5.1.2 «Регистрация информационной системы УВ» руководства пользователя ЛК УВ.

После регистрации ЛК УВ вернёт вас к продолжению прохождения шагов «Быстрого старта».

Далее вам предлагается выбрать роль системы в СМЭВ4 (рисунок 5).

Рисунок 5. Выбор роли системы в СМЭВ4

Если ваша система уже была зарегистрирована, возможно, что и роль в СМЭВ4 вы выбирали. Выберите здесь её же.

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

Если на текущем этапе известно с какой витриной ваша ИС должна быть связана в роли Поставщика или к каким РЗ должна иметь доступ в роли Потребителя, то можно эти действия сделать из интерфейса «Быстрого старта».

Примечание

Подробнее про получение доступа к РЗ в п. 5.7.5 «Получение доступов к регламентированным запросам типа SQL-запрос» руководства пользователя ЛК УВ. Подробнее про связь системы с витриной в п. 5.6.1 «Установление соответствия между витринами данных ПОДД и учетными записями ИС УВ» руководства пользователя ЛК УВ.

Но для формирования установочного пакета данный шаг необязателен. Вы можете сразу скачать установочный пакет (рисунок 6).

Скачайте установочный пакет агента СМЭВ4, выбрав соответствующее действие (рисунок 6).

Рисунок 6. Скачивание установочного пакета

Работа с ПО Агент СМЭВ4

Так же рекомендуем сразу обращаться к актуальному полноценному РА Агента соответствующей версии расположенному в разделе документация СМЭВ4.

Далее для установки агента рекомендуем двигаться согласно руководству.

После успешной установки, проверьте работу Агента СМЭВ4, его связи со СМЭВ и правильность регистрационных действий в ЛК УВ, выполнив запрос к ядру СМЭВ4:

curl -X POST -H "Accept-Version:1" -H "Content-Type: application/json" -d '{"sql": {"sql": "select 1"}}' http://localhost:8192/query --silent -m 30

Успешное выполнение выглядит так:

{

"created_at": "2022-09-13T17:00:17Z",

"query_id": "1ed33858-88bb-687d-9426-2f1dded2ee1b",

"meta": [

    {

      "name": "EXPR$0",

      "type": "INTEGER"

    }

]

"rows": [

    [

      "1"

    ]

]

}

Если на каком-либо шаге возникла ошибка, то воспользуйтесь статьёй - https://info.gosuslugi.ru/articles/Типовые_ошибки_Агента_СМЭВ4/

Если самостоятельно устранить ошибку не удалось, напишите обращение в СЦ.

С помощью функционала «Быстрый старт» легко пройти шаги в ЛК УВ и протестировать работу ПО «Агент СМЭВ4» в роли Потребитель.

Для дальнейших действий с Агентом, например, перехода на прод или настройки в конфигурации «Поставщик» рекомендуем пользоваться руководством администратора Агента. Для работы в ЛК УВ – руководством пользователя ЛК УВ.

О других вариантах установки агента можно узнать в РА Агента соответствующей версии расположенному в разделе ПО для Участников СМЭВ.