Vai al contenuto principale
Questa guida spiega come si compone un’integrazione di Didit Authentication nell’ambiente di produzione, dal primo reindirizzamento fino alla checklist per la messa in produzione. Inizia con la guida rapida se non hai ancora autenticato un utente, e usa le guide rapide delle piattaforme per il codice di ciascun SDK.

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.
  1. Verifica il token di accesso a ogni richiesta. Controlla la firma ES256 rispetto al JWKS dell’emittente, poi iss, aud, exp e typ: at+jwt, e rifiuta un token il cui act non sia null, a meno che l’endpoint non accetti agenti AI. Vedi come verificare un token sul tuo server.
  2. 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.
  3. 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 approved che il tuo backend ha letto direttamente. Vedi step-up prima delle azioni sensibili.
  4. Prendi vendor_data dal 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.
La vista Active sessions nella Didit Business Console, che elenca le sessioni attive con dispositivo, posizione, inizio, ultima attività, fine e un pulsante Revoke

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 webcredentials nel tuo apple-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.
Per le passkey nella tua app, registra le app che condividono le passkey della tua applicazione con 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 valore vendor_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.login per gli stessi accessi.
  • Un accesso riuscito non approva mai una verifica o una transazione: gestisci separatamente la decisione di ciascun prodotto.
Vedi mantieni la stessa persona tra i prodotti.

Ricevere gli eventi di accesso

Sottoscrivi una destinazione webhook ai tipi auth.* 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 come external_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

  1. L’autenticazione è attiva per la tua applicazione Live nella pagina Products.
  2. Gli URL di reindirizzamento https:// di produzione e le origini consentite sono registrati nell’applicazione Live. Un’applicazione Live non accetta indirizzi http://.
  3. 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.
  4. La configurazione di produzione contiene la chiave pubblicabile Live (pk_live_) e il tuo issuer Live.
  5. 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.
  6. La protezione dai bot è attiva, con il controllo delle password compromesse.
  7. Il tuo backend verifica ogni access token e chiama GET /session/ prima delle azioni sensibili.
  8. 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.
  9. La tua destinazione webhook è iscritta ai tipi auth.* che gestisci.
  10. 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.

Risoluzione dei problemi

Ultima modifica il 22 novembre 2026