> ## 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 React Native para autenticação

> Prepare a autenticação React Native com a Didit: início de sessão alojado, validação de retorno, sessões seguras e ligações à verificação e monitorização.

> [!WARNING]
>
> A Autenticação é nova: **@didit-protocol/auth-react-native** depende do lançamento. As coordenadas de distribuição, as versões e as assinaturas de chamadas não estão confirmadas aqui. Não instale um pacote escolhido por suposição 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 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 e não presuma que esquemas de URL personalizados arbitrários são aceites.
3. Mantenha separadas as configurações de sandbox e de produção, 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.

Configure e teste os links de retorno separadamente no iOS e no Android. A camada de encapsulamento de Autenticação é separada do @didit-protocol/sdk-react-native, que trata da verificação.

## Implementar o fluxo alojado

Abra o navegador de autenticação do sistema com o URL `{origin}/sign-in`. Forneça um `state` aleatório novo, um desafio PKCE S256 e o seu `redirect_uri` registado. Mantenha o verificador na sua aplicação apenas para essa tentativa. O [guia de início rápido de JavaScript](https://docs.didit.me/pt/authentication/quickstarts/javascript.md) mostra o protocolo subjacente; use criptografia e tratamento de URL da plataforma, em vez de globais do navegador, no código nativo.

Ao receber o 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.

Armazene os tokens de atualização em armazenamento protegido pela plataforma nativa; nunca num ficheiro de preferências 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. Serialize os pedidos de atualização, 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 de tokens de atualização.

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

Os módulos nativos de Autenticação deverão disponibilizar início de sessão, acesso à sessão atual, obtenção de tokens, fim de sessão e autenticação reforçada, com sinais automáticos do dispositivo. Chaves de acesso nativas e armazenamento protegido de tokens fazem parte dessa versão. As APIs da camada de encapsulamento seguirão os contratos publicados para cada plataforma; não copie argumentos de construtor nem assinaturas de métodos adivinhados de um exemplo de design.

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 com a funcionalidade ativada. Não anuncie um guia de início rápido nativo de Autenticação 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 definido para essa pessoa. Devolva à sua aplicação apenas a credencial da sessão ou o token com âmbito; a chave de API permanece no servidor.

Use o [SDK de verificação para React Native](https://docs.didit.me/pt/integration/native-sdks/react-native-sdk.md) quando precisar de verificação de identidade. Siga a [submissão de transações do SDK](https://docs.didit.me/pt/transaction-monitoring/sdk-transaction-submission.md) para suportar a 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 encerrada, as transições para segundo plano e para primeiro plano, o cancelamento no navegador, um retorno não correspondente, a reutilização de código, a expiração de tokens, as atualizações concorrentes, 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 chaves de acesso em dispositivos compatíveis assim que essa versão estiver disponível. Uma verificação apenas em 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.