Temp Pass Promocional promotional-temp-pass
Resumo dos recursos feature-summary
O Temp Pass promocional permite que os programadores ofereçam acesso temporário a seu conteúdo protegido para usuários que não tenham credenciais de conta com um MVPD.
O Temp Pass Promocional foi projetado para ser usado para executar campanhas promocionais em que um usuário, após fornecer informações de identificação válidas (por exemplo, endereço de email) para o Programador, poderá consumir um número predefinido de títulos de VOD diferentes por um período predefinido.
O Temp Pass Promocional é criado sobre o recurso Temp Pass, o que significa que ele inclui toda a funcionalidade Temp Pass.
Quando o número máximo predefinido de títulos de VOD ou o período predefinido for excedido, esse usuário não poderá acessar o conteúdo no mesmo dispositivo ou usando as mesmas informações de identificador do usuário (por exemplo, endereço de email) até que os tokens de autorização sejam apagados do servidor de autenticação da Adobe Pass.
Comparação entre Aprovação Temporária e Aprovação Temporária Promocional tp-ptp-comparison
Acesso ao conteúdo
- baseado em tempo
Acesso ao conteúdo
- baseado em tempo
- com base no número de recursos
Segurança de acesso baseada em
- ID do dispositivo
Segurança baseada em
- ID do dispositivo
- hash sobre as informações do identificador do usuário fornecidas (por exemplo, email)
Detalhes do recurso feature-details
Esse recurso permite que os usuários acessem o conteúdo promocional de um dispositivo específico (telefone e tablet) após terem fornecido informações exclusivas, como o endereço de email, no aplicativo do Programador.
O Programador fornecerá um hash sobre a PII do usuário nas APIs de autenticação e autorização. Esse hash será usado junto com a ID do dispositivo na geração de uma chave exclusiva para identificar o usuário e o dispositivo.
Com base na ID do dispositivo e nas informações fornecidas pelo usuário e seguindo a lógica abaixo, a autenticação da Adobe Pass determinará se o usuário está em uma nova avaliação ou em uma existente:
- novo hash sobre informações fornecidas pelo usuário (por exemplo, e-mail), nova ID de dispositivo => nova avaliação
- hash existente sobre informações fornecidas pelo usuário (por exemplo, email), nova ID de dispositivo => avaliação existente (com hash existente sobre informações fornecidas pelo usuário (por exemplo, email))
- novo hash sobre informações fornecidas pelo usuário (por exemplo, email), ID do dispositivo existente => avaliação existente (com ID do dispositivo existente)
- hash existente em relação às informações fornecidas pelo usuário (por exemplo, e-mail), ID do dispositivo existente => avaliação existente
O recurso de Aprovação Temporária Promocional pode ser configurado com base nas seguintes propriedades:
- Chave de informações fornecida pelo usuário (por exemplo, email)
- Número de recursos que o usuário está autorizado a consumir
- TTL - o intervalo de tempo em que o usuário tem direito a consumir o número configurado de recursos
Metadados do usuário user-metadata
Para facilitar a implementação do aplicativo do Programador, as informações de metadados do usuário a seguir são expostas no Passo de Temp Promocional, com as chaves correspondentes (para ativar as chaves, contate tve-support@adobe.com):
- remaining_resources: o número de recursos restantes que o usuário atual está autorizado a consumir
- used_assets: a lista de recursos que o usuário atual já consumiu
- expiration_date: a data de expiração do usuário atual
Como o tempo de exibição é calculado? compute-viewing-time
O tempo em que uma Aprovação Temporária permanece válida não está correlacionado à quantidade de tempo que um usuário gasta visualizando o conteúdo no aplicativo do Programador. Após a solicitação inicial de autorização do usuário por meio do Passo de Temp Promocional, uma hora de expiração é calculada adicionando a hora inicial da solicitação atual ao TTL (intervalo de tempo de duração) especificado pelo Programador.
Autenticação e autorização authn-authz
Para fluxos de Aprovação Temp Promocional, a autenticação e a autorização não se comunicam com um MVPD real, portanto, todas as solicitações de autorização serão bem-sucedidas desde que todas essas condições sejam atendidas:
- os tokens de autorização são válidos para recursos especificados
- o número de used_assets é menor do que o limite definido pelo Programador
- O valor de expiration_date é posterior à data atual.
Comportamento de comprovação preflight-beh
Quando uma solicitação de comprovação ou pré-autorização é feita para um MVPD de aprovação temporária promocional, a resposta de Comprovação correspondente retornada conterá toda a lista de recursos da Solicitação de comprovação como comprovação bem-sucedida.
A lógica por trás disso é: as condições de autorização da Aprovação Temporária Promocional são baseadas no limite de tempo e número de recursos, em vez de recursos específicos. Mais especificamente, desde que a restrição de tempo seja atendida e o limite de recursos não seja excedido, os recursos chamados serão autorizados.
SSO sso
O SSO não está habilitado para instâncias de Aprovação Temporária Promocional, que está configurada com a opção "Autenticação por Solicitante" habilitada. Isso significa que quando o usuário alternar do aplicativo A para outro aplicativo B, ambos integrados com o mesmo Passe de temperatura promocional, o usuário não entrará automaticamente.
Sair logout
Todos os tokens em um dispositivo são excluídos ao fazer logoff. Portanto, a alternância do Passe Temp Promocional para um MVPD regular selecionado pelo usuário não deve depender dessa implementação. A recomendação é usar a função setSelectedProvider(null) para limpar o estado do aplicativo e reiniciar o fluxo de autenticação, que tem uma melhor experiência de usuário.
Diagrama de fluxo de passagem temporária promocional promo-tempass-flowdia
Figura: Fluxo de passagem temporária promocional
Implementar Aprovação Temporária Promocional impl-promo-tempass
O Temp Pass Promocional requer as seguintes funcionalidades do lado do cliente:
- Informações sobre o identificador do usuário, por exemplo, propagação de endereço de email (envio do endereço de email do usuário nos fluxos de autenticação e autorização). O email é exigido pela Autenticação Adobe Pass para associar os tokens de autenticação e autorização (semelhante ao caso de
device_ID, exigido em todas as chamadas). - Forçar autenticação - permitindo que o Programador force um fluxo de autenticação quando o usuário já estiver autenticado. Essa funcionalidade é necessária para forçar uma atualização de metadados do usuário (a chave de metadados do usuário used_assets contém o número de recursos disponíveis) sempre que o aplicativo é iniciado. Como o usuário pode fazer logon em vários dispositivos, os metadados de usuário presentes no dispositivo durante a inicialização do aplicativo não são confiáveis, e precisamos atualizá-los para refletir o estado atual desse usuário específico (identificado pelo endereço de email).
A Autenticação do Adobe Pass não tem um mecanismo integrado para interromper o streaming gratuito após X minutos. A Autenticação do Adobe Pass deixará de emitir os tokens de autorização e mídia curta assim que o usuário consumir os recursos livres de Y. Cabe aos programadores restringir o acesso assim que o passe temporário promocional expirar.
Segurança security
Hash de informações do identificador do usuário
O Adobe recomenda usar a família SHA-2 ou suas funções SHA-256 e SHA-512 específicas nos dados antes de enviá-los para o Adobe.
Por exemplo, SHA-256 sobre "user@domain.com" é "f7ee5ec7312165148b69fcca1d29075b14b8aef0b5048a332b88b88d09069fb7".
Redefinir ou limpar Aprovação Temporária Promocional reset-promo-tempass
Certas regras de negócios exigem uma limpeza regular do Passe Temporário Promocional. Para fazer isso, a Autenticação Adobe Pass fornece aos Programadores uma API da Web pública, descrita abaixo:
DELETE https://mgmt.auth.adobe.com/reset-tempass/v2/reset-
Protocolo: https
-
Host:
- Versão: mgmt.auth.adobe.com
- Pré-Igual: mgmt-prequal.auth.adobe.com
-
Caminho: /reset-tempass/v2/reset
-
Parâmetros de consulta: device_id=all&requestor_id=THE_REQUESTOR_ID&mvpd_id=THE_TEMPASS_MVPD_ID
-
cabeçalhos: ApiKey: 1232293681726481
-
Resposta:
- Sucesso: HTTP 204
- Falha: HTTP 400 para solicitações incorretas, HTTP 401 se ApiKey não for especificada, HTTP 403 se ApiKey for inválida
Além dos requisitos para limpar a Aprovação Temporária, a Aprovação Temporária Promocional usa o hash sobre as informações do identificador do usuário enviadas como generic_data na autenticação e autorização para limpeza.
O hash será enviado, não todo o JSON:
$ curl -X DELETE -H "Authorization:Bearer H4j7cF3GtJX81BrsgDa10GwSizVz" "https://mgmt.auth.adobe.com/reset-tempass/v2.1/reset/generic?key=f7ee5ec7312165148b69fcca1d29075b14b8aef0b5048a332b18b88d09069fb7&requestor_id=REF&mvpd_id=FlexibleTempPass"
Clientes compatíveis supported-clients
Limitação limitations
Esta seção descreve as limitações que se aplicam à implementação atual do Passe Temp Promocional.
Sem cliente lim-clientless
Dispositivos inteligentes sem uma Identificação de Dispositivo Exclusiva
Nem todos os aplicativos de dispositivos inteligentes podem fornecer uma ID de dispositivo exclusiva. Na ausência de uma, a Autenticação do Adobe Pass pode usar a UUID gerada pelo Serviço de código de registro de Adobe como a ID exclusiva do dispositivo. Isso significa que, quando o usuário sair, os tokens de autenticação e autorização serão excluídos. Depois que o usuário tentar autenticar novamente, desta vez com diferentes informações do usuário (por exemplo, email), ele poderá autorizar novamente. A Adobe recomenda adicionar um fluxo de interface do usuário que não permitirá que um usuário "engane" o sistema e adicione lógica para determinar se é um novo usuário que está solicitando uma avaliação ou uma avaliação existente.
Redefinindo/limpando Passagem Temporária
Redefinir Temp Pass para Clientless não está disponível nos casos específicos do Xbox360 e do Xbox One, porque essas plataformas exigem análise adicional da ID do dispositivo, não é possível na ferramenta Redefinir Temp Pass.