Decisões

Última atualização: 5 de março de 2025
IMPORTANT
O conteúdo desta página é fornecido apenas para fins informativos. O uso desta API requer uma licença atual da Adobe. Não é permitida nenhuma utilização não autorizada.

As decisões são geradas pela REST API V2 da Autenticação do Adobe Pass com base nas consultas de autorização ou pré-autorização do MVPD do usuário, determinando se o acesso a conteúdo protegido é concedido ou negado.

Há dois tipos de decisões que são fornecidas, dependendo da API invocada:

Decisões de pré-autorização

A decisão de pré-autorização é uma decisão informativa que permite que o aplicativo cliente seja informado se a MVPD pode permitir ou negar o acesso do usuário a um recurso protegido.

O objetivo da pré-autorização (autorização de comprovação) é permitir que o aplicativo exiba informações precisas sobre o conteúdo que o usuário pode estar qualificado a visualizar. Isso é feito aprimorando a interface do usuário com indicadores, como ícones bloqueados ou desbloqueados, para refletir o status de acesso.

IMPORTANT
A decisão de pré-autorização não deve ser usada de forma autoritativa para reproduzir recursos, pois essa é a finalidade de uma decisão de autorização.

O uso da API de pré-autorização não é obrigatório. O aplicativo cliente pode ignorar isso se quiser apresentar um catálogo de recursos sem nenhuma filtragem.

Se o aplicativo cliente pretende usar esse recurso, é importante observar que as decisões de pré-autorização só podem ser obtidas para um número limitado de recursos por solicitação de API, normalmente até 5.

IMPORTANT
O número máximo de recursos pode ser aumentado somente após chegar a um acordo com os MVPDs e representantes de autenticação da Adobe Pass. Depois de acordadas, as alterações podem ser implementadas por meio do Painel do Adobe Pass TVE por um administrador em sua organização ou um representante de autenticação da Adobe Pass que atue em seu nome.
Para obter mais detalhes, consulte a documentação do Guia do Usuário de Integrações do Painel do TVE.

Os MVPDs podem oferecer suporte à pré-autorização por meio de vários mecanismos, cada um com implicações distintas para o desempenho e o número máximo de recursos que podem ser manipulados em uma única solicitação de API.

Para obter mais detalhes sobre os mecanismos existentes que oferecem suporte à pré-autorização, consulte a documentação da Autorização de simulação do MVPD.

IMPORTANT
Para MVPDs sem suporte completo de autorização de comprovação, o uso da pré-autorização deve ser acordado antecipadamente com os MVPDs e representantes de autenticação da Adobe Pass, pois pode resultar em problemas de desempenho e tempos de resposta mais lentos.

Decisões de autorização

A decisão de autorização é uma decisão autoritativa que permite que o aplicativo cliente esteja em conformidade com a decisão da MVPD de permitir ou negar o acesso do usuário a um recurso protegido.

A finalidade da autorização é permitir que o aplicativo reproduza os recursos solicitados pelo usuário, após a validação de direitos com o MVPD e o recebimento de um token de mídia da Autenticação Adobe Pass.

IMPORTANT
A autenticação da Adobe Pass recomenda que os programadores usem a biblioteca Verificador de token de mídia para validar o token de mídia incluído em uma decisão de autorização, garantindo acesso seguro antes de iniciar o fluxo de vídeo.
Para obter mais detalhes, consulte a documentação dos Tokens de mídia.

O uso da API de autorização é obrigatório. O aplicativo cliente não pode ignorar essa fase se quiser reproduzir recursos solicitados pelo usuário, pois requer a verificação com o MVPD de que o usuário tem direito antes de liberar o fluxo.

É importante observar que as decisões de autorização só podem ser obtidas para um número limitado de recursos por solicitação de API, normalmente 1.

IMPORTANT
O número máximo de recursos pode ser aumentado somente após chegar a um acordo com os MVPDs e representantes de autenticação da Adobe Pass.

Gerenciamento de TTL (Time-to-Live) de autorização

O TTL (Time-to-Live) de autorização define por quanto tempo um recurso permanece autorizado antes de precisar ser reautorizado. Esse período é limitado e deve ser acordado com os representantes da MVPD. Os valores de TTL podem variar com base em:

  • Categoria da plataforma (por exemplo, desktop, dispositivo móvel, dispositivos conectados à TV)
  • Plataforma específica (por exemplo, iOS, Android, tvOS, Roku, FireTV)

O TTL de autorização (authZ) pode ser exibido e alterado no Painel do TVE da Adobe Pass por um dos administradores da organização ou por um representante da Autenticação da Adobe Pass que atue em seu nome.

Para obter mais detalhes, consulte a documentação do Guia do Usuário de Integrações do Painel do TVE.