API авторизаторов
Авторизатор определяет, кто может открыть плейлист канала. Канал использует авторизатор через поле authorizer. Подробнее о методах и их приоритете в разделе HTTP-авторизация.
Все запросы этой страницы доступны только роли admin.
Объект авторизатора
Заголовок раздела «Объект авторизатора»{ "id": "token-auth", "ip": ["allow 192.168.0.0/24", "deny 10.0.0.1"], "securetoken": "my-secret", "backend": ["http://auth.example.com/check"], "default": "deny"}- id: ID авторизатора. Только в запросе создания.
- ip (необязательный): список правил в формате
<action> <address>. Подробнее в разделе HTTP-авторизация по IP. - securetoken (необязательный): секрет для Securetoken.
- backend (необязательный): список URL вашего HTTP Backend.
- default: что делать, если ни один метод не принял решение:
allow,denyилиpass. Всегда задавайте это поле.
Создание авторизатора
Заголовок раздела «Создание авторизатора»POST /api/ott/authorizerПример:
curl -sS -X POST -H "Authorization: Bearer $TOKEN" \ -H 'Content-Type: application/json' \ 'http://alta.example.com:8100/api/ott/authorizer' \ -d '{"id": "token-auth", "securetoken": "my-secret", "default": "deny"}'Возвращает 204 или 409, если авторизатор с таким ID существует.
Получение авторизатора
Заголовок раздела «Получение авторизатора»GET /api/ott/authorizer?id=<authorizer_id>Возвращает объект авторизатора без поля id или 404.
Изменение авторизатора
Заголовок раздела «Изменение авторизатора»PUT /api/ott/authorizer?id=<authorizer_id>Передайте объект целиком. Пропущенный метод удаляется из авторизатора. Возвращает 204 или 404.
Удаление авторизатора
Заголовок раздела «Удаление авторизатора»DELETE /api/ott/authorizer?id=<authorizer_id>Сначала уберите авторизатор из каналов через Изменение канала, чтобы ни один канал не ссылался на несуществующий авторизатор. Возвращает 204 или 404.
Генерация Securetoken
Заголовок раздела «Генерация Securetoken»GET /api/ott/securetoken?id=<authorizer_id>&path=<path>&ip=<ip>&start=<time>&end=<time>Вычисляет токен для одного зрителя. Используйте его, если ваш мидлвар не вычисляет токен сам. У авторизатора должен быть секрет securetoken.
- id: ID авторизатора.
- path: путь плейлиста точно в том виде, в котором его запрашивает зритель, например
/news/index.m3u8. - ip: IP-адрес зрителя.
- start, end: время, когда токен начинает и перестаёт действовать, в формате RFC 3339, например
2026-11-07T10:00:00Z.
Пример:
curl -sS -G -H "Authorization: Bearer $TOKEN" \ 'http://alta.example.com:8100/api/ott/securetoken' \ --data-urlencode 'id=token-auth' \ --data-urlencode 'path=/news/index.m3u8' \ --data-urlencode 'ip=203.0.113.5' \ --data-urlencode 'start=2026-11-07T10:00:00Z' \ --data-urlencode 'end=2026-11-07T12:00:00Z'Ответ: токен в виде строки JSON:
"e8bff06f373694dda657e8417fe76f6b54b69807-a5cd6c00-1794052800-1794045600"Добавьте токен в URL плейлиста:
http://alta.example.com:8101/news/index.m3u8?token=e8bff06f373694dda657e8417fe76f6b54b69807-a5cd6c00-1794052800-1794045600| Код | Описание |
|---|---|
200 | Токен |
400 | Время указано не в формате RFC 3339 |
404 | Авторизатор не существует либо у него нет securetoken |