Fluxo de autorização básico executado no aplicativo principal
- Tópicos:
- Authentication
O Fluxo de autorização dentro do direito de Autenticação Adobe Pass permite que o aplicativo de streaming determine se um MVPD permite ou nega a solicitação do usuário para transmitir conteúdo. Se a decisão for Permit
, a resposta incluirá um token de mídia. O servidor do Adobe Pass assina o token de mídia e permite que o aplicativo de transmissão use a biblioteca de verificação de token de mídia para verificar sua autenticidade antes que o fluxo seja lançado.
A verificação com a biblioteca do verificador de token de mídia deve ocorrer no serviço de back-end do aplicativo de streaming vinculado à cadeia de permissões para liberar um fluxo do CDN.
Recuperar decisões de autorização usando mvpd específico
Pré-requisitos
Antes de recuperar decisões de autorização usando um MVPD específico, verifique se os seguintes pré-requisitos foram atendidos:
-
O aplicativo de streaming deve ter um perfil regular válido, criado com êxito para o MVPD usando um dos fluxos de autenticação básicos:
-
O aplicativo de streaming deve recuperar uma decisão de autorização antes de reproduzir um recurso selecionado pelo usuário.
Fluxo de trabalho (WRK)
Siga as etapas fornecidas para implementar o fluxo de autorização básico usando um MVPD específico executado em um aplicativo principal, conforme mostrado no diagrama a seguir.
Recuperar decisões de autorização usando mvpd específico
-
Recuperar decisão de autorização: o aplicativo de streaming reúne todos os dados necessários para obter uma decisão de autorização para um recurso específico, chamando o ponto de extremidade de Autorização de Decisões.
IMPORTANT
Consulte a Recuperar decisões de autorização usando a documentação da API do mvpd específica para obter detalhes sobre:- Todos os parâmetros necessários, como
serviceProvider
,mvpd
eresources
- Todos os cabeçalhos necessários, como
Authorization
eAP-Device-Identifier
- Todos os parâmetros e cabeçalhos opcionais
- Todos os parâmetros necessários, como
-
Localizar perfil regular: O servidor Adobe Pass identifica um perfil válido com base nos parâmetros e cabeçalhos recebidos.
-
Recuperar decisão MVPD para o recurso solicitado: O servidor do Adobe Pass chama o ponto de extremidade de autorização MVPD para obter uma decisão
Permit
ouDeny
para o recurso específico recebido do aplicativo de streaming. -
Retornar a decisão
Permit
com o token de mídia: A resposta do ponto de extremidade de Autorização de Decisões contém uma decisãoPermit
e um token de mídia.IMPORTANT
Consulte a Recuperar decisões de autorização usando a documentação específica da API mvpd para obter detalhes sobre as informações fornecidas em uma resposta de decisão.O endpoint de autorização de decisões valida os dados da solicitação para garantir que as condições básicas sejam atendidas:- Os parâmetros e cabeçalhos requeridos devem ser válidos.
- A integração entre o
serviceProvider
e omvpd
fornecidos deve estar ativa.
Se a validação falhar, uma resposta de erro será gerada, fornecendo informações adicionais que seguem a documentação de Códigos de erro aprimorados. -
Iniciar fluxo com token de mídia: O aplicativo de streaming usa o token de mídia para reproduzir o conteúdo.
-
Retornar a decisão
Deny
com detalhes: A resposta do ponto de extremidade de Autorização de Decisões contém uma decisãoDeny
e uma carga de erro que segue a documentação de Códigos de Erro Aprimorados.IMPORTANT
Consulte a Recuperar decisões de autorização usando a documentação específica da API mvpd para obter detalhes sobre as informações fornecidas em uma resposta de decisão.O endpoint de autorização de decisões valida os dados da solicitação para garantir que as condições básicas sejam atendidas:- Os parâmetros e cabeçalhos requeridos devem ser válidos.
- A integração entre o
serviceProvider
e omvpd
fornecidos deve estar ativa.
Se a validação falhar, uma resposta de erro será gerada, fornecendo informações adicionais que seguem a documentação de Códigos de erro aprimorados. -
Identificador de detalhes de decisão
Deny
: o aplicativo de streaming processa as informações de erro da resposta e pode usá-las para exibir opcionalmente uma mensagem específica na interface do usuário.