Интеграция с Ministra (Stalker) Middleware
Ministra TV Platform (ранее Stalker Middleware) управляет абонентами, приставками и списком каналов. Alta доставляет каналы и ТВ-архив. Ministra взаимодействует с Alta так же, как с Flussonic: она добавляет временный токен к каждой ссылке на канал, а Alta проверяет токен в Ministra перед началом воспроизведения.
В этой статье пошагово показано, как подключить Alta к Ministra: каналы в прямом эфире с временными ссылками, ТВ-архив (catch-up) и timeshift.
Как это работает
Заголовок раздела «Как это работает»
- Абонент открывает канал на приставке.
- Ministra создаёт временный токен и возвращает ссылку на канал с этим токеном:
http://alta.example.com:8102/demo/index.m3u8?token=41771f02a48d1fef09eebe9f0efdaeb8 - Приставка запрашивает плейлист у Alta.
- Alta отправляет токен в Ministra:
http://stalker.example.com/stalker_portal/server/api/chk_flussonic_tmp_link.php?token=... - Ministra отвечает
200 OK, если токен действителен, или403 Forbiddenв противном случае. - Alta возвращает приставке плейлист и поток либо
403 Forbidden.
Токен проверяется один раз, при запросе плейлиста. После этого приставка воспроизводит поток в рамках своей сессии в Alta. По умолчанию токен для прямого эфира действует 5 секунд: приставка получает новый токен каждый раз, когда открывает канал. Токены для ТВ-архива действуют 8 часов.
Для ТВ-архива Ministra использует формат ссылок Flussonic DVR. Alta поддерживает его из коробки:
| Функция | Ссылка, создаваемая Ministra |
|---|---|
| Прямой эфир | http://<alta>:<port>/<path>/index.m3u8?token=... |
| Timeshift (с начала текущего часа) | http://<alta>:<port>/<path>/index-<start>-now.m3u8?token=... |
| Catch-up (передача из EPG) | http://<alta>:<port>/<path>/archive-<start>-<duration>.m3u8?token=... |
Подробнее об этих ссылках читайте в статье Формат URL для доступа по HLS.
Требования
Заголовок раздела «Требования»- Приставки имеют доступ к порту OTT-сервера Alta (
8102в этом примере). - Alta имеет доступ к Ministra по HTTP (по умолчанию порт
80). - Для ТВ-архива: хранилище в Alta и EPG для каналов в Ministra.
В этой статье:
| Адрес | |
|---|---|
| OTT-сервер Alta | http://alta.example.com:8102 |
| Ministra | http://stalker.example.com/stalker_portal/ |
| Путь канала в Alta | demo |
Шаг 1. Настройка Alta
Заголовок раздела «Шаг 1. Настройка Alta»Ресивер
Заголовок раздела «Ресивер»Перейдите в Receivers → Create и добавьте источник канала. Подробнее в разделе Ресиверы.

Хранилище
Заголовок раздела «Хранилище»Хранилище необходимо для ТВ-архива и timeshift. Пропустите этот шаг, если вам нужны только каналы в прямом эфире.
Перейдите в Settings → Storages → Create:
- Name:
archive - Duration: глубина архива в часах, например
24 - Location: каталог для архива, например
/var/lib/alta/archive

Авторизатор
Заголовок раздела «Авторизатор»Перейдите в Settings → Authorizers → Create:
- Name:
stalker - Default:
Deny - Backends → Add Backend:
http://stalker.example.com/stalker_portal/server/api/chk_flussonic_tmp_link.php

Перейдите в Channels → Create:
- Enable: включено
- Path:
demo. Канал доступен по адресуhttp://alta.example.com:8102/demo/index.m3u8 - Name:
Demo Channel - Variants → main: включите и выберите ресивер
- Authorizer:
stalker - Storage & Duration → Storage:
archive(для ТВ-архива)

Убедитесь, что канал защищён. Без токена Alta отвечает 403 Forbidden:
curl -I http://alta.example.com:8102/demo/index.m3u8HTTP/1.1 403 ForbiddenШаг 2. Настройка Ministra
Заголовок раздела «Шаг 2. Настройка Ministra»Сервер архива
Заголовок раздела «Сервер архива»Пропустите этот шаг, если вам нужны только каналы в прямом эфире.
Перейдите в Storage → Storage list → Add storage:
- Title:
alta - IP: адрес и OTT-порт Alta без
http://:alta.example.com:8102 - Apache port:
8102. Поле обязательное, но для Flussonic DVR не используется - Maximum of users: например,
1000. Если поле пустое, приставки получают ошибкуlimitпри открытии архива - Additional information → Allow TV recording:
Flussonic DVR

Перейдите в IPTV channels → Channels → Add a channel.
Basic:
- Channel number, Channel name, Genre
- Basic channel: включите, если вы не используете тарифные планы. В противном случае добавьте канал в пакет услуг, иначе абоненты его не увидят
Streaming links → Add link:
- Channel URL:
ffmpeg http://alta.example.com:8102/demo/index.m3u8 - Temporary URL:
Flussonic

Нажмите Save в диалоге ссылки. Ссылка появится в таблице Streaming links со значением Temporary HTTP-link On:

TV archive:
- TV archive type:
Flussonic DVR - Archive servers:
alta - TV archive address: адрес канала в Alta без
ffmpeg:http://alta.example.com:8102/demo/index.m3u8. Ministra формирует из него ссылки на архив - TV archive length: глубина архива в часах, такая же, как длительность хранилища в Alta, например
24
EPG:
- XMLTV ID: ID канала в вашем источнике XMLTV. Catch-up работает только для передач из EPG

Нажмите Save.
Абонент
Заголовок раздела «Абонент»Добавьте абонента с MAC-адресом приставки в Users → Users list → Add user или используйте существующих абонентов.
Шаг 3. Проверка интеграции
Заголовок раздела «Шаг 3. Проверка интеграции»- Откройте канал на приставке. Канал воспроизводится.
- В Alta откройте Sessions: в списке есть сессия приставки.
- Откройте ТВ-архив на приставке и воспроизведите передачу из прошлого.
Чтобы проверить соединение между Alta и Ministra, выполните эту команду на сервере Alta:
curl -I "http://stalker.example.com/stalker_portal/server/api/chk_flussonic_tmp_link.php?token=test"403 Forbidden означает, что Ministra доступна и, как и ожидалось, отклоняет неизвестный токен.
Устранение неполадок
Заголовок раздела «Устранение неполадок»На все запросы возвращается 403 Forbidden
Заголовок раздела «На все запросы возвращается 403 Forbidden»- Проверьте адрес бэкенда в авторизаторе Alta с помощью команды
curl, приведённой выше. - Проверьте, что Temporary URL в ссылке канала в Ministra имеет значение
Flussonic. Без этого Ministra не добавляет токен. - Токен действует 5 секунд. Плеер, который открывает ту же ссылку позже, получает
403. Время задаётся опциейtv_tmp_link_ttlвcustom.iniMinistra.
Alta записывает отклонённые запросы в журнал:
journalctl -u alta | grep "Authorization denied"Список каналов на приставке пуст
Заголовок раздела «Список каналов на приставке пуст»Включите Basic channel для канала или добавьте его в пакет услуг тарифного плана абонента.
Архив не открывается: ошибка limit
Заголовок раздела «Архив не открывается: ошибка limit»Задайте Maximum of users для сервера архива в Ministra.
Передачи в архиве смещены по времени
Заголовок раздела «Передачи в архиве смещены по времени»Ministra использует часовой пояс PHP (default_timezone в custom.ini) и часовой пояс MySQL для расчёта времени передач. Если они различаются, ссылки на архив указывают на неверный диапазон времени. Задайте одинаковый часовой пояс для PHP и MySQL.