Decisões decisions

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 preauthorization-decisions

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.

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.

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.

Decisões de autorização authorization-decisions

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.

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.

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

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:

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.

Recursos protegidos protected-resources

Os recursos protegidos referem-se ao conteúdo otimizável, identificado por valores únicos definidos por acordos entre os MVPDs e os programadores participantes.

Os recursos protegidos seguem uma estrutura hierárquica em árvore, com cada nível fornecendo maior granularidade para autorização de conteúdo:

Identificador do recurso resource-identifier

O identificador exclusivo do recurso pode ter dois formatos:

No caso de um identificador de recurso simples, como "REF30" (que representa um canal), ele pode ser traduzido em um identificador de recurso RSS da seguinte maneira:

    <rss version="2.0">
        <channel>
            <title>REF30</title>
        </channel>
    </rss>

No caso de um identificador de recursos mais complexo, o identificador de recursos RSS pode incluir informações adicionais de classificação, como se segue:

    <rss version="2.0" xmlns:media="http://search.yahoo.com/mrss/">
        <channel>
            <title>REF30</title>
            <media:rating scheme="urn:mpaa">pg</media:rating>
        </channel>
    </rss>

Os identificadores exclusivos são principalmente opacos à autenticação da Adobe Pass, no entanto, os transformadores podem ser aplicados com base nos recursos e requisitos da MVPD. Se o MVPD não puder reconhecer ou analisar um identificador de recurso, retornará um erro para a Autenticação Adobe Pass, que subsequentemente retransmite o erro para o aplicativo cliente usando um Código de Erro Aprimorado.

REST API V2 rest-api-v2

As decisões de pré-autorização podem ser recuperadas usando a seguinte API:

As decisões de autorização podem ser recuperadas usando a seguinte API:

Consulte as seções Resposta e Amostras das APIs acima para entender a estrutura das decisões de pré-autorização e autorização.

Para obter mais detalhes sobre como e quando integrar as APIs acima, consulte os seguintes documentos: