Visão Geral Para Programadores programmers-overview

Introdução introduction

Essa visão geral destina-se ao provedor de conteúdo (Programador) que planeja integrar o Adobe® Pass ao seu site ou aplicativo. Para obter a documentação adicional, incluindo o Kickstart e guias de integração, consulte Informações relacionadas abaixo.

Hoje, seus visualizadores podem acessar a Internet a qualquer hora, em qualquer lugar e solicitar acesso a conteúdo protegido diretamente de você, o Programador. Eles podem querer assistir a um evento único ou podem estar buscando direitos de visualização para uma série de televisão inteira que você está transmitindo.

Mas antes de permitir o acesso ao conteúdo protegido, é necessário determinar se um cliente tem direito a visualizar esse conteúdo. Eles têm uma assinatura com um Distribuidor de programação de vídeo multicanal (MVPD)? Em caso afirmativo, essa assinatura inclui sua programação?

Determinar o direito de um visualizador nem sempre é simples para um programador. Os MVPDs mantêm os privilégios de identificação de dados e acesso para seus clientes. Adicione o fato de que os visualizadores que tentam acessar seu conteúdo protegido assinam uma variedade de MVPDs, cada um com sistemas diferentes, e é fácil ver que determinar o direito do visualizador ao conteúdo protegido pode se tornar rapidamente complicado e tecnicamente desafiador:

Figura: Direito Do Usuário Determinado Diretamente Pelo Programador

A Autenticação do Adobe Pass para TV em todos os lugares medeia com segurança essas transações de direito entre Programadores e MVPDs. A Autenticação do Adobe Pass facilita, agiliza e protege os Programadores para fornecer conteúdo protegido a clientes válidos:

Figura: Direito de Usuário Mediado pela Autenticação Adobe Pass

A Autenticação do Adobe Pass atua como seu proxy em intercâmbios com MVPDs participantes, para que você possa apresentar aos visualizadores uma interface consistente entre sites. A Autenticação Adobe Pass também permite fornecer aos visualizadores autenticação e autorização de logon único (SSO). A autenticação e a autorização são rastreadas para todos os serviços participantes, de modo que um assinante não precise fazer logon novamente após a primeira autenticação em seu próprio sistema.

Como funciona a autenticação do Adobe Pass HowItWorks

O aplicativo de visualização de conteúdo do programador interage com a autenticação do Adobe Pass usando o componente de cliente Access Enabler ou os serviços Web RESTful da API sem cliente (para dispositivos não compatíveis com a Web, como TVs inteligentes, consoles de jogos, decodificadores de sinais, etc.). O Access Enabler é executado no sistema do usuário, onde facilita todos os workflows de direito. O componente Ativador de acesso é baixado do site de hospedagem na Adobe quando os clientes acessam seu site e solicitam conteúdo protegido. Os servidores de Autenticação do Adobe Pass hospedam os serviços Web RESTful usados na solução sem cliente.

A Autenticação do Adobe Pass lida com os workflows de direito reais, enquanto fornece as primitivas que você usa para:

O Programador é responsável pela página da Web de nível superior ou pelo aplicativo do reprodutor que faz o seguinte:

O objetivo da Autenticação do Adobe Pass é criar uma maneira simples e modular para os Programadores e MVPDs lidarem com a verificação de direitos.

Compreensão de tokens understanding-tokens

A solução de direitos de autenticação da Adobe Pass se concentra na geração de dados específicos que são criados após a conclusão bem-sucedida dos workflows de autenticação e autorização. Esses dados são chamados de tokens. Os tokens têm uma duração limitada; quando expiram, os tokens precisam ser reemitidos por meio da reinicialização dos workflows de autenticação e autorização.

Para obter detalhes sobre tokens, consulte as seguintes seções:

Tipos de tokens token-types

Três tipos de tokens são emitidos durante os workflows de autenticação e autorização. Os tokens AuthN e AuthZ têm "longa vida", fornecendo continuidade na experiência de visualização do usuário. O token de mídia é um token de vida curta que fornece suporte às práticas recomendadas do setor para evitar fraudes por meio da extração de fluxo. Os programadores especificam os valores de TTL (time-to-live) para cada tipo de token com base em acordos feitos com MVPDs. Os programadores decidem sobre um valor TTL que melhor atenda a sua empresa e seus clientes.

Armazenamento de token token-storage

O Access Enabler armazena tokens de vida longa (AuthN e AuthZ) em locais específicos para seu ambiente:

Segurança de token token-security

O Servidor de autenticação da Adobe Pass assina digitalmente todos os tokens de longa vida usando a ID do dispositivo (derivada das características de hardware do dispositivo). A assinatura digital difere na forma como é gerada, protegida e validada dependendo do ambiente:

A Autenticação do Adobe Pass valida cada token de longa duração para garantir que o dispositivo que acessa o conteúdo seja o mesmo que emitiu o token. Para todos os tokens, uma validação no lado do cliente garante que a assinatura digital esteja intacta e que a integridade do token seja preservada. Quando a validação da ID de dispositivo falha, a sessão de autenticação é invalidada e o usuário é solicitado a fazer logon novamente, o que redefine os tokens.

Compartilhamento de token token-sharing

Os aplicativos em diferentes plataformas não compartilham tokens. Há várias razões para isso, incluindo as seguintes:

Ciclo de vida de integração do programador prog-integ-lifecycle

Figura: Integrando a autenticação ao site e aplicativo do programador

Fluxos lógicos logical-flows

Fluxograma de Direitos chart

O fluxograma a seguir apresenta o processo geral de confirmação de direitos (usando o componente de cliente Authentication Access Enabler da Adobe Pass):

Figura: processo de confirmação do direito

Etapas de autenticação authn-steps

As etapas a seguir apresentam um exemplo do fluxo de autenticação da Autenticação do Adobe Pass. Essa é a parte do processo de qualificação em que um Programador determina se o usuário é um cliente válido de um MVPD. Nesse cenário, o usuário é um assinante válido de um MVPD. O usuário está tentando exibir o conteúdo protegido usando um aplicativo de Flash do Programador:

Etapas de autorização authz-steps

As etapas a seguir continuam das Etapas de autenticação:

Registro e inicialização reg-and-init

A primeira etapa ao trabalhar com a Autenticação da Adobe Pass é fazer o registro no Adobe ou em um parceiro autorizado para a Autenticação da Adobe Pass.

Ao se registrar, você fornece uma lista dos domínios a partir dos quais se comunicará com a Autenticação Adobe Pass. Por exemplo, os domínios do Turner Broadcasting System incluem tbs.com e tnt.tv como domínios registrados para autenticação da Adobe Pass. Cada um desses sites de conteúdo recebe acesso à autenticação da Adobe Pass e recebe sua própria ID de solicitante (por exemplo, "TBS" e "TNT"). Se decidir adicionar mais sites, você deverá informar ao Adobe os nomes de domínio adicionais para colocá-los na lista de domínios permitidos e receber IDs de solicitante adicionais.

A ID do solicitante identifica exclusivamente o cliente do programador em todas as comunicações com o componente de cliente Access Enabler da autenticação da Adobe Pass. Todos os dados estáticos de Autenticação do Adobe Pass associados ao Programador são digitados para essa ID.

Etapas de integração integration-steps

1. Configuração do solicitante requestor

1-A. Registrando Com O Adobe

Seu primeiro passo é se registrar no Adobe ou em um parceiro autorizado de autenticação da Adobe Pass. Ao se registrar, você receberá um ou mais identificadores exclusivos globais (GUIDs). Cada GUID emitida está associada a um domínio do qual o acesso é permitido para a autenticação da Adobe Pass. Você passa um GUID (chamado ID do solicitante) para o domínio solicitante registrar sua identidade para cada sessão em que você interage com o Access Enabler. Para obter detalhes, consulte Registro e Inicialização no Guia de Integração do Programador.

1-B. Integração inicial do Access Enabler

A próxima etapa é integrar o Access Enabler ao aplicativo de reprodutor de mídia ou página da Web existente:

2. Tratamento da autenticação e da autorização authn-authz

2-A. Comunicação com o Access Enabler

A comunicação entre o Ativador de acesso e sua página da Web ou aplicativo de reprodução é assíncrona. Seu aplicativo chama os métodos do Access Enabler, e o Access Enabler responde via retornos de chamada que você registra na biblioteca do Access Enabler.

2-B. Fornecer Uma Interface Do Usuário De Direito entitlement-ui

Você fornece sua própria interface do usuário para acesso do usuário ao seu conteúdo. Alguns elementos, como o processo de logon real, são fornecidos pelo MVPD e alguns elementos estão opcionalmente disponíveis como parte da Autenticação do Adobe Pass. No mínimo, você deve fazer o seguinte:

2-C. Integração do verificador de token de mídia int-media-token-ver

É necessário integrar o componente Verificador de token de mídia de autenticação da Adobe Pass ao seu servidor de mídia. Dessa forma, o verificador de token existente pode reconhecer os tokens de mídia de vida curta fornecidos pela Autenticação do Adobe Pass com uma autorização bem-sucedida. O Verificador de token de mídia valida os tokens de mídia como a última etapa de segurança antes de você fornecer ao usuário acesso ao conteúdo protegido. Você recebe o local de onde baixar o Media Token Verifier ao se registrar no Adobe.

3. Suporte ao logout único ssl

Na maioria dos casos, o reprodutor de mídia é responsável por lidar com logouts de usuários por meio de uma simples API do Access Enabler. Quando você chama logout(), o Access Enabler faz o seguinte:

Se o usuário deixar a máquina ociosa por tempo suficiente para que os tokens expirem, ele ainda poderá retornar à sessão e iniciar o logout com êxito. A autenticação da Adobe Pass garante que todos os tokens sejam excluídos e notifica o MVPD para excluir sua sessão também.

Quando o logout é iniciado a partir de um site que não está integrado à Autenticação Adobe Pass, o MVPD pode chamar o serviço de Logout único da Autenticação Adobe Pass por meio de um redirecionamento do navegador.

Compreensão das IDs de usuário user-ids

Conceitualmente, cada usuário que inicia um fluxo de direitos é associado a uma ID de usuário única. No entanto, durante um fluxo de direitos, essa ID de usuário pode ser apresentada de diferentes maneiras, dependendo da API da qual você obtém a ID.

O sessionGUID no token de mídia curta é a forma segura da ID de usuário, que está disponível por meio da chamada sendTrackingData(). Em todas as integrações atuais, esse é um GUID persistente para o usuário no tempo e nos dispositivos, mas a origem do GUID começa com o UserID na resposta SAML do MVPD. No entanto, alguns MVPDs podem mudar de ideia no futuro e começar a enviar um GUID transitório. Se um Programador quiser garantir que a UserID de origem do MVPD na resposta do AuthN seja persistente, ele deverá providenciar isso em seus contratos com os MVPDs.

Estas são as diferentes maneiras de representar a ID de usuário nas APIs de autenticação da Adobe Pass:

Em conclusão

A forma como você usa a ID de usuário depende do caso de uso: