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

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

Функционал помогает:

1. Зарегистрировать тестовую ИС для обменов;
2. Получить для нее сгенерированный тестовый сертификат;
3. Скачать установочный пакет Агента ПОДД с предустановленными настройками;
4. Получение доступа к тестовым РЗ без необходимости согласования со стороны Поставщика;
5. Осуществить тестирование своей ИС со стороны Потребителя.

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

Внимание! Сейчас доступно формирование пакета Быстрого старта только для роли агента Потребитель.

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

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

1. В ЛК УВ выбираем плашку Быстрый старт СМЭВ4 на вкладке СМЭВ4 (Рисунок 1):

Рисунок 1 – Плашка Быстрого старта на вкладке СМЭВ4 ЛК УВ.

2. Читаем порядок действий и нажимаем Начать (Рисунок 2):

Рисунок 2 - Первый шаг Быстрого старта.

3. Быстрый старт доступен для всех сред.

Выбираем подходящую среду (Рисунок 3):



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

4. Дальше можно выбрать существующую систему или создать новую (Рисунок 4).

Рисунок 4 – Выбор системы.

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

5. Следующим шагом выбирается роль (Рисунок 5):

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

6. Далее для роли Потребитель можно предоставить доступ к рег. запросу, а для роли Поставщик и потребитель добавить связь с витриной. Можно это сделать здесь из Быстрого старта либо заранее, согласно статье Получение доступа к регламентированному запросу. Так же не страшно, если роль, доступ или связь с витриной будут добавлены позже, уже после установки агента.

Уже на этом шаге мы можем скачать установочный пакет (Рисунок 6):

Рисунок 6 – Скачать установочный пакет.

Описание пакета «Быстрый старт»

Название пакета	Состав			Описание	Примечание
Установочный пакет	application.yml			Конфигурация Агента ПОДД	Файл содержит настройки Агента ПОДД ( идентификатор Агента, подключение к ЦОД, Pulsar, путь к файлу cp_ca_store, имя и пароль ключа CryptoPro и др.)
	configure			Конфигурация установочного пакета	Сдержит URL для загрузки docker-image и название docker-image
	diag.sh			Создание информационного пакета для диагностики проблем разработчиками
	install.sh			Запуск установки Агента ПОДД
	log.sh			Получение лог-файлов работы Агента ПОДД
	run.sh			Запуск Агента ПОДД
	stop.sh			Остановка Агента ПОДД
Пакет с тестовыми ключами и сертификатами	certs			Папка с сертификатами
		/XXXXXXXX.cer		Сертификат CryptoPro
		/cp_ca_store		Хранилище доверенных сертификатов в формате CryptoPro
	keys			Папка с ключами CryptoPro
		/XXXXXXXX.000	/header.key /masks.key /masks.key /masks2.key /name.key /primary.key /primary2.key	Ключи CryptoPro

Если сертификат сгенерирован не в ЛК УВ, то не будет пакетов keys и certs. Файл certs можно найти тут.
Их необходимо будет подложить самим. А также дозаполнить конфиг-файл application.yml, указав алиас и пароль контейнера сертификата и пароль к cp_ca_store.

Если сертификат был сгенерирован в ЛК УВ, то пакет «Быстрый старт» полностью готов к установке.

Установка сформированного пакета

1. Подготовить среду для развертывания с ОС CentOS 7.9.

Минимальные требования к вычислительным ресурсам сервера

№	Характеристики	Значение
1	СPU	4
2	RAM	8 Gb
3	HDD	20 Gb

2. Установить и запустить docker

curl -fsSL https://get.docker.com/ | sh systemctl start docker

3. Распаковать установочный пакет в среде, где требуется развернуть Агента СМЭВ4.

Примечание: Если есть лицензии CryptoPro, то можно их скопировать в директорию licenses. Если директория licenses отсутствует, необходимо ее создать. Если лицензии отсутствуют, будут использованы ознакомительные версии лицензий с ограниченным сроком действия, в этом случае никаких действий не требуется. 

4. Перейти в каталог, в который был разархивирован полученный установочный пакет (например, test), для этого следует выполнить команду:

cd /user/test

где /user/test – директория, в которой лежит установочный пакет.

5. Выполнить команду, которая сделает файлы .sh исполняемыми:

chmod +x *.sh

6. Выполнить скрипт установки:

./install.sh

При корректной установке docker-image в Docker отобразится сообщение:

IMAGE SUCSESSFULLY INSTALLED

7. Выполнить скрипт запуска агента:

./run.sh

В случае успешного запуска отобразится сообщение:
Application started. Container name: Available ports: 8183 (jdbc), 8192 (REST + driver download), 8171 (API gateway)"

8. Проверить успешность установки и запуска можно, выполнив запрос к ядру СМЭВ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"     ] ] }

О возможных ошибках и способах их устранения читайте в статье Типовые ошибки Агента СМЭВ4.