Saltar para o conteúdo principal
Este guia explica como funciona uma integração de produção do Didit Authentication, desde o primeiro redirecionamento até à lista de verificação para entrada em produção. Comece pelo guia de início rápido se ainda não tiver autenticado uma pessoa, e use os guias de início rápido das plataformas para o código de cada SDK.

Arquitetura

Intervêm quatro componentes: Nunca deve existir uma chave de API da Didit nem um segredo na sua aplicação: a chave publicável é pública, e a troca do código é protegida por PKCE em vez de um segredo do cliente.

Páginas alojadas ou os seus próprios ecrãs

Escolha onde as pessoas introduzem o e-mail, a palavra-passe ou o código. A definição é sign_in_ui (hosted por omissão, ou own), e pode alterá-la mais tarde. As chaves de acesso pertencem à origem de início de sessão da sua aplicação. Os métodos de chaves de acesso dos SDKs funcionam apenas em páginas servidas a partir dessa origem. Por isso, nos seus próprios ecrãs num domínio diferente, encaminhe as pessoas para a página alojada para usar chaves de acesso.

Escolha o seu SDK

Sem um SDK, implemente você mesmo o fluxo de código de autorização com PKCE: o início rápido em JavaScript mostra o contrato completo.

Proteja o seu backend

Uma verificação da sessão no frontend controla apenas o que mostra. O seu backend toma todas as decisões com base num token verificado.
  1. Verifique o token de acesso em cada pedido. Valide a assinatura ES256 com o JWKS do seu emissor e, depois, iss, aud, exp e typ: at+jwt. Rejeite um token cujo act não seja null, a menos que a rota aceite agentes de IA. Consulte verificar um token no seu servidor.
  2. Verifique a sessão ativa antes de uma ação sensível. Um token de acesso mantém-se válido até expirar, no máximo 5 minutos. GET /session/ falha de imediato quando a sessão foi revogada, ficou inativa ou expirou, quando a pessoa foi bloqueada ou quando a sessão deixa de cumprir a sua política de MFA. Consulte verificar a sessão.
  3. Peça uma verificação adicional quando a ação for arriscada. Antes de um pagamento a beneficiário, de uma nova conta bancária ou de uma alteração de e-mail ou de telefone, pergunte à Didit se a pessoa tem de voltar a verificar-se, e atue apenas com base num step-up approved que o seu backend tenha lido por si próprio. Consulte step-up antes de ações sensíveis.
  4. Obtenha o vendor_data a partir do token verificado, nunca de um campo enviado pelo navegador, e use-o nas verificações e transações da pessoa.

Sessões

Altere as durações em Authentication > Security and sessions, ou por API, nas definições da aplicação.
A vista Active sessions na Didit Business Console, com a lista das sessões iniciadas, incluindo dispositivo, localização, início, última atividade, fim e um botão Revoke

Authentication > Sign-ins > Active sessions, com Revoke em cada sessão.

Aplicações nativas

A Didit só redireciona as pessoas para uma aplicação nativa através de um redirecionamento HTTPS: não aceita esquemas de URL personalizados.
  • iOS: configure o redirecionamento como um domínio associado, com webcredentials no seu apple-app-site-association.
  • Android: configure o redirecionamento como um App Link, com o seu assetlinks.json.
  • Registe cada URL de redirecionamento em Authentication > Security and sessions, tal como um callback web.
Para usar passkeys na sua aplicação, registe as aplicações que partilham as passkeys da sua aplicação com PUT native-apps/ na API de gestão de autenticação. A Didit inclui-as depois na lista do apple-app-site-association e do assetlinks.json que disponibiliza na sua origem de início de sessão. MANAGEMENT_BASE é o endereço da API de gestão da sua aplicação, e uma chave de API com o âmbito authentication e permissão write pode fazer a chamada. A chamada substitui ambas as listas, por isso envie as duas:
Os guias de início rápido para iOS e Android mostram o lado da aplicação.

Ligar a verificação de identidade e a monitorização de transações

Cada pessoa tem um valor vendor_data, nos seus tokens e na sua sessão. Use-o como vendor_data ao criar uma sessão de verificação ou ao submeter uma transação, e a consola mostra os inícios de sessão, as verificações e as transações da mesma pessoa.
  • Para verificar pessoas no registo ou novamente antes de um pagamento, sem criar um fluxo de verificação, use a identidade verificada.
  • Os eventos de início de sessão chegam automaticamente às regras de eventos e às vistas de fraude. Não envie os seus próprios eventos auth.login para os mesmos inícios de sessão.
  • Um início de sessão bem-sucedido nunca aprova uma verificação ou uma transação: trate a decisão de cada produto separadamente.
Consulte manter a mesma pessoa em todos os produtos.

Receber eventos de início de sessão

Subscreva um destino do webhook para os tipos auth.* de que precisa, como auth.new_device ou auth.account_locked. Deduplique por auth_event.event_id e verifique a assinatura tal como faz para qualquer webhook da Didit. Consulte eventos e webhooks para ver todos os tipos e o respetivo payload.

Migrar utilizadores existentes

Se os seus utilizadores já tiverem contas noutra plataforma de identidade ou na sua própria base de dados, importe-os antes de mudar o início de sessão. Importe os hashes de palavra-passe dos utilizadores sempre que a origem os fornecer, mantenha as ligações sociais e guarde os seus IDs de utilizador como external_id, que passa a ser o vendor_data de cada utilizador. Nada muda para os utilizadores até mudar a sua aplicação para a Didit.

Lista de verificação antes de passar para produção

  1. A autenticação está ativada na sua aplicação Live, na página Products.
  2. Os seus URLs de redirecionamento https:// de produção e as origens permitidas estão registados na aplicação Live. Uma aplicação Live não aceita endereços http://.
  3. Cada método de início de sessão social usa o ID de cliente e o segredo da sua própria aplicação: as credenciais de teste da Didit só funcionam no Sandbox.
  4. A sua configuração de produção tem a chave publicável Live (pk_live_) e o seu emissor Live.
  5. A sua política de MFA, a duração da sessão, o tempo limite de inatividade, o comprimento da palavra-passe e a política de registo estão como pretende. Consulte as definições da aplicação.
  6. A proteção contra bots está ativada, com a verificação de palavras-passe comprometidas.
  7. O seu backend verifica todos os tokens de acesso e chama GET /session/ antes de ações sensíveis.
  8. A sua identidade visual, os textos das páginas e as ligações para os termos e para a política de privacidade estão definidos. Se planeia usar um domínio personalizado, ative-o antes de as pessoas começarem a adicionar chaves de acesso.
  9. O seu destino do webhook está subscrito aos tipos auth.* que trata.
  10. Testou na aplicação Live o registo, o início de sessão de quem já tem conta, o cancelamento, o fluxo de palavra-passe esquecida, a MFA, a expiração de sessão, o fim de sessão e uma sessão revogada.

Resolução de problemas

Última modificação em 22 de novembro de 2026