Saltearse al contenido
Productos

API de autorizadores

Un autorizador decide quién puede abrir la lista de reproducción de un canal. Un canal usa un autorizador mediante su campo authorizer. Más información sobre los métodos y su prioridad en Autorización HTTP.

Todas las solicitudes de esta página están disponibles solo para el rol 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 del autorizador. Solo en la solicitud de creación.
  • ip (opcional): lista de reglas con el formato <action> <address>. Más información en IP.
  • securetoken (opcional): el secreto para Securetoken.
  • backend (opcional): lista de URL de su HTTP Backend.
  • default: qué hacer cuando ningún método ha decidido: allow, deny o pass. Establézcalo siempre.
Ventana de terminal
POST /api/ott/authorizer

Ejemplo:

Ventana de terminal
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"}'

Devuelve 204, o 409 si ya existe un autorizador con este ID.

Ventana de terminal
GET /api/ott/authorizer?id=<authorizer_id>

Devuelve el objeto de autorizador sin el campo id, o 404.

Ventana de terminal
PUT /api/ott/authorizer?id=<authorizer_id>

Envíe el objeto completo. Un método que omita se elimina del autorizador. Devuelve 204, o 404.

Ventana de terminal
DELETE /api/ott/authorizer?id=<authorizer_id>

Quite primero el autorizador de los canales con Actualizar un canal, para que ningún canal haga referencia a un autorizador que no existe. Devuelve 204, o 404.

Ventana de terminal
GET /api/ott/securetoken?id=<authorizer_id>&path=<path>&ip=<ip>&start=<time>&end=<time>

Calcula el token para un espectador. Úselo cuando su middleware no calcule el token por sí mismo. El autorizador debe tener el secreto securetoken.

  • id: ID del autorizador.
  • path: ruta de la lista de reproducción, exactamente como la solicita el espectador, por ejemplo /news/index.m3u8.
  • ip: dirección IP del espectador.
  • start, end: el momento en que el token empieza y deja de funcionar, en formato RFC 3339, por ejemplo 2026-11-07T10:00:00Z.

Ejemplo:

Ventana de terminal
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'

Respuesta: el token como cadena JSON:

"e8bff06f373694dda657e8417fe76f6b54b69807-a5cd6c00-1794052800-1794045600"

Añada el token a la URL de la lista de reproducción:

http://alta.example.com:8101/news/index.m3u8?token=e8bff06f373694dda657e8417fe76f6b54b69807-a5cd6c00-1794052800-1794045600
CódigoDescripción
200El token
400Un valor de tiempo no tiene el formato RFC 3339
404El autorizador no existe, o no tiene securetoken