Интеграция с оборудованием

Раздел описывает интеграцию СмИТ Биллинг 1.0 с сетевым оборудованием: NAS/BRAS-серверами, коммутаторами, VoIP-шлюзами, IPTV-системами и абонентским оборудованием.

Интернет оборудование — Пользовательская схема

Для интеграции нестандартного NAS-оборудования с СмИТ Биллинг 1.0 используется пользовательская схема. Процесс интеграции состоит из 5 шагов:

Добавить NAS — зарегистрируйте новое NAS-устройство в разделе Оборудование → NAS веб-интерфейса биллинга. Укажите IP-адрес, тип устройства, RADIUS-secret.
Настроить RADIUS — сконфигурируйте на NAS-устройстве параметры RADIUS-аутентификации: адрес RADIUS-сервера (IP биллинга), порты авторизации (1812) и учёта (1813), shared secret.
Создать пользовательский скрипт — разработайте скрипт управления сессиями для вашего оборудования. Скрипт размещается в каталоге пользовательских бинарных файлов.
Перезапустить nas_event_daemon — после добавления нового NAS перезапустите демон обработки событий для подхвата новой конфигурации.
Верификация — выполните тестовую авторизацию абонента и убедитесь, что сессия корректно создаётся и завершается.

Пользовательские скрипты управления NAS размещаются в директории проекта и монтируются в Docker-контейнер FreeRADIUS:

# Создать пользовательский скрипт NAS
docker compose exec freeradius bash
cd /app/radius_python/nas_scripts/
cp template_session.py my_nas_session.py
# Отредактировать скрипт под ваше оборудование

# Перезапустить FreeRADIUS
docker compose restart freeradius

FreeRADIUS работает в отдельном Docker-контейнере с модулем rlm_python3. Три виртуальных сервера: default (интернет, порты 1812/1813), voip (2812/2813), iptv (6812/6813).

Поддерживаемое интернет-оборудование

Mikrotik RouterOS RADIUS-авторизация, PPPoE, Hotspot, DHCP
Cisco IOS / IOS-XE AAA, PPPoE, IP Subscriber
Juniper JUNOS AAA, DHCP Subscriber
Huawei (ME60, NE серия) BRAS, PPPoE, IPoE
Eltex (ESR, MES серия) RADIUS, DHCP option 82
D-Link (DES, DGS серия) Option 82, VLAN-based авторизация
Actelis / BDCom / BDCOM DSLAM, Option 82
Linux (FreeRADIUS + iptables) Софтроутер на базе Linux
Redback / Ericsson SmartEdge PPPoE BRAS
UTStarcom / Iskratel DSLAM, GPON
ZTE (C300/C600) OLT, GPON, RADIUS
SNR (коммутаторы) Option 82, VLAN
Прочие (пользовательская схема) Интеграция любого RADIUS-совместимого оборудования

Телефония

Типовой план интеграции VoIP-оборудования с СмИТ Биллинг 1.0 занимает 20-30 минут и состоит из 7 этапов:

Настройка OSS-схемы подключения к VoIP-шлюзу/АТС.
Настройка парсера CDR-файлов (формат, кодировка, путь).
Конфигурация правил нормализации телефонных номеров (E.164).
Настройка направлений вызовов (VoIP-направления и категории).
Создание тарифных планов телефонии (поминутная, посекундная тарификация).
Тестовый вызов и верификация тарификации.
Запуск сервиса в эксплуатацию.

Поддерживаемые OSS-схемы

Unitel TS-004 — цифровая АТС, CDR через файловый обмен.
Asterisk — открытая IP-АТС, CDR через CSV/RADIUS.
Eltex SMG-1016M — медиашлюз, CDR через RADIUS.
АТС М-200 — аналоговая АТС, CDR через RS-232/файл.
Avaya — корпоративная АТС, CDR через SFTP.

Поддерживаемые парсеры CDR

Парсер	Формат
D-Link	CSV
Asterisk	CSV / RADIUS
Cisco	CDR binary / CSV
Mera Networks (MVTS)	CSV
Alterteks	CSV с разделителем «;»
GNU Gk (GnuGatekeeper)	RADIUS / CSV
VoiceCom	CSV
Quintum Tenor	CSV / RADIUS
Unitel TS-004	Проприетарный формат
АТС Iskratel SI3000	CSV
Avaya	CSV / SFTP

IPTV

Интеграция с IPTV-платформами выполняется в 3 шага:

Настройка OSS-модуля — выбор и конфигурация схемы подключения к IPTV-платформе (API-ключи, URL-адреса, учётные данные).
Привязка услуг — создание услуг IPTV в биллинге и привязка их к тарифным планам абонентов.
Тестирование — активация услуги для тестового абонента, проверка синхронизации подписок.

Поддерживаемые IPTV-платформы

IPTVPortal — облачная платформа интерактивного ТВ.
Infomir Ministra (Stalker) — middleware для STB-приставок.
LifeStream — OTT-платформа IPTV.
Megogo — онлайн-кинотеатр с IPTV-функциями.
TITV — платформа интерактивного телевидения.
NextTV — IPTV-middleware.
24hTV — сервис интернет-телевидения.
MOOVI — OTT/IPTV-платформа.
TVIP TMS — система управления TVIP-приставками.

Логи синхронизации с IPTV-платформами:

docker compose logs web | grep oss
docker compose logs celery | grep iptv

Отключение интеграции с конкретной IPTV-платформой выполняется через настройки в веб-интерфейсе или переменные окружения (.env).

Абонентское оборудование

Управление абонентским оборудованием (CPE): роутеры, модемы, ONT-терминалы. Биллинг поддерживает удалённую настройку оборудования через протокол TR-069 (CWMP). Для каждого устройства хранятся: модель, серийный номер, MAC-адрес, статус подключения, параметры конфигурации.

Камеры

Интеграция с системами видеонаблюдения, в частности Flussonic Watcher. Биллинг управляет подписками абонентов на услуги видеонаблюдения: активация/деактивация доступа к камерам, тарификация просмотра архива, управление правами доступа к группам камер.

Аренда оборудования

Модуль учёта оборудования, предоставляемого абонентам в аренду: Wi-Fi роутеры, STB-приставки, ONT-терминалы. Для каждой единицы оборудования ведётся учёт: привязка к абоненту, дата выдачи/возврата, состояние, начисление арендной платы. При блокировке или расторжении договора формируется уведомление о необходимости возврата оборудования.