Visão geral do Apple SSO apple-sso-overview
O Apple fornece aos usuários a capacidade de fazer logon em sua conta de provedor de TV no nível do sistema do dispositivo, eliminando a necessidade de autenticação aplicativo por aplicativo.
A Autenticação do Adobe Pass fez parceria com a Apple para criar a experiência de usuário de Logon único (SSO) de parceiro no ecossistema da TV em todos os lugares para proprietários de iPhone, iPad e Apple TV.
Para se beneficiar da experiência do usuário de Logon único (SSO) em um dispositivo Apple, há uma lista de pré-requisitos documentados abaixo que devem ser concluídos.
O resultado final deve criar uma experiência de acordo com os seguintes fluxos de usuário, que recomendamos consultar antes de começar a desenvolver seu aplicativo:
- Fluxos de usuários do Logon Único (SSO) para dispositivos iPhone e iPad.
- Fluxos de usuários do Logon Único (SSO) para dispositivos Apple TV.
Pré-requisitos apple-sso-prerequisites
Os pré-requisitos de integração podem se aplicar a uma ou várias entidades envolvidas no negócio da TVE, como Programadores, MVPDs, Autenticação do Adobe Pass ou Apple.
Programador apple-sso-prerequisites-programmer
Para se beneficiar da experiência do usuário de Logon Único (SSO), um Programador deve:
-
Entre em contato com a Apple para habilitar a Estrutura da Conta do Assinante do Vídeo como parte da sua Identificação da Equipe da Apple e configure a Qualificação de Logon Único do Assinante do Vídeo como parte da sua Conta de Desenvolvedor do Apple.
- Use o Xcode versão 8 ou superior e o iOS/tvOS versão 10 ou superior.
-
Habilite o Logon Único (SSO) para cada integração e plataforma desejada (iOS/tvOS) por meio do Painel do Adobe Pass TVE, definindo a propriedade
Enable Single Sign OncomoYes.
-
Integre os fluxos de usuário de Logon único (SSO) usando uma das seguintes soluções oferecidas pela Autenticação do Adobe Pass para usuários finais de aplicativos clientes em execução no iOS, iPadOS ou tvOS.
-
A API REST V2 de Autenticação do Adobe Pass é compatível com o Logon Único de Parceiro (SSO).
Consulte a documentação Guia de SSO do Apple (REST API V2).
-
A API REST V1 de Autenticação do Adobe Pass é compatível com o Logon Único de Parceiro (SSO).
Consulte a documentação Guia de SSO do Apple (REST API V1).
-
O SDK do iOS/tvOS do Adobe Pass Authentication AccessEnabler é compatível com o Logon único de parceiros (SSO).
Consulte a documentação do Guia do Apple SSO (iOS/tvOS SDK).
-
MVPD apple-sso-prerequisites-mvpd
Para se beneficiar da experiência do usuário de Logon Único (SSO), um MVPD deve:
-
Entre em contato com a Apple para iniciar o processo de integração no lado da Apple.
- Solicite a documentação técnica sobre como integrar e desenvolver um aplicativo TVML do JavaScript capaz de lidar com o formulário de logon do usuário.
-
Entre em contato com a Autenticação do Adobe Pass para iniciar o processo de integração no Adobe.
- Forneça o valor da string que representa o identificador do provedor de TV atribuído pela Apple durante o processo de integração.
Perguntas frequentes FAQ
-
Caso algo dê errado com o fluxo de trabalho SSO do Apple, o aplicativo que usa o SDK iOS/tvOS do Adobe Pass Authentication AccessEnabler pode retornar ao fluxo de autenticação normal?
Isso é possível, mas requer que uma alteração de configuração seja executada por meio do Painel do Adobe Pass TVE para definir o Habilitar Logon Único em NÃO para a integração e plataforma desejadas (iOS/tvOS). Esteja ciente de que o aplicativo cliente reconhecerá a alteração de configuração somente após chamar a API setRequestor.
-
O aplicativo saberá quando uma autenticação ocorreu como resultado de um logon por meio do Apple SSO?
Essas informações estão disponíveis como parte da chave de metadados do usuário: tokenSource, que deve retornar o valor da cadeia de caracteres: "Apple" neste caso.
-
O aplicativo saberá quando uma autenticação aconteceu como resultado de um logon por meio do Apple SSO em outro aplicativo?
Esta informação não está disponível.
-
O que acontece se um usuário entrar acessando a seção
Settings -> TV Providerno iOS/iPadOS ouSettings -> Accounts -> TV Providerno tvOS usando um MVPD que não esteja integrado ao aplicativo?Quando o usuário inicia o aplicativo, ele não é autenticado por meio do fluxo de trabalho SSO do Apple. Portanto, o aplicativo teria que recorrer ao fluxo de autenticação regular e apresentar seu próprio seletor de MVPD.
-
O que acontece se um usuário entrar pela
Settings -> TV Providerno iOS/iPadOS ouSettings -> Accounts -> TV Providerna seção tvOS usando um MVPD que tenha o Habilitar Logon Único definido em NÃO por meio do Painel do Adobe Pass TVE para a plataforma iOS/tvOS?Quando o usuário inicia o aplicativo, ele não é autenticado por meio do fluxo de trabalho SSO do Apple. Portanto, o aplicativo teria que recorrer ao fluxo de autenticação regular e apresentar seu próprio seletor de MVPD.
-
O que acontece se um usuário tiver um MVPD que não seja integrado (não suportado) pelo Apple, mas que esteja presente no seletor de Apple?
Quando o usuário inicia o aplicativo, ele só seleciona o MVPD por meio do fluxo de trabalho SSO do Apple sem concluir o fluxo de autenticação. Portanto, o aplicativo teria que recorrer ao fluxo de autenticação regular, mas poderia usar o MVPD já selecionado.
-
O que acontece se um usuário tiver um MVPD que não seja integrado (não suportado) pelo Apple?
Quando o usuário inicia o aplicativo, o usuário seleciona a opção de seleção "Outros provedores de TV" por meio do fluxo de trabalho SSO do Apple. Portanto, o aplicativo teria que recorrer ao fluxo de autenticação regular e apresentar seu próprio seletor de MVPD.
-
O que acontece se um usuário tiver um MVPD degradado pela mídia do Painel do Adobe Pass TVE?
Quando o usuário inicia o aplicativo, ele é autenticado por meio do mecanismo de degradação e não pelo fluxo de trabalho SSO do Apple. A experiência deve ser contínua para o usuário, enquanto o aplicativo será informado por meio do código de aviso N010 caso esteja usando o SDK Adobe Pass Authentication AccessEnabler iOS/tvOS.
-
A ID do usuário MVPD mudará entre os fluxos de autenticação SSO da Apple e SSO que não seja da Apple?
A expectativa é que a ID do usuário não seja alterada, mas precisa ser verificada para cada provedor selecionado.
-
Haverá alguma alteração nos TTLs de autenticação?
A Autenticação do Adobe Pass continuará a respeitar os TTLs exigidos pelos Programadores para sua integração com cada MVPD. Ao navegar de um aplicativo do programador para outro aplicativo do programador por meio do Apple SSO, o segundo aplicativo terá o TTL de sua integração Programmer x MVPD correspondente (ele não compartilhará o TTL do primeiro aplicativo autenticado)