Architecture
Sono coinvolte quattro parti:
Nella tua app non deve mai trovarsi alcuna chiave API Didit né alcun segreto: la chiave pubblicabile è pubblica, e lo scambio del codice è protetto da PKCE invece che da un segreto del client.
Pagine ospitate o schermate proprie
Scegli dove le persone digitano la propria email, password o codice. L’impostazione èsign_in_ui (hosted per impostazione predefinita, oppure own), e puoi modificarla in seguito.
Le passkey appartengono all’origine di accesso della tua applicazione.
I metodi passkey degli SDK funzionano solo sulle pagine servite da quell’origine, quindi, nelle tue schermate proprie su un altro dominio, indirizza le persone alla pagina ospitata per le passkey.
Scegli il tuo SDK
Senza un SDK, implementa tu stesso il flusso del codice di autorizzazione con PKCE: la guida rapida JavaScript mostra l’intero contratto.
Proteggi il tuo backend
Un controllo della sessione lato frontend regola solo ciò che mostri. Il tuo backend prende ogni decisione a partire da un token verificato.- Verifica il token di accesso a ogni richiesta. Controlla la firma ES256 rispetto al JWKS dell’emittente, poi
iss,aud,expetyp: at+jwt, e rifiuta un token il cuiactnon sianull, a meno che l’endpoint non accetti agenti AI. Vedi come verificare un token sul tuo server. - Controlla la sessione attiva prima di un’azione sensibile. Un token di accesso resta valido fino alla scadenza, entro 5 minuti.
GET /session/fallisce subito quando la sessione è stata revocata, è rimasta inattiva o è scaduta, quando la persona è stata bloccata, o quando la sessione non rispetta più la tua policy MFA. Vedi controllo della sessione. - Richiedi uno step-up quando l’azione è rischiosa. Prima di un’erogazione o di un pagamento in uscita, di un nuovo conto bancario o di una modifica dell’email o del telefono, chiedi a Didit se la persona deve verificarsi di nuovo, e agisci solo su uno step-up
approvedche il tuo backend ha letto direttamente. Vedi step-up prima delle azioni sensibili. - Prendi
vendor_datadal token verificato, mai da un campo inviato dal browser, e usalo per le verifiche e le transazioni della persona.
Sessioni
Puoi modificare le durate in Authentication > Security and sessions oppure tramite API nelle impostazioni dell’applicazione.

Authentication > Sign-ins > Active sessions, con Revoke su ogni sessione.
App native
Didit reindirizza le persone verso un’app nativa solo tramite reindirizzamento HTTPS: non accetta schemi URL personalizzati.- iOS: configura il reindirizzamento come dominio associato, con
webcredentialsnel tuoapple-app-site-association. - Android: configura il reindirizzamento come App Link, con il tuo
assetlinks.json. - Registra ogni URL di reindirizzamento in Authentication > Security and sessions, come un callback web.
PUT native-apps/ tramite la API di gestione dell’autenticazione.
Didit include poi queste app nell’apple-app-site-association e nell’assetlinks.json che pubblica sulla tua origine di accesso.
MANAGEMENT_BASE è l’indirizzo dell’API di gestione della tua applicazione, e una chiave API con lo scope authentication in scrittura può effettuare la chiamata.
La chiamata sostituisce entrambi gli elenchi, quindi inviali entrambi:
Le guide rapide per iOS e Android mostrano il lato app.
Collega la verifica dell’identità e il monitoraggio delle transazioni
Ogni persona ha un unico valorevendor_data, nei suoi token e nella sua sessione.
Usalo come vendor_data quando crei una sessione di verifica o invii una transazione, e la console mostra accessi, verifiche e transazioni riferiti alla stessa persona.
- Per verificare le persone in fase di registrazione o di nuovo prima di un pagamento, senza costruire un flusso di verifica, usa identità verificata.
- Gli eventi di accesso arrivano automaticamente alle regole sugli eventi e alle viste antifrode. Non inviare i tuoi eventi
auth.loginper gli stessi accessi. - Un accesso riuscito non approva mai una verifica o una transazione: gestisci separatamente la decisione di ciascun prodotto.
Ricevere gli eventi di accesso
Sottoscrivi una destinazione webhook ai tipiauth.* di cui hai bisogno, come auth.new_device o auth.account_locked.
Deduplica in base a auth_event.event_id e verifica la firma come per ogni webhook di Didit.
Consulta eventi e webhook per ogni tipo e il relativo payload.
Sposta gli utenti esistenti
Se i tuoi utenti hanno già un account su un’altra piattaforma di identità o nel tuo database, importali prima di passare all’accesso con Didit. Importa gli hash delle password dove la fonte li fornisce, mantieni i collegamenti social e conserva i tuoi ID utente comeexternal_id, che diventa il loro vendor_data.
Per gli utenti non cambia nulla finché non passi la tua app a Didit.
Checklist per il go-live
- L’autenticazione è attiva per la tua applicazione Live nella pagina Products.
- Gli URL di reindirizzamento
https://di produzione e le origini consentite sono registrati nell’applicazione Live. Un’applicazione Live non accetta indirizzihttp://. - Ogni metodo di accesso social usa il client ID e il secret della tua app: le credenziali di test di Didit funzionano solo in sandbox.
- La configurazione di produzione contiene la chiave pubblicabile Live (
pk_live_) e il tuo issuer Live. - La policy MFA, la durata della sessione, il timeout di inattività, la lunghezza della password e la policy di registrazione sono quelle che desideri. Vedi impostazioni dell’applicazione.
- La protezione dai bot è attiva, con il controllo delle password compromesse.
- Il tuo backend verifica ogni access token e chiama
GET /session/prima delle azioni sensibili. - Il branding, i testi delle pagine e i link ai termini e all’informativa sulla privacy sono configurati. Se prevedi di usare un dominio personalizzato, attivalo prima che le persone inizino ad aggiungere passkey.
- La tua destinazione webhook è iscritta ai tipi
auth.*che gestisci. - Hai testato sull’applicazione Live la registrazione, l’accesso di chi è già registrato, l’annullamento, il recupero della password, MFA, la scadenza della sessione, il logout e una sessione revocata.