API de autorizadores
Um autorizador decide quem pode abrir a playlist de um canal. Um canal usa um autorizador por meio do campo authorizer. Saiba mais sobre os métodos e a prioridade deles em Autorização HTTP.
Todas as requisições desta página estão disponíveis apenas para a função admin.
Objeto de autorizador
Seção intitulada “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 do autorizador. Somente na requisição de criação.
- ip (opcional): Lista de regras no formato
<action> <address>. Saiba mais em Autorização HTTP por IP. - securetoken (opcional): O segredo para o Securetoken.
- backend (opcional): Lista de URLs do seu HTTP Backend.
- default: O que fazer quando nenhum método decidiu:
allow,denyoupass. Sempre defina este campo.
Criar um autorizador
Seção intitulada “Criar um autorizador”POST /api/ott/authorizerExemplo:
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"}'Retorna 204, ou 409 se já existir um autorizador com este ID.
Obter um autorizador
Seção intitulada “Obter um autorizador”GET /api/ott/authorizer?id=<authorizer_id>Retorna o objeto do autorizador sem o campo id, ou 404.
Atualizar um autorizador
Seção intitulada “Atualizar um autorizador”PUT /api/ott/authorizer?id=<authorizer_id>Envie o objeto completo. Um método que você omitir é removido do autorizador. Retorna 204, ou 404.
Excluir um autorizador
Seção intitulada “Excluir um autorizador”DELETE /api/ott/authorizer?id=<authorizer_id>Remova primeiro o autorizador dos canais com Atualizar um canal, para que nenhum canal referencie um autorizador que não existe. Retorna 204, ou 404.
Gerar um Securetoken
Seção intitulada “Gerar um Securetoken”GET /api/ott/securetoken?id=<authorizer_id>&path=<path>&ip=<ip>&start=<time>&end=<time>Calcula o token para um espectador. Use-o quando o seu middleware não calcular o token por conta própria. O autorizador precisa ter o segredo securetoken.
- id: ID do autorizador.
- path: Caminho da playlist, exatamente como o espectador a solicita, por exemplo
/news/index.m3u8. - ip: Endereço IP do espectador.
- start, end: O momento em que o token começa e deixa de funcionar, no formato RFC 3339, por exemplo
2026-11-07T10:00:00Z.
Exemplo:
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'Resposta: o token como uma string JSON:
"e8bff06f373694dda657e8417fe76f6b54b69807-a5cd6c00-1794052800-1794045600"Adicione o token à URL da playlist:
http://alta.example.com:8101/news/index.m3u8?token=e8bff06f373694dda657e8417fe76f6b54b69807-a5cd6c00-1794052800-1794045600| Código | Descrição |
|---|---|
200 | O token |
400 | Um horário não está no formato RFC 3339 |
404 | O autorizador não existe, ou não tem securetoken |