> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Início rápido Android: Autenticação Didit

> Prepare a autenticação Android da Didit: login alojado, validação de callback, sessões seguras e ligações para verificação e monitorização.

> [!WARNING]
>
> 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](https://docs.didit.me/pt/authentication/quickstarts/javascript.md) 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](https://docs.didit.me/pt/authentication/tokens-and-jwks.md) 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](https://docs.didit.me/pt/integration/native-sdks/android-sdk.md) quando precisar de Verificação de identidade. Siga o [envio de transações com o SDK](https://docs.didit.me/pt/transaction-monitoring/sdk-transaction-submission.md) 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.