Saltar para o conteúdo principal
A autenticação é nova: o DiditAuth para iOS depende do lançamento. As coordenadas do pacote para distribuição, as versões e as assinaturas de chamada não estão aqui confirmadas. Não instale um pacote presumido 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 na 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 das ligações de aplicação; não assuma que são aceites esquemas de URL personalizados arbitrários.
  3. Mantenha separadas a configuração do sandbox e a de produção, incluindo o tratamento dos retornos e as credenciais armazenadas.
  4. Escolha o seu mapeamento estável de pessoas antes de ligar a verificação ou a monitorização.
Use a sessão de autenticação do sistema para o início de sessão alojado. Planeie em conjunto o tratamento nativo de chaves de acesso e o domínio da parte confiante; um WebView não substitui o fluxo de autenticação do sistema.

​
Implementar o fluxo alojado

Abra uma sessão de autenticação do navegador do sistema com o URL {origin}/sign-in. Forneça um state aleatório e novo, um desafio PKCE S256 e o seu redirect_uri registado. Mantenha o verificador na sua aplicação apenas para essa tentativa. A documentação rápida 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 no armazenamento de credenciais protegido pela plataforma; nunca num ficheiro de preferências em texto simples, nem em ferramentas de análise ou registos de falhas. Valide a sessão atual com GET session/ usando o token Bearer do utilizador final. Serialize a 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 dos pedidos e o comportamento de reutilização na atualização.

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

Os módulos nativos de autenticação deverão disponibilizar 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 chaves de acesso 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 presumidos 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 anuncie um guia de início rápido nativo de autenticação em funcionamento 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 iOS quando precisar de verificação de identidade. Siga a submissão de transações no 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 separadamente.

​
Verificar a integração

Teste o regresso a uma aplicação que estava encerrada, as transições para segundo plano e para primeiro plano, o cancelamento no navegador, um retorno que não corresponde, a reutilização 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 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 de destino.
Última modificação em 7 de novembro de 2026