Guia de integração do programador programmer-integration-guide
Este guia de integração é destinado a provedores de conteúdo (programadores) que planejam integrar com a Autenticação de passagem Adobe®.
No cenário digital de hoje, os visualizadores podem acessar a Internet a qualquer hora, em qualquer lugar e solicitar acesso ao conteúdo protegido. Eles podem estar olhando para assistir a um evento único ou buscar os direitos para transmitir uma série de televisão inteira que você está transmitindo.
Antes de conceder acesso a um conteúdo protegido, você deve determinar se o visualizador tem direito a ele. As principais perguntas incluem:
- O visualizador tem uma assinatura ativa com um Distribuidor de Programação de Vídeo Multicanal (MVPD)?
- Essa assinatura inclui sua programação?
Autenticação Adobe Pass para TV em todos os lugares adobe-pass-authentication-for-tv-everywhere
Para programadores, determinar o direito nem sempre é simples. Os MVPDs são os responsáveis pelos dados de identificação e privilégios de acesso de seus clientes. Para complicar ainda mais a situação, os telespectadores dos programadores podem assinar uma grande variedade de MVPDs, cada um operando com sistemas únicos. Essas complexidades tornam a verificação de direitos tecnicamente desafiadora e exigente em recursos.
Direito De Usuário Determinado Diretamente Pelo Programador
A autenticação do Adobe Pass facilita com segurança as transações de direitos entre programadores e MVPDs, tornando rápido, fácil e seguro o fornecimento de conteúdo protegido a visualizadores elegíveis.
Direitos de Usuário Mediados pela Autenticação Adobe Pass
A Autenticação do Adobe Pass atua como proxy e facilita o fluxo de direitos entre Programadores e MVPDs, oferecendo interfaces seguras e consistentes para ambas as partes.
Para Programadores, a Autenticação do Adobe Pass fornece APIs como parte de uma camada Standard ou Premium:
-
APIs padrão de autenticação da Adobe Pass:
-
APIs de autenticação Premium do Adobe Pass:
Casos de uso use-cases
Esta seção descreve mais detalhadamente os casos de uso de integração do Programador compatíveis com a Autenticação do Adobe Pass:
-
Aplicativo de programador (TVE) com uma rede de canal único
Isso permite que o programador forneça aos visualizadores acesso ao conteúdo de uma rede de canal de marca única em um aplicativo TVE.
-
Aplicativo de programador (TVE) com várias redes de canal
Isso permite que o programador forneça aos visualizadores acesso ao conteúdo de várias redes de canal em um único aplicativo TVE.
-
Aplicativo de programador (TVE) para eventos especiais
Isso permite que o programador forneça aos visualizadores acesso ao conteúdo de eventos especiais que podem não ser recursos do banco de dados de direitos do MVPD, como canais normais.
Fluxo de direitos entitlement-flow
O fluxo de qualificação é uma série de etapas que um aplicativo de Programador (TVE) deve concluir para transmitir conteúdo protegido. O fluxo consiste nas seguintes fases:
Na visita inicial de um usuário a um aplicativo de Programador (TVE), o fluxo de direito segue a sequência descrita. No entanto, em visitas subsequentes, o aplicativo pode ignorar determinadas etapas com base no status do registro ou da autenticação e nas políticas de visualização aplicáveis.
Para obter uma exploração detalhada do fluxo de direitos e suas fases, continue lendo este documento e, depois de consultar os guias do guia de receitas que o acompanham para obter insights adicionais:
Fase de registro registration-phase
A finalidade da Fase de Registro é registrar o aplicativo cliente na Autenticação Adobe Pass por meio do processo de Registro Dinâmico de Cliente (DCR).
O processo de Registro dinâmico de cliente (DCR) exige que o aplicativo cliente obtenha um par de credenciais de cliente e recupere um token de acesso como meta final da fase de registro.
APIs
Fluxos
Perguntas frequentes
Fase de configuração configuration-phase
A finalidade da Fase de configuração é fornecer ao aplicativo cliente a lista de MVPDs com os quais ele está ativamente integrado, juntamente com os detalhes de configuração salvos pela Autenticação Adobe Pass para cada MVPD.
A Fase de configuração atua como uma etapa de pré-requisito para a Fase de autenticação quando o aplicativo cliente precisa solicitar que o usuário selecione o Provedor de TV.
APIs
Perguntas frequentes
Fase de autenticação authentication-phase
A finalidade da Fase de autenticação é fornecer ao aplicativo cliente a capacidade de verificar a identidade do usuário com a MVPD e obter informações de metadados do usuário.
A Fase de autenticação atua como uma etapa de pré-requisito para a Fase de pré-autorização ou Fase de autorização quando o aplicativo cliente precisa reproduzir o conteúdo.
A autenticação bem-sucedida gera um perfil vinculado ao aplicativo, dispositivo e provedor de serviços, contendo também informações de metadados do usuário.
Etapas de alto nível
As etapas a seguir descrevem as etapas de alto nível no caso de uma integração SAML:
-
Carregamento do Aplicativo (Site) do Programador
O usuário navega até o aplicativo (site) do Programador, que integra a API REST V2 de Autenticação do Adobe Pass. -
Solicitação de conteúdo protegido
Quando o usuário tenta acessar um conteúdo protegido, o aplicativo do Programador exibe uma lista de MVPDs que o usuário pode selecionar. -
Inicialização da Solicitação de Autenticação
Após a seleção do MVPD, o usuário é redirecionado para um servidor de Autenticação Adobe Pass. Aqui, uma solicitação de autenticação SAML criptografada para o MVPD selecionado é gerada, no caso de uma integração SAML. Essa solicitação é enviada em nome do Programador para a MVPD. Dependendo do sistema do MVPD, o navegador do usuário é redirecionado para a página de logon do MVPD ou um iFrame de logon é incorporado no aplicativo do Programador. -
Logon do MVPD
O MVPD aceita a solicitação e apresenta sua interface de logon, via redirecionamento ou iFrame. -
Logon e validação do usuário
O usuário faz logon com suas credenciais da MVPD. O MVPD valida o status de subscrição do usuário e estabelece sua própria sessão HTTP. -
Resposta do MVPD à Autenticação do Adobe Pass
Quando a validação for concluída, o MVPD gerará uma resposta SAML (criptografada) e a enviará de volta para a Autenticação Adobe Pass. -
Geração de perfil
A Autenticação do Adobe Pass verifica a resposta SAML, gera um perfil de usuário que é armazenado em cache e redireciona o usuário para o aplicativo do Programador (site).
APIs
Fluxos
Perguntas frequentes
Logon único (SSO) single-sign-on
APIs
Fluxos
(Opcional) Fase de pré-autorização preauthorization-phase
O objetivo da Fase de pré-autorização é fornecer ao aplicativo cliente a capacidade de apresentar um subconjunto de recursos de seu catálogo que o usuário teria direito de acessar.
A Fase de pré-autorização pode aprimorar a experiência do usuário quando ele abre o aplicativo do cliente pela primeira vez ou navega para uma nova seção.
APIs
Fluxos
Perguntas frequentes
Fase de autorização authorization-phase
A finalidade da Fase de autorização é fornecer ao aplicativo cliente a capacidade de reproduzir recursos que o usuário solicita após validar seus direitos com o MVPD.
Uma autorização bem-sucedida gera uma decisão, que também contém um token de mídia fornecido ao aplicativo Programador (TVE) para fins de segurança.
Etapas de alto nível
As etapas a seguir descrevem as etapas de alto nível:
-
Tratamento do Identificador de Recursos
O conteúdo protegido é identificado por um identificador de recurso, que pode ser uma cadeia de caracteres simples ou uma estrutura mais complexa. Esse identificador é predefinido e acordado entre o Programador e a MVPD. O aplicativo do Programador envia o identificador de recurso para a REST API V2 da Autenticação do Adobe Pass. -
Verificação de autorização do MVPD
O servidor de autenticação da Adobe Pass se comunica com o endpoint de autorização da MVPD usando protocolos padronizados. -
Resposta do MVPD à Autenticação do Adobe Pass
Quando a validação for concluída, o MVPD confirmará se o usuário tem direito (ou não) de acessar o conteúdo e enviará uma resposta para a Autenticação Adobe Pass. -
Geração de token de mídia e decisão
A Autenticação da Adobe Pass verifica a resposta, gera uma decisão que é armazenada em cache e retorna a decisão que contém um token de mídia de volta ao aplicativo do Programador (site). -
Verificação de acesso ao conteúdo
O aplicativo do Programador usa o Verificador de Token de Mídia para confirmar se o usuário correto está acessando o conteúdo correto. Depois de validado, o usuário recebe acesso para visualizar o conteúdo protegido.
APIs
Fluxos
Perguntas frequentes
Fase de saída logout-phase
A finalidade da Fase de logout é fornecer ao aplicativo cliente a capacidade de encerrar o perfil autenticado do usuário na Autenticação do Adobe Pass mediante solicitação do usuário.
APIs
Fluxos
Perguntas frequentes
Logout único (SLO) single-logout
Fluxos
Noções básicas sobre direitos understanding-entitlements
A solução Adobe Pass Authentication baseia-se na criação de direitos — dados específicos gerados após a conclusão bem-sucedida de workflows de autenticação e autorização. Esses direitos concedem acesso a conteúdo protegido, mas têm um tempo de vida limitado. Quando um direito expira, ele deve ser renovado reiniciando os processos de autenticação ou autorização.
Para obter mais informações sobre direitos, consulte os seguintes documentos:
-
Perfis
Após a autenticação bem-sucedida, a Autenticação do Adobe Pass cria um perfil autenticado ("duradouro") associado ao aplicativo solicitante, ao dispositivo e ao identificador do provedor de serviços (identificador do solicitante).
-
Após a autenticação bem-sucedida (e em alguns casos também após a autorização), a Autenticação do Adobe Pass recebe metadados do usuário da MVPD que podem expô-los ao aplicativo solicitante.
-
Após a autorização bem-sucedida, a Autenticação do Adobe Pass cria uma decisão de autorização ("longa vida") associada ao aplicativo solicitante, dispositivo, identificador de provedor de serviços (identificador do solicitante) e um recurso protegido específico (identificador de recursos).
-
Após a autorização bem-sucedida, a Autenticação do Adobe Pass cria um token de mídia ("vida curta") associado a uma solicitação de reprodução bem-sucedida.