Saltar para o conteúdo principal
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 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 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 quando precisar de verificação de identidade. Siga a submissão de transações do SDK 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.
Última modificação em 7 de novembro de 2026