Перейти к содержимому
Продукты

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.

Окно терминала
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