Pular para o conteúdo principal
Este guia explica como uma integração de produção com a Autenticação Didit se encaixa, desde o primeiro redirecionamento até a lista de verificação para entrar em produção. Comece pelo guia de início rápido se você ainda não autenticou nenhuma pessoa, e use os guias de início rápido das plataformas para o código de cada SDK.

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.
  1. Verifique o access token em cada requisição. Confira a assinatura ES256 contra o JWKS do seu emissor e, em seguida, iss, aud, exp e typ: at+jwt, e rejeite um token cujo act não seja null, a menos que a rota aceite agentes de IA. Veja como verificar um token no seu servidor.
  2. 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.
  3. 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 approved que o seu backend leu diretamente. Veja 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 pela API, em configurações da aplicação.
Visualização Active sessions no Didit Business Console, listando sessões com login realizado, com dispositivo, localização, início, última atividade, término e um botão Revoke

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 webcredentials no seu apple-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.
Para chaves de acesso no seu aplicativo, registre os apps que compartilham as chaves de acesso da sua aplicação com 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 valor vendor_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.login para os mesmos logins.
  • Um login bem-sucedido nunca aprova uma verificação ou uma transação: trate a decisão de cada produto separadamente.
Veja como manter a mesma pessoa em todos os produtos.

Receber eventos de login

Assine um destino do webhook para os tipos auth.* 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 como external_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

  1. A autenticação está ativada na sua aplicação Live, na página Products.
  2. 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ços http://.
  3. 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.
  4. Sua configuração de produção tem a chave publicável Live (pk_live_) e o seu emissor Live.
  5. 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.
  6. A proteção contra bots está ativada, com a verificação de senhas vazadas.
  7. Seu backend verifica cada token de acesso e chama GET /session/ antes de ações sensíveis.
  8. 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.
  9. Seu destino de webhook está inscrito nos tipos auth.* que você trata.
  10. 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.

Troubleshooting

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