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ó éssign_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.- Verifica el token d’accés en cada sol·licitud. Comprova la signatura ES256 amb el JWKS del teu emissor, després
iss,aud,expityp: at+jwt, i rebutja qualsevol token ambactdiferent denull, tret que la ruta accepti agents d’IA. Consulta com verificar un token al teu servidor. - 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ó. - 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
approvedque el teu backend hagi llegit per si mateix. Consulta pas addicional abans d’accions sensibles. - Pren
vendor_datadel 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ó.

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
webcredentialsal teuapple-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.
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 devendor_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.loginper 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.
Rebre esdeveniments d’inici de sessió
Subscriu una destinació del webhook als tipusauth.* 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 aexternal_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ó
- La autenticació està activada per a la teva aplicació Live a la pàgina Products.
- Les URL de redirecció
https://de producció i els orígens permesos estan registrats a l’aplicació Live. Una aplicació Live no accepta adreceshttp://. - 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.
- La configuració de producció conté la clau publicable Live (
pk_live_) i el teu emissor Live. - 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ó.
- La Protecció contra bots està activada, amb la comprovació de contrasenyes filtrades.
- El teu backend verifica cada token d’accés i crida
GET /session/abans de les accions sensibles. - 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.
- La destinació del teu webhook està subscrita als tipus
auth.*que gestiones. - 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.