Saltar para o conteúdo principal
A Autenticação é nova: o DiditAuth para Android depende da versão. As coordenadas de distribuição, as versões e as assinaturas das funções invocáveis não estão confirmadas aqui. Não instale um pacote adivinhado nem use o SDK de verificação de identidade como SDK de Autenticação.

​
Preparar a aplicação

  1. Confirme que a Autenticação está ativada para a sua aplicação Didit e copie a origem de início de sessão (https://<slug>.auth.didit.me, ou <slug>.sandbox.auth.didit.me para o sandbox) a partir da consola.
  2. Registe um URL de retorno exato suportado pela sua aplicação e pelo ambiente de execução. Valide a propriedade dos app links; não assuma que esquemas de URL personalizados arbitrários são aceites.
  3. Mantenha a configuração de sandbox e de produção separada, incluindo o tratamento dos retornos e as credenciais guardadas.
  4. Escolha o seu mapeamento estável de pessoas antes de ligar a verificação ou a monitorização.
Use um separador do navegador do sistema para o início de sessão alojado e valide o app link de retorno. As passkeys nativas exigem o domínio configurado da parte confiável (relying party) e o fluxo de credenciais da plataforma.

​
Implementar o fluxo alojado

Abra um separador do navegador do sistema com o URL {origin}/sign-in. Forneça um state novo e aleatório, um desafio PKCE S256 e o seu redirect_uri registado. Mantenha o verificador na sua aplicação apenas para essa tentativa. O guia rápido de JavaScript mostra o protocolo subjacente; em código nativo, use a criptografia e o tratamento de URL da plataforma, e não os 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 utilização única no endpoint token/. Use o verificador original e o URI de redirecionamento exato. Cancelar ou fechar o navegador não é um início de sessão bem-sucedido. Guarde os tokens de atualização em armazenamento encriptado protegido pela plataforma; nunca num ficheiro de preferências em texto simples, em sistemas de análise ou em registos de falhas. Valide a sessão atual com GET session/ usando o token Bearer do utilizador final. Execute a atualização em série, substitua os dois tokens em conjunto e limpe o estado específico do utilizador após o fim de sessão. Consulte tokens e JWKS para o contrato do pedido e o comportamento de reutilização do token de atualização.

​
Pré-visualização da versão do SDK nativo

Prevê-se que os módulos nativos de Autenticação disponibilizem o início de sessão, o acesso à sessão atual, a obtenção de tokens, o fim de sessão e a autenticação reforçada, com sinais automáticos do dispositivo. As passkeys nativas e o armazenamento protegido de tokens fazem parte dessa versão. As APIs de wrapper seguirão os seus contratos de plataforma publicados; não copie argumentos de construtores nem assinaturas de métodos adivinhados a partir de um exemplo de conceção. Até o módulo ser lançado, mantenha o respetivo adaptador desativado ou use uma implementação revista do protocolo alojado para a sua aplicação ativada. Não divulgue um guia rápido de Autenticação nativa a funcionar apenas com base na instalação do pacote.

​
Ligar a verificação e a monitorização

O seu backend deriva o vendor_data a partir da pessoa autenticada. Cria sessões de verificação ou emite tokens de monitorização com âmbito limitado para essa pessoa. Devolva à sua aplicação apenas a credencial da sessão ou o token com âmbito limitado; a chave de API fica no servidor. Use o SDK de verificação para Android quando precisar de Verificação de identidade. Siga o envio de transações com o SDK para o suporte de monitorização na sua plataforma. Trate o início de sessão, a verificação e as decisões sobre transações de forma separada.

​
Verificar a integração

Teste o regresso a uma aplicação que estava fechada, as transições para segundo plano e para primeiro plano, o cancelamento no navegador, um callback que não corresponde, o reenvio de um código, a expiração de tokens, a atualização concorrente, a MFA, o fim de sessão e o início de sessão com outro utilizador. Teste o registo e o início de sessão com passkeys em dispositivos suportados, assim que essa versão estiver disponível. Uma verificação exclusiva no dispositivo continua por confirmar até ser executada na plataforma-alvo.
Última modificação em 7 de novembro de 2026