Arquitetura
Quatro partes estão envolvidas:
Nenhuma chave de API da Didit e nenhum segredo devem ficar no seu app: a chave publicável é pública, e a troca do código é protegida por PKCE, e não por um segredo do cliente.
Páginas hospedadas ou suas próprias telas
Escolha onde as pessoas digitam o e-mail, a senha ou o código. A configuração ésign_in_ui (hosted por padrão, ou own), e você pode alterá-la depois.
As passkeys pertencem à origem de login da sua aplicação.
Os métodos de passkey dos SDKs funcionam apenas em páginas servidas a partir dessa origem. Por isso, nas suas próprias telas em outro domínio, direcione as pessoas para a página hospedada para usar passkeys.
Escolha seu SDK
Sem um SDK, implemente o fluxo de código de autorização com PKCE por conta própria: o guia rápido de JavaScript mostra o contrato completo.
Proteja seu backend
Uma verificação de sessão apenas no frontend controla somente o que você exibe. Seu backend toma todas as decisões a partir de um token verificado.- Verifique o access token em cada requisição. Confira a assinatura ES256 contra o JWKS do seu emissor e, em seguida,
iss,aud,expetyp: at+jwt, e rejeite um token cujoactnão sejanull, a menos que a rota aceite agentes de IA. Veja como verificar um token no seu servidor. - Confira a sessão ativa antes de uma ação sensível. Um access token continua válido até expirar, em até 5 minutos.
GET /session/falha imediatamente quando a sessão foi revogada, ficou inativa ou expirou, quando a pessoa foi bloqueada ou quando a sessão deixa de atender à sua política de MFA. Veja como verificar a sessão. - Peça um step-up quando a ação for arriscada. Antes de um pagamento, de uma nova conta bancária ou de uma alteração de e-mail ou telefone, pergunte à Didit se a pessoa precisa verificar novamente, e aja somente com base em um step-up
approvedque o seu backend leu diretamente. Veja step-up antes de ações sensíveis. - Obtenha o
vendor_dataa 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 pela API, em configurações da aplicação.

Authentication > Sign-ins > Active sessions, com o botão Revoke em cada sessão.
Aplicativos nativos
O Didit redireciona os usuários para um aplicativo nativo somente por redirecionamento HTTPS. Ele não aceita esquemas de URL personalizados.- iOS: configure o redirecionamento como um domínio associado, com
webcredentialsno seuapple-app-site-association. - Android: configure o redirecionamento como um App Link, com o seu
assetlinks.json. - Registre cada URL de redirecionamento em Authentication > Security and sessions, como um callback web.
PUT native-apps/ na API de gerenciamento de autenticação.
Em seguida, o Didit lista esses apps no apple-app-site-association e no assetlinks.json que ele disponibiliza na sua origem de login.
MANAGEMENT_BASE é o endereço da API de gerenciamento da sua aplicação, e uma chave de API com o escopo authentication em write pode fazer a chamada.
A chamada substitui as duas listas, então envie as duas:
Os guias de início rápido para iOS e Android mostram o lado do app.
Conecte a verificação de identidade e o monitoramento de transações
Cada pessoa tem um único valorvendor_data, presente nos seus tokens e na sua sessão.
Use-o como vendor_data ao criar uma sessão de verificação ou enviar uma transação, e o console mostra os logins, as verificações e as transações da mesma pessoa.
- Para verificar pessoas no cadastro ou novamente antes de um repasse, sem criar um fluxo de verificação próprio, use a identidade verificada.
- Os eventos de login chegam automaticamente às regras de eventos e às visualizações de fraude. Não envie seus próprios eventos
auth.loginpara os mesmos logins. - Um login bem-sucedido nunca aprova uma verificação ou uma transação: trate a decisão de cada produto separadamente.
Receber eventos de login
Assine um destino do webhook para os tiposauth.* de que você precisar, como auth.new_device ou auth.account_locked.
Elimine duplicatas com base em auth_event.event_id e verifique a assinatura, como em qualquer webhook da Didit.
Consulte eventos e webhooks para ver todos os tipos e seus payloads.
Mover usuários existentes
Se seus usuários já têm contas em outra plataforma de identidade ou no seu próprio banco de dados, importe-os antes de trocar o login. Importe os hashes de senha quando a origem os fornecer, mantenha os vínculos com redes sociais e mantenha seus próprios IDs de usuário comoexternal_id, que passam a ser o vendor_data deles.
Nada muda para eles até que você troque o seu app para a Didit.
Checklist para colocar em produção
- A autenticação está ativada na sua aplicação Live, na página Products.
- As URLs de redirecionamento
https://de produção e as origens permitidas estão cadastradas na aplicação Live. Uma aplicação Live não aceita endereçoshttp://. - Cada método de login social usa o ID do cliente e o segredo do seu próprio aplicativo: as credenciais de teste da Didit funcionam apenas no Sandbox.
- Sua configuração de produção tem a chave publicável Live (
pk_live_) e o seu emissor Live. - Sua política de MFA, a duração da sessão, o tempo limite por inatividade, o tamanho da senha e a política de cadastro estão como você deseja. Consulte configurações da aplicação.
- A proteção contra bots está ativada, com a verificação de senhas vazadas.
- Seu backend verifica cada token de acesso e chama
GET /session/antes de ações sensíveis. - Sua marca, os textos das páginas e os links para termos e política de privacidade estão configurados. Se você planeja usar um domínio personalizado, ative-o antes que as pessoas comecem a adicionar chaves de acesso.
- Seu destino de webhook está inscrito nos tipos
auth.*que você trata. - Você testou cadastro, login de usuário recorrente, cancelamento, recuperação de senha, MFA, expiração da sessão, encerramento da sessão e uma sessão revogada na aplicação Live.