Registro de aplicativo Android (herdado)
- Tópicos:
- Authentication
Introdução
A partir da versão 3.0 do Android AccessEnabler SDK, estamos alterando o mecanismo de autenticação com servidores Adobe. Em vez de usar uma chave pública e um sistema secreto para assinar o requestorID, estamos introduzindo o conceito de uma string de Declaração de Software que pode ser usada para obter um token de acesso usado posteriormente para todas as chamadas que o SDK faz aos nossos servidores. Além de uma Declaração de Software, você também precisará criar um deep link para o seu aplicativo.
Para obter mais informações, consulte Visão Geral do Registro de Cliente Dinâmico.
O que é uma Declaração de Software?
Uma Declaração de Software é um token JWT que contém informações sobre seu aplicativo. Cada aplicativo deve ter uma instrução de software exclusiva usada pelos nossos servidores para identificar o aplicativo no sistema Adobe.
A Instrução de Software precisa ser passada quando você inicializa o SDK AccessEnabler
. É usado para registrar o aplicativo com o Adobe. Após o registro, a SDK recebe uma ID do cliente e um segredo do cliente, que é usado para obter um token de acesso. Qualquer chamada feita pela SDK para servidores Adobe requer um token de acesso válido. A SDK é responsável por registrar o aplicativo, obter e atualizar o token de acesso.
Como obter uma Declaração de Software
Estas são as maneiras de obter uma Declaração de software.
Se você tiver acesso ao Painel TVE do Adobe
-
Abra o navegador e navegue até o Painel do Adobe Pass TVE.
-
Navegue até a seção Channels e selecione seu canal.
-
Navegue até a guia Registered Applications.
-
Clique em Add new application.
-
Nomeie o aplicativo e especifique uma versão.
-
Selecione as plataformas em que o aplicativo estará disponível (Android, neste caso).
-
Forneça um Domain Name escolhendo em uma lista de domínios já configurados para seu Programador.
-
Envie suas alterações por push ao servidor e navegue de volta para a guia Registered Applications do Canal.
Você deve ver uma lista com todos os aplicativos registrados. Selecione Download no aplicativo criado. Talvez seja necessário aguardar alguns minutos antes que a Declaração de software esteja pronta para download.
Um arquivo de texto é baixado. Use seu conteúdo como a Declaração de Software.
Para obter mais informações, consulte Dynamic Client Registration Management.
Se você não tiver acesso ao Painel Adobe TVE
Enviar tíquete para tve-support@adobe.com
. Inclua as informações necessárias, como canal, nome do aplicativo, versão e plataformas. Alguém da nossa equipe de suporte criará uma declaração de software para você.
Como usar a Declaração de Software
Depois de obter a Instrução de Software, você precisará passá-la como um parâmetro no construtor Access Enabler. Recomendamos hospedar a Declaração de Software em um local remoto. Dessa forma, você pode revogar e alterar facilmente a Declaração de Software sem lançar uma nova versão do seu aplicativo.
Criar e usar um deep link para seu aplicativo
No Android, use como valor de deep link o inverso do nome de domínio selecionado quando você criou a Declaração de software
O deep link criado deve ter um valor exclusivo no dispositivo Android. Quando vários aplicativos usam o mesmo valor de deep link, os fluxos de autenticação e logout interferem.
Como usar a Declaração de software e o deep link
No arquivo de recursos do aplicativo strings.xml
, adicione o seguinte código:
<string name="software_statement">softwarestatement value</string>
<string name="redirect_uri">com.domain_name</string>