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.
Objeto de autorizador
Sección titulada «Objeto de autorizador»{ "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,denyopass. Establézcalo siempre.
Crear un autorizador
Sección titulada «Crear un autorizador»POST /api/ott/authorizerEjemplo:
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.
Obtener un autorizador
Sección titulada «Obtener un autorizador»GET /api/ott/authorizer?id=<authorizer_id>Devuelve el objeto de autorizador sin el campo id, o 404.
Actualizar un autorizador
Sección titulada «Actualizar un autorizador»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.
Eliminar un autorizador
Sección titulada «Eliminar un autorizador»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.
Generar un Securetoken
Sección titulada «Generar un Securetoken»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:
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ódigo | Descripción |
|---|---|
200 | El token |
400 | Un valor de tiempo no tiene el formato RFC 3339 |
404 | El autorizador no existe, o no tiene securetoken |