Saltar al contingut principal
Aquesta guia explica com encaixa una integració d’Autenticació de Didit en producció, des de la primera redirecció fins a la llista de verificació per a la posada en producció. Comença per la guia d’inici ràpid si encara no has autenticat cap persona, i utilitza les guies d’inici ràpid de la plataforma per al codi de cada SDK.

Arquitectura

Hi intervenen quatre elements: Cap clau d’API de Didit ni cap secret no han d’estar mai a la teva aplicació: la clau publicable és pública, i l’intercanvi del codi està protegit amb PKCE en lloc d’un secret de client.

Pàgines allotjades o pantalles pròpies

Tria on les persones introdueixen el seu correu electrònic, contrasenya o codi. La configuració és sign_in_ui (hosted per defecte, o own), i pots canviar-la més tard. Les passkeys pertanyen a l’origen d’inici de sessió de la teva aplicació. Els mètodes de passkeys dels SDK només funcionen a les pàgines servides des d’aquest origen, així que, a les teves pantalles pròpies en un altre domini, envia les persones a la pàgina allotjada per a les passkeys.

Tria el teu SDK

Si no fas servir cap SDK, implementa tu mateix el flux de codi d’autorització amb PKCE: la guia d’inici ràpid de JavaScript mostra tot el contracte.

Protegeix el teu backend

Un control de la sessió al frontend només controla el que mostres. El teu backend pren cada decisió a partir d’un token verificat.
  1. Verifica el token d’accés en cada sol·licitud. Comprova la signatura ES256 amb el JWKS del teu emissor, després iss, aud, exp i typ: at+jwt, i rebutja qualsevol token amb act diferent de null, tret que la ruta accepti agents d’IA. Consulta com verificar un token al teu servidor.
  2. Comprova la sessió activa abans d’una acció sensible. Un token d’accés segueix sent vàlid fins que caduca, com a màxim 5 minuts. GET /session/ falla immediatament quan la sessió s’ha revocat, ha estat inactiva o ha caducat, quan la persona ha estat bloquejada o quan la sessió ja no compleix la teva política de MFA. Consulta com comprovar la sessió.
  3. Demana un pas de verificació addicional quan l’acció sigui arriscada. Abans d’un pagament, d’un compte bancari nou o d’un canvi de correu electrònic o de telèfon, pregunta a Didit si la persona ha de tornar a verificar-se, i actua només amb un pas addicional approved que el teu backend hagi llegit per si mateix. Consulta pas addicional abans d’accions sensibles.
  4. Pren vendor_data del token verificat, mai d’un camp que hagi enviat el navegador, i fes-lo servir per a les verificacions i les transaccions de la persona.

Sessions

Canvia les durades a Authentication > Security and sessions, o per API a la configuració de l’aplicació.
La vista Active sessions de la Didit Business Console, que enumera les sessions amb inici de sessió i mostra el dispositiu, la ubicació, l'inici, l'última activitat, la finalització i un botó Revoke

Authentication > Sign-ins > Active sessions, amb Revoke a cada sessió.

Aplicacions natives

Didit retorna les persones a una aplicació nativa només mitjançant una redirecció HTTPS: no accepta esquemes d’URL personalitzats.
  • iOS: fes que la redirecció sigui un domini associat, amb webcredentials al teu apple-app-site-association.
  • Android: fes que la redirecció sigui un App Link, amb el teu assetlinks.json.
  • Registra cada URL de redirecció a Authentication > Security and sessions, igual que un callback web.
Per a les claus d’accés de la teva aplicació, registra amb PUT native-apps/ les aplicacions que comparteixen les claus d’accés de la teva aplicació a l’API de gestió d’autenticació. Didit les inclourà després al apple-app-site-association i al assetlinks.json que serveix al teu origen d’inici de sessió. MANAGEMENT_BASE és l’adreça de l’API de gestió de la teva aplicació, i una clau d’API amb l’àmbit authentication en escriptura pot fer la crida. La crida substitueix les dues llistes, així que envia-les totes dues:
Les guies d’inici ràpid per a iOS i Android mostren la part de l’aplicació.

Connecta la verificació d’identitat i el monitoratge de transaccions

Cada persona té un únic valor de vendor_data, tant als seus tokens com a la seva sessió. Utilitza’l com a vendor_data quan crees una sessió de verificació o envies una transacció, i la consola mostra els inicis de sessió, les verificacions i les transaccions de la mateixa persona.
  • Per verificar les persones en el registre o de nou abans d’un pagament, sense crear un flux de verificació, fes servir identitat verificada.
  • Els esdeveniments d’inici de sessió arriben automàticament a les regles d’esdeveniments i a les vistes de frau. No envies els teus propis esdeveniments auth.login per als mateixos inicis de sessió.
  • Un inici de sessió satisfactori mai aprova una verificació ni una transacció: gestiona la decisió de cada producte per separat.
Consulta mantén una mateixa persona entre productes.

Rebre esdeveniments d’inici de sessió

Subscriu una destinació del webhook als tipus auth.* que necessitis, com ara auth.new_device o auth.account_locked. Elimina els duplicats amb auth_event.event_id i verifica la signatura igual que per a qualsevol webhook de Didit. Consulta esdeveniments i webhooks per veure tots els tipus i el seu payload.

Migra els usuaris existents

Si els teus usuaris ja tenen comptes en una altra plataforma d’identitat o a la teva pròpia base de dades, importa’ls abans de canviar el mètode d’inici de sessió. Importa els hashes de contrasenya quan l’origen els proporcioni, conserva els enllaços a xarxes socials i guarda els teus propis IDs d’usuari com a external_id, que es converteix en el seu vendor_data. No canvia res per a ells fins que no canviïs la teva aplicació a Didit.

Llista de verificació per a la posada en producció

  1. La autenticació està activada per a la teva aplicació Live a la pàgina Products.
  2. Les URL de redirecció https:// de producció i els orígens permesos estan registrats a l’aplicació Live. Una aplicació Live no accepta adreces http://.
  3. Cada mètode d’inici de sessió social utilitza el client ID i el secret de la teva pròpia aplicació: les credencials de prova de Didit només funcionen a Sandbox.
  4. La configuració de producció conté la clau publicable Live (pk_live_) i el teu emissor Live.
  5. La política de MFA, la durada de la sessió, el temps d’inactivitat, la longitud de la contrasenya i la política de registre són les que vols. Consulta la configuració de l’aplicació.
  6. La Protecció contra bots està activada, amb la comprovació de contrasenyes filtrades.
  7. El teu backend verifica cada token d’accés i crida GET /session/ abans de les accions sensibles.
  8. La teva marca, els textos de la pàgina i els enllaços a les condicions d’ús i a la política de privadesa estan configurats. Si tens previst fer servir un domini personalitzat, activa’l abans que els usuaris comencin a afegir claus d’accés.
  9. La destinació del teu webhook està subscrita als tipus auth.* que gestiones.
  10. Has provat l’alta, l’inici de sessió dels usuaris existents, la cancel·lació, la recuperació de la contrasenya, el MFA, la caducitat de la sessió, el tancament de sessió i una sessió revocada a l’aplicació Live.

Resolució de problemes

Darrera modificació el 22 de novembre del 2026