Pular para o conteúdo principal
Este guia de início rápido coloca o Didit Authentication para funcionar de ponta a ponta em cerca de 10 minutos. Você registra uma URL de retorno em uma aplicação sandbox, ativa um método de login, autentica uma pessoa com a página de login hospedada, verifica o token de acesso dela no seu servidor e vê o login no console.

Pré-requisitos

  • Uma conta Didit com uma aplicação Sandbox. Criar uma conta é gratuito, e toda aplicação Sandbox tem Autenticação ativada.
  • Node.js 20 ou superior, e um aplicativo web que você possa executar em http://localhost:3000.

Steps

1

Abra sua aplicação de sandbox

No Business Console, use o seletor de aplicações para escolher sua aplicação Sandbox e depois abra Authentication.Uma aplicação Sandbox aceita callbacks em http://localhost e as credenciais de teste da Didit para login social, e nunca é cobrada. Uma aplicação de produção ativa o Authentication pela página Products: veja preparar sua aplicação.
2

Registre seu callback e sua origem

Abra Authentication > Security and sessions > Redirect URLs and allowed origins e adicione:A Didit só redireciona uma pessoa para uma URL de redirecionamento que você registrou, caractere por caractere. A origem permitida possibilita que o navegador troque o código com a origem da Didit da sua aplicação.
O cartão Redirect URLs and allowed origins no Didit Business Console, ao lado da lista de permissões e de bloqueios e da URL de login

Redirect URLs and allowed origins, em Authentication > Security and sessions.

3

Ative um método de login

Abra Authentication > Sign-in methods e ative Email code. Uma aplicação nova começa com todos os métodos desativados, e a página hospedada oferece apenas os métodos que você ativar.Adicione também Passkeys, se quiser, ou um método de login social com as credenciais de teste da Didit, que funcionam no Sandbox sem um aplicativo próprio. Cada método é descrito em métodos de login.
A página Sign-in methods no Didit Business Console, com o cartão da página de login hospedada, os métodos sem senha e com senha e uma prévia ao vivo da página hospedada

Authentication > Sign-in methods, com uma prévia ao vivo da página hospedada.

4

Copie sua chave publicável

Abra Authentication > Developers e copie a Publishable key. Em uma aplicação Sandbox, ela começa com pk_test_.A chave publicável é pública e identifica a origem de login da Didit da sua aplicação. Nunca coloque a Secret key em código de navegador ou de aplicativo móvel.
5

Instale o SDK e faça login

auth.ts
Clique no seu botão: a página hospedada pede um endereço de e-mail e envia um código de seis dígitos. Digite o código, e a Didit redireciona você de volta ao seu callback, que troca o código de uso único pelos tokens da sessão. No primeiro login, uma conta é criada para um endereço que ainda não tenha uma conta, porque a política padrão de cadastro permite que qualquer pessoa se cadastre.
A página de login hospedada em um celular, com um botão de passkey e campos de e-mail e senha

A página de login hospedada em um celular. Ela mostra apenas os métodos que você ativou.

6

Verifique o token no seu servidor

Envie o token de acesso de auth.getToken() para o seu backend no cabeçalho Authorization e verifique-o lá em cada requisição protegida:
server.ts
verifyToken confere a assinatura ES256 com as chaves publicadas do seu emissor, o emissor e a expiração. Os tokens de acesso duram no máximo 5 minutos, e auth.getToken() os renova para você. Outras linguagens verificam o mesmo token com os SDKs de servidor ou com qualquer biblioteca JWT, como mostra tokens e JWKS.
7

Veja o login no console

Abra Authentication > Sign-ins. Seu login aparece com o resultado, o método, o dispositivo, a localização e o risco, ao lado dos logins de exemplo com que toda sandbox começa. A pessoa aparece em Users.
A página Sign-ins no Didit Business Console, listando as tentativas de login com estado, pessoa, método, dispositivo, localização, risco e horário

Authentication > Sign-ins: cada tentativa, com filtros por estado, método e risco.

Para receber a atividade de login no seu servidor, assine um destino do webhook para auth.signup e auth.login. Veja eventos e webhooks.

Antes de ir para produção

  1. Ative a Autenticação para a sua aplicação Live na página Products.
  2. Registre ali as suas URLs de redirecionamento e origens https:// de produção: uma aplicação Live aceita somente https://.
  3. Substitua as credenciais de teste do Didit para login social pelo ID do cliente e pelo segredo do seu próprio aplicativo.
  4. Copie a chave publicável Live (pk_live_) para a sua configuração de produção.
  5. Siga o checklist para entrar em produção.

Próximos passos

Guia de integração

Telas hospedadas ou próprias, armazenamento de tokens, sessões, elevação de autenticação e solução de problemas.

React e Next.js

Componentes, hooks, cookies HttpOnly e auth() no servidor.

iOS, Android, React Native e Flutter

Login nativo com o navegador do sistema, passkeys e armazenamento protegido.

Proteção contra bots

Ative as políticas que bloqueiam bots e a tomada de conta.
Última modificação em 22 de novembro de 2026