Pular para o conteúdo
Produtos

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.

{
"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, deny ou pass. Sempre defina este campo.
Terminal window
POST /api/ott/authorizer

Exemplo:

Terminal window
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.

Terminal window
GET /api/ott/authorizer?id=<authorizer_id>

Retorna o objeto do autorizador sem o campo id, ou 404.

Terminal window
PUT /api/ott/authorizer?id=<authorizer_id>

Envie o objeto completo. Um método que você omitir é removido do autorizador. Retorna 204, ou 404.

Terminal window
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.

Terminal window
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:

Terminal window
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ódigoDescrição
200O token
400Um horário não está no formato RFC 3339
404O autorizador não existe, ou não tem securetoken