Saltar al contingut principal
Aquesta guia ràpida fa que Didit Authentication funcioni de principi a fi en uns 10 minuts. Registres un callback en una aplicació sandbox, actives un mètode d’inici de sessió, fas que una persona iniciï sessió amb la pàgina d’inici de sessió allotjada, verifiques el seu token d’accés al teu servidor i veus l’inici de sessió a la consola.

Requisits previs

  • Un compte de Didit amb una aplicació sandbox. Crear un compte és gratuït, i totes les aplicacions sandbox tenen l’Autenticació activada.
  • Node.js 20 o posterior, i una aplicació web que puguis executar a http://localhost:3000.

Passos

1

Obre la teva aplicació sandbox

Al Business Console, fes servir el selector d’aplicacions per seleccionar la teva aplicació Sandbox i, després, obre Authentication.Una aplicació Sandbox accepta URL de callback amb http://localhost i les credencials de prova de Didit per a l’inici de sessió amb xarxes socials, i mai no es factura. Una aplicació Live activa Authentication des de la pàgina Products: consulta prepara la teva aplicació.
2

Registra el teu callback i l'origen

Obre Authentication > Security and sessions > Redirect URLs and allowed origins i afegeix:Didit només retorna una persona a una URL de redirecció que hagis registrat, caràcter per caràcter. L’origen permès permet que el navegador intercanviï el codi amb l’origen de Didit de la teva aplicació.
La targeta Redirect URLs and allowed origins de la Didit Business Console, al costat de la llista de permesos, la llista de bloqueig i la URL d'inici de sessió

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

3

Activa un mètode d'inici de sessió

Obre Authentication > Sign-in methods i activa Email code. Una aplicació nova comença amb tots els mètodes desactivats, i la pàgina allotjada només ofereix els mètodes que activis.Afegeix també Passkeys si vols, o bé un mètode d’inici de sessió amb xarxes socials amb credencials de prova de Didit, que funcionen en Sandbox sense una aplicació pròpia. Tots els mètodes es descriuen a mètodes d’inici de sessió.
La pàgina Sign-in methods de la Didit Business Console, amb la targeta de la pàgina d'inici de sessió allotjada, els mètodes sense contrasenya i amb contrasenya, i una previsualització en directe de la pàgina allotjada

Authentication > Sign-in methods, amb una previsualització en directe de la pàgina allotjada.

4

Copia la teva clau publicable

Obre Authentication > Developers i copia la Publishable key. En una aplicació Sandbox comença amb pk_test_.La clau publicable és pública i identifica l’origen d’inici de sessió de Didit de la teva aplicació. No posis mai la Secret key en codi de navegador ni de mòbil.
5

Instal·la el SDK i inicia sessió

auth.ts
Fes clic al botó: la pàgina allotjada demana una adreça de correu electrònic i envia un codi de sis dígits. Introdueix el codi, i Didit et retorna a la teva URL de callback, que intercanvia el codi d’un sol ús pels tokens de la sessió. Un primer inici de sessió amb una adreça que no té compte en crea un, perquè la política de registre predeterminada permet que qualsevol es registri.
La pàgina d'inici de sessió allotjada en un telèfon, amb un botó de clau d'accés i els camps de correu electrònic i contrasenya

La pàgina d'inici de sessió allotjada en un telèfon. Només mostra els mètodes que has activat.

6

Verifica el token al teu servidor

Envia el token d’accés de auth.getToken() al teu backend a la capçalera Authorization, i verifica’l allà a cada sol·licitud protegida:
server.ts
verifyToken comprova la signatura ES256 amb les claus publicades del teu emissor, i comprova l’emissor i la data de caducitat. Els tokens d’accés duren com a màxim 5 minuts, i auth.getToken() els renova per tu. En altres llenguatges, pots verificar el mateix token amb els SDK de servidor o amb qualsevol biblioteca JWT, tal com s’explica a tokens i JWKS.
7

Consulta l'inici de sessió a la consola

Obre Authentication > Sign-ins. El teu inici de sessió apareix amb el seu resultat, mètode, dispositiu, ubicació i risc, al costat dels inicis de sessió d’exemple amb què comença cada sandbox. La persona apareix a Users.
La pàgina Sign-ins de la Didit Business Console, amb la llista d'intents d'inici de sessió amb el seu estat, persona, mètode, dispositiu, ubicació, risc i hora

Authentication > Sign-ins: cada intent, amb filtres per estat, mètode i risc.

Per rebre l’activitat d’inici de sessió al teu servidor, subscriu una destinació del webhook a auth.signup i auth.login. Consulta esdeveniments i webhooks.

Abans de passar a producció

  1. Activa l’autenticació per a la teva aplicació Live a la pàgina Products.
  2. Registra-hi les URL de redirecció i els orígens de producció amb https://: una aplicació Live només accepta https://.
  3. Substitueix les credencials de prova de Didit per a l’inici de sessió amb xarxes socials pel client ID i el secret de la teva pròpia aplicació.
  4. Copia la clau publicable Live (pk_live_) a la configuració de producció.
  5. Repassa la llista de verificació per a la sortida en producció.

Passos següents

Guia d'integració

Pantalles allotjades o pròpies, emmagatzematge de tokens, sessions, autenticació reforçada i resolució de problemes.

React i Next.js

Components, hooks, cookies HttpOnly i auth() al servidor.

iOS, Android, React Native i Flutter

Inici de sessió natiu amb el navegador del sistema, passkeys i emmagatzematge protegit.

Protecció contra bots

Activa les polítiques que aturen els bots i la presa de control de comptes.
Darrera modificació el 22 de novembre del 2026