DocumentaçãoAdobe PassAdobe Pass Authentication

Guia do Apple SSO (REST API V2) apple-sso-cookbook-rest-api-v2

Last update: Wed Nov 13 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
IMPORTANT
O conteúdo desta página é fornecido apenas para fins informativos. O uso desta API requer uma licença atual do Adobe. Não é permitida nenhuma utilização não autorizada.

A API REST V2 de autenticação do Adobe Pass tem suporte para Logon único de parceiro (SSO) para usuários finais de aplicativos clientes em execução no iOS, iPadOS ou tvOS.

Este documento atua como uma extensão para a Visão geral da REST API V2 existente, que fornece uma exibição de alto nível e o documento que descreve como implementar o Logon único usando fluxos de parceiros.

Logon único do Apple usando fluxos de parceiros cookbook

Pré-requisitos prerequisites

Antes de prosseguir com o logon único da Apple usando fluxos de parceiros, verifique se os seguintes pré-requisitos foram atendidos:

  • O aplicativo de streaming deve coletar todos os dados necessários exigidos pelos cabeçalhos X-Device-Info e/ou User-Agent, de modo que o back-end de Autenticação do Adobe Pass possa identificar a plataforma do dispositivo e seus recursos. Para obter mais detalhes sobre o cabeçalho X-Device-Info, consulte a documentação X-Device-Info.

  • O aplicativo de streaming deve solicitar acesso às informações de assinatura do usuário salvas no nível do dispositivo, para o qual o usuário deve dar permissão ao aplicativo para continuar, de modo semelhante a fornecer acesso à câmera ou ao microfone do dispositivo. Esta permissão deve ser solicitada por aplicativo usando a Estrutura de Conta de Assinante de Vídeo da Apple, e o dispositivo salvará a seleção do usuário.

    Recomendamos incentivar os usuários que se recusam a conceder permissão para acessar informações de assinatura explicando os benefícios da experiência do usuário de logon único do Apple, mas esteja ciente de que o usuário pode alterar sua decisão acessando as configurações do aplicativo (acesso de permissão do Provedor de TV) ou Settings -> TV Provider no iOS e iPadOS ou Settings -> Accounts -> TV Provider no tvOS.

    O aplicativo de streaming pode solicitar a permissão do usuário quando o aplicativo entrar no estado de primeiro plano, pois o aplicativo pode verificar a permissão para acessar as informações de assinatura do usuário a qualquer momento antes de exigir autenticação do usuário.

IMPORTANT
Suposições
  • O aplicativo de streaming concluiu os pré-requisitos de integração que se aplicam a um Programador e são necessários para habilitar a experiência de usuário de logon único do Apple.

Fluxo de trabalho (WRK) workflow

Execute as etapas fornecidas para implementar o logon único do Apple usando fluxos de parceiros conforme mostrado no diagrama a seguir.

logon único do Apple usando fluxos de parceiros

logon único do Apple usando fluxos de parceiros

A Fase de registro

  1. Recuperar credenciais do cliente: O aplicativo de streaming reúne todos os dados necessários para recuperar credenciais do cliente chamando o ponto de extremidade de Registro do Cliente.

    note important
    IMPORTANT
    Consulte a documentação da API Recuperar credenciais do cliente para obter detalhes sobre:
    • Todos os parâmetros necessários, como software_statement
    • Todos os cabeçalhos necessários, como Content-Type, X-Device-Info
    • Todos os parâmetros e cabeçalhos opcionais

  2. Retornar credenciais de cliente: A resposta do ponto de extremidade do Registro do Cliente contém informações sobre as credenciais de cliente associadas aos parâmetros e cabeçalhos recebidos.

    note important
    IMPORTANT
    Consulte a documentação da API Recuperar credenciais do cliente para obter detalhes sobre as informações fornecidas em uma resposta de credenciais do cliente.
    O Registro do cliente 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.
    Se a validação falhar, uma resposta de erro será gerada, fornecendo informações adicionais que seguem a Recuperar credenciais do cliente documentação da API.
    note tip
    TIP
    Sugestão: As credenciais do cliente devem ser armazenadas em cache e podem ser usadas indefinidamente.

  3. Recuperar token de acesso: o aplicativo de streaming reúne todos os dados necessários para recuperar o token de acesso chamando o ponto de extremidade Token do Cliente.

    note important
    IMPORTANT
    Consulte a documentação da API Recuperar token de acesso para obter detalhes sobre:
    • Todos os parâmetros necessários, como client_id, client_secret e grant_type
    • Todos os cabeçalhos necessários, como Content-Type, X-Device-Info
    • Todos os parâmetros e cabeçalhos opcionais

  4. Retornar token de acesso: A resposta do ponto de extremidade do Token do Cliente contém informações sobre o token de acesso associado aos parâmetros e cabeçalhos recebidos.

    note important
    IMPORTANT
    Consulte a documentação da API Recuperar token de acesso para obter detalhes sobre as informações fornecidas em uma resposta de token de acesso.
    O token do cliente 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.
    Se a validação falhar, uma resposta de erro será gerada, fornecendo informações adicionais que seguem a Recuperar token de acesso documentação da API.
    note tip
    TIP
    Sugestão: o token de acesso deve ser armazenado em cache e usado somente dentro da duração especificada (por exemplo, tempo de vida útil de 24 horas). Após a expiração, o aplicativo de streaming deve solicitar um novo token de acesso.
B Verificar fase de autenticação

  1. Recuperar status da estrutura do parceiro: O aplicativo de streaming chama a Estrutura da Conta de Assinante de Vídeo desenvolvida pela Apple para obter permissões de usuário e informações do provedor.

    note important
    IMPORTANT
    Consulte a documentação da Estrutura da Conta de Assinante de Vídeo para obter detalhes sobre:
    • O aplicativo de streaming deve verificar a permissão para acessar as informações de assinatura do usuário e continuar somente se o usuário permitir.
    • O aplicativo de streaming deve fornecer um delegado para o VSAccountManager.
    • O aplicativo de streaming deve enviar uma solicitação para obter informações sobre a conta do assinante.
    • O aplicativo de streaming deve aguardar e processar as informações de metadados.
    O aplicativo de streaming deve garantir que ele especifique um valor booliano igual a false para a propriedade isInterruptionAllowed no objeto VSAccountMetadataRequest, para indicar que o usuário não pode ser interrompido nesta fase.

  2. Retornar informações de status da estrutura do parceiro: o aplicativo de streaming valida os dados de resposta para garantir que as condições básicas sejam atendidas:

    • O status de acesso da permissão do usuário é concedido.
    • O identificador de mapeamento do provedor do usuário está presente e é válido.
    • A data de expiração do perfil do provedor do usuário (se disponível) é válida.

  3. Recuperar perfis: o aplicativo de streaming reúne todos os dados necessários para recuperar todas as informações de perfil, enviando uma solicitação ao ponto de extremidade Perfis.

    note important
    IMPORTANT
    Consulte a documentação da API Recuperar perfis para obter detalhes sobre:
    • Todos os parâmetros necessários, como serviceProvider
    • Todos os cabeçalhos necessários, como Authorization, AP-Device-Identifier e AP-Partner-Framework-Status
    • Todos os parâmetros e cabeçalhos opcionais
    O aplicativo de transmissão deve garantir que inclua um valor válido para o status da estrutura do parceiro, de modo que a resposta recuperada possa incluir um perfil de tipo "appleSSO".
    Para obter mais detalhes sobre o cabeçalho AP-Partner-Framework-Status, consulte a documentação AP-Partner-Framework-Status.

  4. Retorne informações sobre os perfis encontrados: A resposta do ponto de extremidade Perfis contém informações sobre os perfis encontrados associados aos parâmetros e cabeçalhos recebidos.

  5. Escolha um perfil e prossiga com os fluxos de decisões: Se a resposta do ponto de extremidade Perfis contiver perfis, o aplicativo de streaming usará sua lógica interna (eventualmente interagindo com o usuário final) para escolher um dos perfis disponíveis para continuar com os fluxos de decisões subsequentes.

  6. Continuar com o fluxo de autenticação de parceiro: Se a resposta do ponto de extremidade Perfis não contiver um perfil, o aplicativo de streaming continuará com o fluxo de autenticação de parceiro.

C. Fase de autenticação de parceiro

  1. Recuperar configuração: o aplicativo de streaming reúne todos os dados necessários para recuperar a lista de MVPDs com integração ativa, enviando uma solicitação ao ponto de extremidade de Configuração.

    note important
    IMPORTANT
    Consulte a documentação da API Recuperar configuração para provedor de serviços específico para obter detalhes sobre:
    • Todos os parâmetros necessários, como serviceProvider
    • Todos os cabeçalhos necessários, como Authorization, AP-Device-Identifier e X-Device-Info
    • Todos os parâmetros e cabeçalhos opcionais

  2. Retornar configuração: A resposta do ponto de extremidade de Configuração contém informações sobre os MVPDs que têm uma integração ativa com o provedor de serviços.

    note important
    IMPORTANT
    Consulte a documentação da API Recuperar configuração para provedor de serviços específico para obter detalhes sobre as informações fornecidas em uma resposta de configuração.
    O endpoint de Configuração 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.
    Se a validação falhar, uma resposta de erro será gerada, fornecendo informações adicionais que seguem os códigos de erro aprimorados
    note important
    IMPORTANT
    O aplicativo de streaming deve garantir que ele processe os seguintes detalhes fornecidos para cada MVPD ao continuar:
    • enablePlatformServices: indica se o MVPD oferece suporte ao logon único da Apple no momento.
    • displayInPlatformPicker: indica se o MVPD pode ser exibido no seletor de Apple.
    • boardingStatus: indica se o MVPD está integrado no logon único do Apple.

  3. Recuperar status da estrutura do parceiro: O aplicativo de streaming chama a Estrutura da Conta de Assinante de Vídeo desenvolvida pela Apple para obter permissões de usuário e informações do provedor.

    note important
    IMPORTANT
    Consulte a documentação da Estrutura da Conta de Assinante de Vídeo para obter detalhes sobre:
    • O aplicativo de streaming deve verificar a permissão para acessar as informações de assinatura do usuário e continuar somente se o usuário permitir.
    • O aplicativo de streaming deve fornecer um delegado para o VSAccountManager.
    • O aplicativo de streaming deve enviar uma solicitação para obter informações sobre a conta do assinante.
    • O aplicativo de streaming deve aguardar e processar as informações de metadados.
    O aplicativo de streaming deve garantir que ele especifique um valor booliano igual a true para a propriedade isInterruptionAllowed no objeto VSAccountMetadataRequest, para indicar que o usuário pode ser interrompido para selecionar o provedor de TV nesta fase.

  4. Retornar informações de status da estrutura do parceiro: o aplicativo de streaming valida os dados de resposta para garantir que as condições básicas sejam atendidas:

    • O status de acesso da permissão do usuário é concedido.
    • O identificador de mapeamento do provedor do usuário está presente e é válido.
    • A data de expiração do perfil do provedor do usuário (se disponível) é válida.

  5. Recuperar solicitação de autenticação do parceiro: o aplicativo de streaming reúne todos os dados necessários para iniciar uma sessão de autenticação chamando o ponto de extremidade Parceiro de Sessões.

    note important
    IMPORTANT
    Consulte a Recuperar solicitação de autenticação do parceiro documentação da API para obter detalhes sobre:
    • Todos os parâmetros necessários, como serviceProvider e partner
    • Todos os cabeçalhos necessários como Authorization, AP-Device-Identifier, Content-Type, X-Device-Info e AP-Partner-Framework-Status
    • Todos os cabeçalhos e parâmetros opcionais
    O aplicativo de streaming deve garantir que inclua um valor válido para o status da estrutura do parceiro, de modo que a resposta recuperada possa incluir uma solicitação de autenticação do parceiro (solicitação SAML).
    Para obter mais detalhes sobre o cabeçalho AP-Partner-Framework-Status, consulte a documentação AP-Partner-Framework-Status.

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

    note important
    IMPORTANT
    Consulte a Recuperar solicitação de autenticação do parceiro documentação da API para obter detalhes sobre as informações fornecidas na resposta da sessão.
    O endpoint do Parceiro 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 do Parceiro de sessões valida os dados da solicitação para garantir que as condições de logon único do parceiro sejam atendidas:
    • A configuração de logon único do parceiro no servidor do Adobe Pass deve ser válida e ativada.
    • A carga de status da estrutura do parceiro recebida por meio do cabeçalho AP-Partner-Framework-Status deve ser válida.
    Se a validação do logon único do parceiro falhar, a resposta assumirá como padrão o fluxo de autenticação básico.

  7. Continuar com fluxos de decisões: A resposta do ponto de extremidade do Parceiro de Sessões contém os seguintes dados:

    • O atributo actionName está definido como "autorize".
    • O atributo actionType está definido como "direto".

    Se o back-end do Adobe Pass identificar um perfil válido, o aplicativo de transmissão não precisará reautenticar com o MVPD selecionado, pois já existe um perfil que pode ser usado para fluxos de decisões subsequentes.

  8. Continuar com o fluxo de autenticação básico: A resposta do ponto de extremidade do Parceiro de Sessões contém os seguintes dados:

    • O atributo actionName está definido como "autenticar" ou "retomar".
    • O atributo actionType está definido como "interativo" ou "direto".

    Se o back-end do Adobe Pass não identificar um perfil válido e a validação do logon único do parceiro falhar, o servidor do Adobe Pass voltará ao fluxo de autenticação básico.

    Para obter mais detalhes sobre o fluxo de autenticação básico, consulte os seguintes documentos:

  9. Continue com a recuperação do perfil usando o fluxo de resposta de autenticação de parceiro: A resposta do ponto de extremidade do Parceiro de Sessões contém os seguintes dados:

    • O atributo actionName está definido como "partner_profile".
    • O atributo actionType está definido como "direto".
    • O atributo authenticationRequest - type inclui o protocolo de segurança usado pela estrutura do parceiro para logon MVPD (atualmente definido somente como SAML).
    • O atributo authenticationRequest - request inclui a solicitação SAML passada para a estrutura do parceiro.
    • O atributo authenticationRequest - attributesNames inclui os atributos SAML passados para a estrutura do parceiro.

    Se o back-end do Adobe Pass não identificar um perfil válido e a validação de logon único de parceiro passar, o aplicativo de streaming receberá uma resposta com ações e dados para transmitir à estrutura do parceiro para iniciar o fluxo de autenticação com o MVPD.

  10. Conclua a autenticação MVPD com a estrutura do parceiro: Encaminhe a solicitação de autenticação do parceiro (solicitação SAML) obtida na etapa anterior para a Estrutura de Conta de Assinante de Vídeo. Se o fluxo de autenticação for bem-sucedido, a Estrutura de Conta de Assinante de Vídeo interação com o MVPD produz uma resposta de autenticação de parceiro (resposta SAML) que é retornada juntamente com as informações de status da estrutura de parceiro.

    note important
    IMPORTANT
    Consulte a documentação da Estrutura da Conta de Assinante de Vídeo para obter detalhes sobre:
    • O aplicativo de streaming deve verificar a permissão para acessar as informações de assinatura do usuário e continuar somente se o usuário permitir.
    • O aplicativo de streaming deve fornecer um delegado para o VSAccountManager.
    • O aplicativo de streaming deve enviar uma solicitação para informações de conta de assinante e incluir a solicitação de autenticação de parceiro (solicitação SAML) obtida na etapa anterior.
    • O aplicativo de streaming deve aguardar e processar as informações de metadados.
    O aplicativo de streaming deve garantir que ele especifique um valor booliano igual a true para a propriedade isInterruptionAllowed no objeto VSAccountMetadataRequest, para indicar que o usuário pode ser interrompido para autenticação com o provedor de TV selecionado nesta fase.

  11. Resposta de autenticação de parceiro de retorno: o aplicativo de streaming valida os dados de resposta para garantir que as condições básicas sejam atendidas:

    • O status de acesso da permissão do usuário é concedido.
    • O identificador de mapeamento do provedor do usuário está presente e é válido.
    • A data de expiração do perfil do provedor do usuário (se disponível) é válida.
    • A resposta de autenticação de parceiro (resposta SAML) está presente e é válida.

  12. Recuperar perfil usando a resposta de autenticação de parceiro: O aplicativo de streaming reúne todos os dados necessários para criar e recuperar um perfil, chamando o ponto de extremidade Parceiro de Perfis.

    note important
    IMPORTANT
    Consulte a documentação da API Recuperar perfil usando a resposta de autenticação de parceiro para obter detalhes sobre:
    • Todos os parâmetros necessários, como serviceProvider, partner e SAMLResponse
    • Todos os cabeçalhos necessários, como Authorization, AP-Device-Identifier, Content-Type, X-Device-Info e AP-Partner-Framework-Status
    • Todos os cabeçalhos e parâmetros opcionais
    O aplicativo de transmissão deve garantir que inclua valores válidos para o status da estrutura do parceiro e a resposta de autenticação do parceiro (resposta SAML), de modo que a resposta recuperada possa incluir um perfil de tipo "appleSSO".
    Para obter mais detalhes sobre o cabeçalho AP-Partner-Framework-Status, consulte a documentação AP-Partner-Framework-Status.

  13. Retornar informações sobre o perfil do parceiro: A resposta do ponto de extremidade Perfis contém informações sobre o perfil do parceiro, incluindo o atributo type definido como "appleSSO".

    note important
    IMPORTANT
    Consulte a documentação da API Recuperar perfil usando a resposta de autenticação de parceiro para obter detalhes sobre as informações fornecidas em uma resposta de perfil.
    O ponto de extremidade Profiles Partner 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 falhar, uma resposta de erro será gerada, fornecendo informações adicionais que seguem a documentação de Códigos de erro aprimorados.
    O ponto de extremidade do Parceiro de perfis valida os dados da solicitação para garantir que as condições de logon único do parceiro sejam atendidas:
    • A configuração de logon único do parceiro no servidor do Adobe Pass deve ser válida e ativada.
    • A carga de status da estrutura do parceiro recebida por meio do cabeçalho AP-Partner-Framework-Status deve ser válida.
    Se a validação do logon único do parceiro falhar, a resposta assumirá como padrão o fluxo básico de recuperação do perfil.

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

D. Fase das decisões

  1. Recuperar status da estrutura do parceiro: O aplicativo de streaming chama a Estrutura da Conta de Assinante de Vídeo desenvolvida pela Apple para obter permissões de usuário e informações do provedor.

    note important
    IMPORTANT
    Consulte a documentação da Estrutura da Conta de Assinante de Vídeo para obter detalhes sobre:
    • O aplicativo de streaming deve verificar a permissão para acessar as informações de assinatura do usuário e continuar somente se o usuário permitir.
    • O aplicativo de streaming deve fornecer um delegado para o VSAccountManager.
    • O aplicativo de streaming deve enviar uma solicitação para obter informações sobre a conta do assinante.
    • O aplicativo de streaming deve aguardar e processar as informações de metadados.
    O aplicativo de streaming deve garantir que ele especifique um valor booliano igual a false para a propriedade isInterruptionAllowed no objeto VSAccountMetadataRequest, para indicar que o usuário não pode ser interrompido nesta fase.
    note tip
    TIP
    Sugestão: o aplicativo de transmissão pode usar um valor em cache para as informações de status da estrutura do parceiro, que recomendamos atualizar quando o aplicativo passa do estado de segundo plano para o primeiro plano.

  2. Retornar informações de status da estrutura do parceiro: o aplicativo de streaming valida os dados de resposta para garantir que as condições básicas sejam atendidas:

    • O status de acesso da permissão do usuário é concedido.
    • O identificador de mapeamento do provedor do usuário está presente e é válido.
    • A data de expiração do perfil do provedor do usuário (se disponível) é válida.

  3. 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.

    note important
    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
    O aplicativo de transmissão deve garantir que inclua um valor válido para o status da estrutura do parceiro antes de fazer uma solicitação adicional, quando o perfil escolhido for um perfil de tipo "appleSSO".
    Para obter mais detalhes sobre o cabeçalho AP-Partner-Framework-Status, consulte a documentação AP-Partner-Framework-Status.

  4. 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 ou Deny para cada recurso:

    • Uma decisão Permit significa que o recurso é reproduzível. A resposta não inclui um token de mídia, pois o fluxo de pré-autorização não deve ser usado para reproduzir recursos.
    • Uma decisão Deny significa que o recurso não pode ser reproduzido. A resposta inclui uma carga de erro que segue a documentação de Códigos de erro aprimorados.
    note important
    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 falhar, uma resposta de erro será gerada, fornecendo informações adicionais que seguem a documentação de Códigos de erro aprimorados.

  5. Recuperar status da estrutura do parceiro: O aplicativo de streaming chama a Estrutura da Conta de Assinante de Vídeo desenvolvida pela Apple para obter permissões de usuário e informações do provedor.

    note important
    IMPORTANT
    Consulte a documentação da Estrutura da Conta de Assinante de Vídeo para obter detalhes sobre:
    • O aplicativo de streaming deve verificar a permissão para acessar as informações de assinatura do usuário e continuar somente se o usuário permitir.
    • O aplicativo de streaming deve fornecer um delegado para o VSAccountManager.
    • O aplicativo de streaming deve enviar uma solicitação para obter informações sobre a conta do assinante.
    • O aplicativo de streaming deve aguardar e processar as informações de metadados.
    O aplicativo de streaming deve garantir que ele especifique um valor booliano igual a false para a propriedade isInterruptionAllowed no objeto VSAccountMetadataRequest, para indicar que o usuário não pode ser interrompido nesta fase.
    note tip
    TIP
    Sugestão: o aplicativo de transmissão pode usar um valor em cache para as informações de status da estrutura do parceiro, que recomendamos atualizar quando o aplicativo passa do estado de segundo plano para o primeiro plano.

  6. Retornar informações de status da estrutura do parceiro: o aplicativo de streaming valida os dados de resposta para garantir que as condições básicas sejam atendidas:

    • O status de acesso da permissão do usuário é concedido.
    • O identificador de mapeamento do provedor do usuário está presente e é válido.
    • A data de expiração do perfil do provedor do usuário (se disponível) é válida.

  7. 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.

    note important
    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
    O aplicativo de transmissão deve garantir que inclua um valor válido para o status da estrutura do parceiro antes de fazer uma solicitação adicional, quando o perfil escolhido for um perfil de tipo "appleSSO".
    Para obter mais detalhes sobre o cabeçalho AP-Partner-Framework-Status, consulte a documentação AP-Partner-Framework-Status.

  8. Decisão de autorização de retorno: A resposta do ponto de extremidade de Autorização de Decisões contém uma decisão Permit ou Deny para o recurso específico:

    • Uma decisão Permit significa que o recurso é reproduzível. A resposta inclui um token de mídia.
    • Uma decisão Deny significa que o recurso não pode ser reproduzido. A resposta inclui uma carga de erro que segue a documentação de Códigos de erro aprimorados.
    note important
    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 falhar, uma resposta de erro será gerada, fornecendo informações adicionais que seguem a documentação de Códigos de erro aprimorados.
D. Fase de saída

  1. Iniciar logout do Adobe Pass: o aplicativo de streaming reúne todos os dados necessários para iniciar o fluxo de logout chamando o ponto de extremidade de Logout do Adobe Pass.

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

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

    note important
    IMPORTANT
    Consulte a documentação da API Iniciar logout para mvpd específica para obter detalhes sobre as informações fornecidas em uma resposta de logout.
    O endpoint de logout do Adobe Pass 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 falhar, uma resposta de erro será gerada, fornecendo informações adicionais que seguem a documentação de Códigos de erro aprimorados.
    note important
    IMPORTANT
    O aplicativo de streaming deve garantir que ele indique ao usuário que continue fazendo logoff do nível do parceiro ainda mais.
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b