Интеграция с Финцерт

Применимость инструкции требует проверки. Перед использованием подтвердите совместимость с установленной версией модуля, актуальными форматами обмена ФинЦЕРТ и окружением банка. Перенос статьи в общую документацию не означает технической актуализации всех её шагов.

Введение

Система Accelera может автоматически обрабатывать файлы фидов с реквизитами получателей, распространяемые ФинЦЕРТ ЦБ РФ в соответствии с частью 5 статьи 27 Федерального закона от 27 июня 2011 года "О национальной платежной системе" 161-ФЗ.

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

Системные требования

1 CPU, 2 GB RAM, а также ≥ 20 Gb дискового пространства.
Модуль распространяется в виде архива с установочными скриптами и исполняемого файла. Для работы модуля необходим 64-битный дистрибутив Linux с минимальной версией ядра 3.10, рекомендуется Ubuntu 16.04 / 18.04 / 19.10 Debian 9 / 10 CentOS 7 / 8 RHEL / Astra Linux.

Сетевой доступ к БД PostgreSQL, версии 15 и выше.

Также финансовая организация самостоятельно настраивает TLS туннель (тестовая среда - доступ к https://zoe-api.fincert.cbr.ru, продуктовая - https://api.fincert.cbr.ru, или другой адрес, если используется туннель или прокси-сервер) для работы с ФинЦерт и их сертификатами (root, api, TLS-клиента).

Шаги установки

Предварительно создайте в PostgreSQL базу данных и схему, куда модуль будет складывать данные. Это может быть аналитической схемой, которой пользуется сама система Accelera.

0. Проверьте соединение с fincert

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

Проще всего это сделать с помощью curl:

curl --request POST \
  --url http://zoe-api.fincert.cbr.ru/api/v1/account/login \
  --header 'Content-Type: application/json' \
  --data '{
"login": "api-test@zoe",
"password": "Welcome_T0_ASOI!@"
}'

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

В некоторых установках КриптоПро потребуется использовать curl, который предоставляется в данной установке, а также указать идентификатор контейнера с пользовательским сертификатом (параметр —cert)

Например,

/opt/cprocsp/bin/amd/curl --request POST \
	--cert <cert_id> \
  --url http://zoe-api.fincert.cbr.ru/api/v1/account/login \
  --header 'Content-Type: application/json' \
  --data '{
"login": "api-test@zoe",
"password": "Welcome_T0_ASOI!@"
}'

В данном примере opt/cprocsp/bin/amd/ - является префиксом для команды curl и для работы модуля необходимо указать его в переменной конфигурации CURL_PREFIX.

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

Таким образом, из примера выше правильный параметр CURL_PREFIX будет выглядеть как sudo opt/cprocsp/bin/amd/. Это необходимо только в ситуации, когда стандартного curl недостаточно.

1. Распаковка архива

Модуль распространяется в виде .tar.gz файла, который необходимо распаковать командой

tar -xvzf fincert_1.0.2.tar.gz

В результате появится директория accelera_fincert, в которой будут следующие файлы:

accelera_fincert - исполняемый бинарный файл модуля
config.env - файл с конфигурацией приложения. Описание свойств смотрите в п.2.
install.sh - установочный скрипт приложения
uninstall.sh - скрипт удаления и очистки системы

2. Конфигурация

В файле config.env перечислены конфигурационные свойства приложения

ANALYTICS_DB_HOST=localhost
ANALYTICS_DB_NAME=accelera
ANALYTICS_DB_PASSWORD=password
ANALYTICS_DB_PORT=5432
ANALYTICS_DB_SCHEMA=accelera
ANALYTICS_DB_USER=postgres
FINCERT_BASE_URL=http://localhost:10004/api/v1/
FINCERT_PASSWORD=Welcome_T0_ASOI!@
FINCERT_USERNAME=api-test@zoe
LOG_LEVEL=debug
TMP_FILE_DIR=/tmp/fincert
CERT_ID=123456
CERT_PASS=password
CURL_PREFIX=

Внимание! Данный файл используется только при установке приложения. Далее все настройки необходимо редактировать в /etc/accelera_fincert/config.env

Описание параметров

Параметр	Описание
ANALYTICS_DB_HOST	Хост БД PostgreSQL.
ANALYTICS_DB_NAME	Имя БД PostgreSQL.
ANALYTICS_DB_PASSWORD	Пароль БД PostgreSQL.
ANALYTICS_DB_PORT	Порт БД PostgreSQL.
ANALYTICS_DB_SCHEMA	Схема БД PostgreSQL.
ANALYTICS_DB_USER	Имя пользователя БД PostgreSQL.
FINCERT_BASE_URL	URL для подключения к fincert. Тестовая среда - доступ к https://zoe-api.fincert.cbr.ru, продуктовая - https://api.fincert.cbr.ru, или другой адрес, если используется туннель или прокси-сервер.
FINCERT_PASSWORD	Пароль пользователя Финцерт.
FINCERT_USERNAME	Имя пользователя Финцерт.
LOG_LEVEL	Уровень логирования, возможные значения - trace, debug, info, warn, error, fatal. По умолчанию - info.
TMP_FILE_DIR	Директория для хранения временных файлов. Укажите произвольную, главное, чтобы у текущего пользователя, под которым вы запускаете приложение, были права на запись в эту директорию.
CERT_ID	Идентификатор контейнера сертификата в локальном хранилище. Опционально.
CERT_PASS	Пароль (пин) контейнера сертификата. Опционально.
CURL_PREFIX	Префикс для команды curl, если необходимо (как описано в п.0). Также добавьте сюда sudo, если права необходимы.

3. Установка

Для установки запустите install.sh. Используйте sudo для правильного создания всех директорий и выдачи прав, необходимых приложению:

sudo ./install.sh

После установки модуль fincert будет сразу запущен. Убедитесь в этом командой

systemctl status accelera_fincert

Просмотреть лог приложения можно в файле /var/log/accelera_fincert/accelera_fincert.log, либо с помощью journalctl:

journalctl -u accelera_fincert

Ниже пример нормального лога при запуске модуля:

Для остановки модуля выполните команду

systemctl stop accelera_fincert

Для удаления модуля выполните команду

sudo ./uninstall.sh

Модуль будет удален из системы и все дополнительные директории будут очищены.

4. Конфигурация после запуска

После успешного запуска системы может понадобиться изменить параметры конфигурации. Файл config.env в установочной директории уже не подойдет для этой цели. После установки в качестве файла конфигурации используется /etc/accelera_fincert/config.env.

Для внесения изменений в конфигурацию модуля нужно редактировать именно этот файл.

Интеграция с Финцерт

На этой странице