{{define "content"}}

← все инструкции

Внешние системы

Как Bridge-and-Join-s взаимодействует с тремя главными внешними сторонами: НРД (через ИШ), команда Fansy (ETL в БД), уведомления операторам.

1. Интеграционный шлюз НРД (ИШ)

Основной канал отправки M2M-сообщений в НРД. ИШ сам подписывает пакеты ЭДО, нам криптография в этом канале не нужна.

Профили (см. Настройка → Интеграционный шлюз НРД):

ПрофильСредаКриптография
guest-gostГостевой контур (без проверок)ГОСТ Р 34.10-2012
guest-rsaГостевой контурRSA
test3-gostТестовый контур TEST3ГОСТ
test3-rsaTEST3RSA
prod-gostПродуктивныйГОСТ
prod-rsaПродуктивныйRSA

Что указать в Настройка → ИШ:

Без настроенного ИШ система работает в mock-режиме: bj-server эмитирует синтетический Decision через 3 секунды для каждой заявки. Это удобно для дев-демо и не требует подключения к НРД.

Документация по подключению: DOC/instr_podkl_stend_v3.pdf, DOC/Ссылки для доступа в тестовые контуры.pdf.

2. Команда Fansy (ETL в БД)

Команда Fansy на своей стороне настраивает ETL, который пишет в схему fansy_staging.* нашей БД. Мы переливаем оттуда в fansy.* после валидации.

Что от вас как заказчика нужно:

  1. Передать команде Fansy ссылку на каталог docs/fansy-contract/v1/ (тег fansy-contract-v1).
  2. Согласовать SLA свежести и расписание (по умолчанию — портфели за 1 минуту, остальное за 5 минут, справочники раз в сутки).
  3. Завести в БД учётную запись с ролью fansy_etl и передать команде Fansy. Пароль выдать через защищённый канал.
  4. Прописать IP/подсеть Fansy в pg_hba.conf на стороне PostgreSQL (только TLS, sslmode=verify-full).

Полный контракт: docs/fansy-contract/v1/etl-requirements.md. Семантика полей: docs/fansy-contract/v1/data-dictionary.md.

3. Уведомления операторам

В M3-M4 будет раздел Настройка → Уведомления. Архитектура — провайдеры-плагины с единым интерфейсом Notifier { Send(ctx, recipient, template, data) }:

ПровайдерНазначениеЧто вводить
SMTPE-mail (внутренний или внешний сервер)хост, порт, логин/пароль, from-адрес
Yandex Messenger (Yandex 360)Корпоративный мессенджер. У заказчика уже есть готовый бот — дотягиваем егоAPI-token, webhook, chat-id / user-id
TelegramОпционально для отдельных операторовbot-token, chat-id
Mattermost / Rocket.ChatКорпоративные мессенджеры (если используются)webhook URL
WebSocket в admin-uiМгновенный push если оператор открыл вкладкувстроено, без настроек

Логика маршрутизации: критичный этап (ручное согласование, >80% SLA, отказ НРД) → параллельно e-mail + Messenger + WS-push. Обычные события — только e-mail. Маршрутизация по ролям настраивается в UI.

4. Контакты команд

Внешняя сторонаЧто согласовать
НРД (Национальный расчётный депозитарий)Тестовые сертификаты GUEST/TEST3, дистрибутив ИШ, доступ к личному кабинету УЦ НРД
Команда ЛК (ESIA Finance)Базовый URL ЛК, Basic-auth учётные данные, очерёдность подключения (сначала эмулятор, потом реальный ЛК)
Команда FansyКонтракт docs/fansy-contract/v1/, SLA, окна обслуживания, IP-allowlist
КриптоПроСерийный номер лицензии CSP, актуальный дистрибутив, поддержка support@cryptopro.ru
Брокеры-контрагенты MOSTБКС (ИНН 5406121446), Ренессанс (7709258228), Альфа-Банк (7728168971) — уже в seed
{{end}}