Saltar para o conteúdo principal
Este guia rápido põe o Didit Authentication a funcionar de ponta a ponta em cerca de 10 minutos. Você regista um URL de retorno numa aplicação sandbox, ativa um método de início de sessão, inicia a sessão de uma pessoa através da página de início de sessão alojada, valida o token de acesso no seu servidor e vê o início de sessão na consola.

Pré-requisitos

  • Uma conta Didit com uma aplicação Sandbox. Criar uma conta é gratuito, e todas as aplicações Sandbox têm a Autenticação ativada.
  • Node.js 20 ou superior, e uma aplicação web que possa ser executada em http://localhost:3000.

Passos

1

Abra a sua aplicação sandbox

Na Business Console, use o seletor de aplicações para selecionar a sua aplicação Sandbox e, em seguida, abra Authentication.Uma aplicação Sandbox aceita URLs de retorno http://localhost e as credenciais de teste do Didit para o início de sessão social, e nunca é faturada. Uma aplicação Live ativa o Authentication a partir da página Products: veja preparar a sua aplicação.
2

Registe o seu URL de retorno e a sua origem

Abra Authentication > Security and sessions > Redirect URLs and allowed origins e adicione:O Didit só redireciona uma pessoa para um URL de redirecionamento que tenha registado, carácter a carácter. A origem permitida permite que o navegador troque o código com a origem do Didit da sua aplicação.
O cartão Redirect URLs and allowed origins na Didit Business Console, junto à lista de permissões e de bloqueio e ao URL de início de sessão

URLs de redirecionamento e origens permitidas, em Authentication > Security and sessions.

3

Ative um método de início de sessão

Abra Authentication > Sign-in methods e ative Email code. Uma nova aplicação começa com todos os métodos desativados, e a página alojada oferece apenas os métodos que tiver ativado.Se quiser, adicione também Passkeys, ou um método de início de sessão social com as credenciais de teste do Didit, que funcionam no Sandbox sem uma aplicação própria. Cada método está descrito em métodos de início de sessão.
A página Sign-in methods na Didit Business Console, com o cartão da página de início de sessão alojada, os métodos sem palavra-passe e com palavra-passe e uma pré-visualização em tempo real da página alojada

Authentication > Sign-in methods, com uma pré-visualização em tempo real da página alojada.

4

Copie a sua chave publicável

Abra Authentication > Developers e copie a Publishable key. Numa aplicação Sandbox, começa por pk_test_.A chave publicável é pública e identifica a origem de início de sessão do Didit da sua aplicação. Nunca coloque a Secret key em código executado no navegador ou em aplicações móveis.
5

Instale o SDK e inicie sessão

auth.ts
Clique no seu botão: a página alojada pede um endereço de e-mail e envia um código de seis dígitos. Introduza o código, e o Didit redireciona-o para o seu URL de retorno, que troca o código de utilização única pelos tokens da sessão. Um primeiro início de sessão com um endereço sem conta cria uma, porque a política de registo predefinida permite que qualquer pessoa se registe.
A página de início de sessão alojada num telemóvel, com um botão de passkey e campos de e-mail e palavra-passe

A página de início de sessão alojada num telemóvel. Mostra apenas os métodos que ativou.

6

Verifique o token no seu servidor

Envie o token de acesso de auth.getToken() para o seu backend, no cabeçalho Authorization do pedido, e verifique-o aí em cada pedido protegido:
server.ts
verifyToken verifica a assinatura ES256 com base nas chaves publicadas pelo seu emissor, bem como o emissor e a expiração. Os tokens de acesso duram no máximo 5 minutos, e auth.getToken() renova-os por si. Noutras linguagens, verifique o mesmo token com os SDKs de servidor ou com qualquer biblioteca JWT, como mostra tokens e JWKS.
7

Veja o início de sessão na consola

Abra Authentication > Sign-ins. O seu início de sessão aparece listado com o resultado, o método, o dispositivo, a localização e o risco, junto aos inícios de sessão de exemplo com que cada sandbox começa. A pessoa aparece em Users.
A página Sign-ins na Didit Business Console, com a lista de tentativas de início de sessão, o estado, a pessoa, o método, o dispositivo, a localização, o risco e a hora

Authentication > Sign-ins: todas as tentativas, com filtros por estado, método e risco.

Para receber a atividade de início de sessão no seu servidor, subscreva um destino de webhook aos eventos auth.signup e auth.login. Veja eventos e webhooks.

Antes de entrar em produção

  1. Ative a Autenticação para a sua aplicação Live na página Products.
  2. Registe os seus URL de redirecionamento e origens de produção https:// nessa página: uma aplicação Live aceita apenas https://.
  3. Substitua as credenciais de teste da Didit para o início de sessão social pelo ID do cliente e pelo segredo da sua própria aplicação.
  4. Copie a chave publicável Live (pk_live_) para a sua configuração de produção.
  5. Percorra a lista de verificação para entrada em produção.

Próximos passos

Guia de integração

Ecrãs alojados ou os seus próprios ecrãs, armazenamento de tokens, sessões, autenticação adicional e resolução de problemas.

React e Next.js

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

iOS, Android, React Native e Flutter

Início de sessão nativo com o navegador do sistema, chaves de acesso e armazenamento protegido.

Proteção contra bots

Ative as políticas que impedem bots e a apropriação de contas.
Última modificação em 22 de novembro de 2026