Pular para o conteúdo principal
A Authentication é um recurso novo: o DiditAuth for Android depende da versão. As coordenadas de distribuição, as versões e as assinaturas das chamadas não estão confirmadas aqui. Não instale um pacote presumido nem use o SDK de verificação de identidade como SDK de Authentication.

​
Prepare sua aplicação

  1. Confirme que a autenticação está habilitada para a sua aplicação Didit e copie do console a origem de login dela (https://<slug>.auth.didit.me, ou <slug>.sandbox.auth.didit.me para o sandbox).
  2. Registre uma URL de retorno exata compatível com a sua aplicação e com o runtime. Valide a propriedade do app link; não presuma que esquemas de URL personalizados arbitrários sejam aceitos.
  3. Mantenha separadas as configurações de sandbox e de produção, incluindo o tratamento do retorno e as credenciais armazenadas.
  4. Escolha o mapeamento estável de pessoas antes de integrar a verificação ou o monitoramento.
Use uma aba do navegador do sistema para o login hospedado e valide o app link de retorno. Passkeys nativas exigem o domínio da relying party configurado e o fluxo de credenciais da plataforma.

​
Implemente o fluxo hospedado

Abra uma aba do navegador do sistema com a URL {origin}/sign-in. Envie um novo state aleatório, um desafio PKCE S256 e o redirect_uri registrado. Mantenha o verifier no seu app apenas para essa tentativa. O quickstart de JavaScript mostra o protocolo subjacente; no código nativo, use a criptografia e o tratamento de URLs da plataforma em vez de variáveis globais do navegador. No retorno, verifique o state, o tempo de vida da transação e o destino do retorno antes de trocar o código de uso único em token/. Use o verifier original e a URI de redirecionamento exata. Cancelar ou fechar o navegador não é um login bem-sucedido. Armazene os refresh tokens em armazenamento criptografado protegido pela plataforma; nunca em um arquivo de preferências sem criptografia, em ferramentas de analytics nem em logs de falhas. Valide a sessão atual com GET session/ usando o token Bearer do usuário final. Faça as renovações de forma sequencial, substitua os dois tokens juntos e limpe o estado específico do usuário após o logout. Consulte tokens e JWKS para ver o contrato da requisição e o comportamento de reutilização na renovação.

​
Prévia da versão do SDK nativo

Os módulos nativos de Authentication estão previstos para oferecer login, acesso à sessão atual, obtenção de tokens, logout e step-up, com sinais automáticos do dispositivo. Passkeys nativas e armazenamento protegido de tokens fazem parte dessa versão. As APIs de wrapper seguirão os contratos publicados de cada plataforma; não copie argumentos de construtor ou assinaturas de métodos presumidos a partir de um exemplo de design. Até o módulo ser lançado, mantenha o adaptador dele desabilitado ou use uma implementação revisada do protocolo hospedado para a sua aplicação habilitada. Não divulgue um quickstart nativo de Authentication funcional baseado apenas na instalação do pacote.

​
Conecte a verificação e o monitoramento

O seu backend deriva vendor_data da pessoa autenticada. Ele cria sessões de verificação ou emite tokens de monitoramento com escopo para essa pessoa. Retorne ao seu app apenas a credencial da sessão ou o token com escopo; a chave de API permanece no servidor. Use o SDK de verificação para Android quando precisar de verificação de identidade. Siga o envio de transações pelo SDK para ter suporte a monitoramento na sua plataforma. Trate separadamente as decisões de login, de verificação e de transação.

​
Verifique a integração

Teste o retorno a um app que estava fechado, as transições entre segundo e primeiro plano, o cancelamento no navegador, um retorno incompatível, a reutilização do código, a expiração do token, renovações simultâneas do token, MFA, logout e o login como outro usuário. Teste o cadastro de passkeys e o login em dispositivos compatíveis assim que essa versão estiver disponível. Uma verificação que só pode ser feita no dispositivo continua não verificada até ser executada na plataforma de destino.
Última modificação em 1 de novembro de 2026