DocumentaçãoAdobe PassAdobe Pass Authentication

Fluxos de acesso degradados

Última atualização: 5 de março de 2025
  • Tópicos:
  • Authentication
IMPORTANT
O conteúdo desta página é fornecido apenas para fins informativos. O uso desta API requer uma licença atual da Adobe. Não é permitida nenhuma utilização não autorizada.
IMPORTANT
A implementação da REST API V2 é limitada pela documentação do Mecanismo de limitação.
Related Articles
Visite também as Perguntas frequentes sobre a REST API V2.

A degradação fornece o desvio temporário de endpoints específicos de autenticação e autorização do MVPD. Normalmente, o Programador inicia essa ação, mas independentemente de quem aciona um evento de degradação, a ação depende de acordos anteriores feitos com os MVPDs afetados.

Para obter mais detalhes sobre o recurso de Degradação, consulte a documentação de Degradação.

Os fluxos de acesso degradados permitem consultar os seguintes cenários:

  • Executar autenticação enquanto a degradação é aplicada
  • Recuperar decisões de autorização enquanto a degradação é aplicada
  • Recuperar decisões de pré-autorização enquanto a degradação é aplicada
  • Recuperar perfil enquanto a degradação é aplicada

Executar autenticação enquanto a degradação é aplicada

Pré-requisitos

Antes de executar o fluxo de autenticação enquanto a degradação é aplicada, verifique se os seguintes pré-requisitos foram atendidos:

  • O aplicativo de streaming deve iniciar uma sessão de autenticação quando precisar entrar com a MVPD.
IMPORTANT
Suposições
  • O aplicativo de transmissão não tem um perfil válido para esse MVPD específico salvo no back-end do Adobe Pass.
  • Há uma regra de degradação AuthNAll aplicada à integração entre os serviceProvider e mvpd fornecidos.

Fluxo de trabalho (WRK)

Siga as etapas fornecidas para implementar o fluxo de autenticação enquanto a degradação é aplicada, conforme mostrado no diagrama a seguir.

Executar autenticação enquanto a degradação é aplicada

Executar autenticação enquanto a degradação é aplicada

  1. Criar sessão de autenticação: o aplicativo de streaming reúne todos os dados necessários para iniciar uma sessão de autenticação chamando o ponto de extremidade Sessões.

    IMPORTANT
    Consulte a documentação da API Criar sessão de autenticação para obter detalhes sobre:
    • Todos os parâmetros necessários, como serviceProvider, mvpd, domainName e redirectUrl
    • Todos os cabeçalhos necessários, como Authorization e AP-Device-Identifier
    • Todos os parâmetros e cabeçalhos opcionais

  2. Verificar regras de degradação: o servidor Adobe Pass verifica se há uma regra de degradação AuthNAll aplicada à integração entre o serviceProvider e o mvpd fornecidos.

  3. Indique a próxima ação: A resposta do ponto de extremidade Sessions contém os dados necessários para orientar o aplicativo de streaming em relação à próxima ação:

    • O atributo actionName está definido como "autorize".
    • O atributo actionType está definido como "direto".
    IMPORTANT
    Consulte a documentação da API Criar sessão de autenticação para obter detalhes sobre as informações fornecidas na resposta da sessão.
    O endpoint de Sessõ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 o mvpd fornecidos deve estar ativa.
    Se a validação básica falhar, uma resposta de erro será gerada, fornecendo informações adicionais que seguem a documentação de Códigos de erro aprimorados.
    O endpoint de Sessões usa os dados da solicitação para verificar se as condições de acesso degradadas são atendidas:
    • A integração entre o serviceProvider e o mvpd fornecidos deve ter uma regra de degradação AuthNAll aplicada.
    Se a validação de acesso degradado falhar, a resposta assumirá como padrão o fluxo de autenticação básico.

  4. Continuar com fluxos de decisões: o aplicativo de streaming pode continuar com fluxos de decisões subsequentes.

Recuperar decisões de autorização enquanto a degradação é aplicada

Pré-requisitos

Antes de recuperar decisões de autorização enquanto a degradação é aplicada, verifique se os seguintes pré-requisitos foram atendidos:

  • O aplicativo de streaming deve recuperar uma decisão de autorização antes de reproduzir um recurso selecionado pelo usuário.
IMPORTANT
Suposições
  • O aplicativo de streaming não tem um perfil válido para esse MVPD específico.
  • Há uma regra de degradação AuthZAll ou AuthNAll aplicada à integração entre o serviceProvider fornecido e mvpd.

Fluxo de trabalho (WRK)

Siga as etapas fornecidas para implementar o fluxo de autorização enquanto a degradação é aplicada, conforme mostrado no diagrama a seguir.

Recuperar decisões de autorização enquanto a degradação é aplicada

Recuperar decisões de autorização enquanto a degradação é aplicada

  1. 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 e resources
    • Todos os cabeçalhos necessários, como Authorization e AP-Device-Identifier
    • Todos os parâmetros e cabeçalhos opcionais

  2. Verificar regras de degradação: o servidor Adobe Pass verifica se há uma regra de degradação AuthZAll ou AuthNAll aplicada à integração entre o serviceProvider e o mvpd fornecidos.

  3. 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ão Permit 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 o mvpd fornecidos deve estar ativa.
    Se a validação básica falhar, uma resposta de erro será gerada, fornecendo informações adicionais que seguem a documentação de Códigos de erro aprimorados.
    O endpoint de autorização de decisões usa os dados da solicitação para verificar se as condições de acesso degradadas são atendidas:
    • A integração entre o serviceProvider e o mvpd fornecidos deve ter uma regra de degradação AuthZAll ou AuthNAll aplicada.
    Se a validação de acesso degradado falhar, a resposta assumirá como padrão o fluxo de autorização básico.

  4. Iniciar fluxo com token de mídia: O aplicativo de streaming usa o token de mídia para reproduzir o conteúdo.

Recuperar decisões de pré-autorização enquanto a degradação é aplicada

Pré-requisitos

Antes de recuperar decisões de pré-autorização enquanto a degradação é aplicada, verifique se os seguintes pré-requisitos foram atendidos:

  • O aplicativo de transmissão deseja recuperar as decisões de pré-autorização para exibir uma lista de recursos junto com seus status associados.
IMPORTANT
Suposições
  • O aplicativo de streaming não tem um perfil válido para esse MVPD específico.
  • Há uma regra de degradação AuthZAll ou AuthNAll aplicada à integração entre o serviceProvider fornecido e mvpd.

Fluxo de trabalho (WRK)

Siga as etapas fornecidas para implementar o fluxo de pré-autorização enquanto a degradação é aplicada, conforme mostrado no diagrama a seguir.

Recuperar decisões de pré-autorização enquanto a degradação é aplicada

Recuperar decisões de pré-autorização enquanto a degradação é aplicada

  1. Recuperar decisões de pré-autorização: O aplicativo de streaming reúne todos os dados necessários para obter decisões de pré-autorização para uma lista de recursos, chamando o ponto de extremidade de Pré-autorização de Decisões.

    IMPORTANT
    Consulte a Recuperar decisões de pré-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 e resources
    • Todos os cabeçalhos necessários, como Authorization e AP-Device-Identifier
    • Todos os parâmetros e cabeçalhos opcionais

  2. Verificar regras de degradação: o servidor Adobe Pass verifica se há uma regra de degradação AuthZAll ou AuthNAll aplicada à integração entre o serviceProvider e o mvpd fornecidos.

  3. Retornar decisões de pré-autorização: A resposta de Ponto de Extremidade de Pré-autorização de Decisões contém uma decisão Permit para cada recurso.

    IMPORTANT
    Consulte a Recuperar decisões de pré-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 pré-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 o mvpd fornecidos deve estar ativa.
    Se a validação básica falhar, uma resposta de erro será gerada, fornecendo informações adicionais que seguem a documentação de Códigos de erro aprimorados.
    O endpoint de pré-autorização de decisões usa os dados da solicitação para verificar se as condições de acesso degradadas são atendidas:
    • A integração entre o serviceProvider e o mvpd fornecidos deve ter uma regra de degradação AuthZAll ou AuthNAll aplicada.
    Se a validação de acesso degradado falhar, a resposta assumirá como padrão o fluxo básico de pré-autorização.

  4. Manipular decisões de pré-autorização: o aplicativo de streaming processa a resposta e pode usá-la para exibir, opcionalmente, o status apropriado para cada recurso na interface do usuário.

Recuperar perfil enquanto a degradação é aplicada

IMPORTANT
A consulta de endpoint de Perfis é opcional enquanto a degradação é aplicada.
A resposta do endpoint Sessions instrui o aplicativo a continuar com os fluxos de decisão enquanto a degradação é aplicada. Para obter mais detalhes, consulte a seção Executar autenticação enquanto a degradação é aplicada.

Pré-requisitos

Antes de recuperar o perfil de um MVPD específico enquanto a degradação é aplicada, verifique se os seguintes pré-requisitos foram atendidos:

  • O aplicativo de streaming, que tem um identificador mvpd selecionado ou armazenado em cache, deseja recuperar o perfil de um MVPD específico.
IMPORTANT
Suposições
  • O aplicativo de streaming não tem um perfil válido para esse MVPD específico.
  • Há uma regra de degradação AuthNAll aplicada à integração entre os serviceProvider e mvpd fornecidos.

Fluxo de trabalho (WRK)

Siga as etapas fornecidas para implementar o fluxo de recuperação de perfil para um MVPD específico, enquanto a degradação é aplicada, conforme mostrado no diagrama a seguir.

Recuperar perfil enquanto a degradação é aplicada

Recuperar perfil enquanto a degradação é aplicada

  1. Recuperar perfil para mvpd específico: O aplicativo de streaming reúne todos os dados necessários para recuperar informações de perfil para esse MVPD específico, enviando uma solicitação ao ponto de extremidade de Perfis.

    IMPORTANT
    Consulte a Recuperar perfil para a documentação específica da API mvpd para obter detalhes sobre:
    • Todos os parâmetros necessários, como serviceProvider e mvpd
    • Todos os cabeçalhos necessários, como Authorization e AP-Device-Identifier
    • Todos os parâmetros e cabeçalhos opcionais

  2. Verificar regras de degradação: o servidor Adobe Pass verifica se há uma regra de degradação AuthNAll aplicada à integração entre o serviceProvider e o mvpd fornecidos.

  3. Retornar informações sobre o perfil degradado: A resposta do ponto de extremidade Profiles contém informações sobre o perfil degradado, incluindo o atributo type definido como "degradado".

    IMPORTANT
    Consulte a Recuperar perfil para a documentação específica da API do mvpd para obter detalhes sobre as informações fornecidas na resposta do perfil.
    O endpoint de Perfis 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 o mvpd fornecidos deve estar ativa.
    Se a validação básica falhar, uma resposta de erro será gerada, fornecendo informações adicionais que seguem a documentação de Códigos de erro aprimorados.
    O endpoint de Perfis usa os dados da solicitação para verificar se as condições de acesso degradadas são atendidas:
    • A integração entre o serviceProvider e o mvpd fornecidos deve ter uma regra de degradação AuthNAll aplicada.
    Se a validação de acesso degradado falhar, a resposta assumirá como padrão o fluxo básico de recuperação do perfil.

  4. Continuar com fluxos de decisões: Se a resposta do ponto de extremidade Perfis contiver um perfil, o aplicativo de streaming usará as informações de perfil degradadas para continuar com os fluxos de decisões subsequentes.

  5. Indicar novo fluxo de autenticação básico: Se a resposta do ponto de extremidade Perfis não contiver um perfil, o aplicativo de streaming indicará ao usuário que ele iniciará um novo fluxo de autenticação básico.

NOTE
As etapas do fluxo de recuperação de perfil para um código de autenticação específico são as mesmas descritas acima, exceto que o ponto de extremidade usado é o descrito na documentação Recuperar perfil para código específico.
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b