Vai al contenuto principale
Questa guida rapida ti permette di far funzionare Didit Authentication dall’inizio alla fine in circa 10 minuti. Registri un URL di callback in un’applicazione sandbox, attivi un metodo di accesso, fai accedere una persona tramite la pagina di accesso ospitata, verifichi il suo token di accesso sul tuo server e controlli l’accesso nella console.

Prerequisiti

  • Un account Didit con un’applicazione Sandbox. La creazione di un account è gratuita e in ogni applicazione Sandbox l’Autenticazione è attiva.
  • Node.js 20 o successivo e un’app web che puoi eseguire su http://localhost:3000.

Passaggi

1

Apri la tua applicazione sandbox

Nella Business Console, usa il selettore delle applicazioni per selezionare la tua applicazione Sandbox, quindi apri Authentication.Un’applicazione Sandbox accetta callback su http://localhost e le credenziali di test di Didit per l’accesso con i social, e non viene mai fatturata. Un’applicazione Live attiva invece Authentication dalla pagina Products: vedi preparare la tua applicazione.
2

Registra il tuo URL di callback e l'origine

Apri Authentication > Security and sessions > Redirect URLs and allowed origins e aggiungi:Didit restituisce una persona solo a un URL di reindirizzamento che hai registrato, carattere per carattere. L’origine consentita permette al browser di scambiare il codice con l’origine Didit della tua applicazione.
La card Redirect URLs and allowed origins nella Didit Business Console, accanto ad allowlist e blocklist e all'URL di accesso

URL di reindirizzamento e origini consentite, in Authentication > Security and sessions.

3

Attiva un metodo di accesso

Apri Authentication > Sign-in methods e attiva Email code. Una nuova applicazione parte con tutti i metodi disattivati, e la pagina ospitata mostra solo i metodi che attivi.Aggiungi anche Passkeys se vuoi, oppure un metodo di accesso social usando le credenziali di test di Didit, che funzionano in Sandbox senza una tua app. Ogni metodo è descritto in metodi di accesso.
La pagina Sign-in methods nella Didit Business Console, con la card della pagina di accesso ospitata, i metodi senza password e con password e un'anteprima in tempo reale della pagina ospitata

Authentication > Sign-in methods, con un'anteprima in tempo reale della pagina ospitata.

4

Copia la tua chiave pubblicabile

Apri Authentication > Developers e copia la Publishable key. In un’applicazione Sandbox inizia con pk_test_.La chiave pubblicabile è pubblica e identifica l’origine di accesso Didit della tua applicazione. Non inserire mai la Secret key nel codice del browser o delle app mobili.
5

Installa l'SDK e accedi

auth.ts
Clicca sul tuo pulsante: la pagina ospitata chiede un indirizzo email e invia un codice di sei cifre. Inserisci il codice, e Didit ti riporta al tuo callback, che scambia il codice monouso con i token della sessione. Un primo accesso con un indirizzo che non ha ancora un account ne crea uno, perché il criterio di registrazione predefinito permette a chiunque di registrarsi.
La pagina di accesso ospitata su un telefono, con un pulsante passkey e campi per email e password

La pagina di accesso ospitata su un telefono. Mostra solo i metodi che hai attivato.

6

Verifica il token sul tuo server

Invia il token di accesso da auth.getToken() al tuo backend nell’intestazione Authorization, e verificalo lì a ogni richiesta protetta:
server.ts
verifyToken verifica la firma ES256 rispetto alle chiavi pubblicate dal tuo emittente e controlla l’emittente e la scadenza. I token di accesso durano al massimo 5 minuti, e auth.getToken() li rinnova per te. Gli altri linguaggi verificano lo stesso token con gli SDK lato server o con una qualsiasi libreria JWT, come mostra token e JWKS.
7

Vedi l'accesso nella console

Apri Authentication > Sign-ins. Il tuo accesso è elencato con il suo esito, metodo, dispositivo, posizione e rischio, accanto agli accessi di esempio con cui ogni sandbox inizia. La persona compare sotto Users.
La pagina Sign-ins nella Didit Business Console, che elenca i tentativi di accesso con stato, persona, metodo, dispositivo, posizione, rischio e orario

Authentication > Sign-ins: ogni tentativo, con filtri per stato, metodo e rischio.

Per ricevere l’attività di accesso sul tuo server, associa una destinazione webhook agli eventi auth.signup e auth.login. Vedi eventi e webhook.

Prima di andare in produzione

  1. Attiva l’autenticazione per la tua applicazione Live nella pagina Products.
  2. Registra in quella stessa pagina i tuoi URL di reindirizzamento e le origini di produzione https://: un’applicazione Live accetta solo https://.
  3. Sostituisci le credenziali di test di Didit per l’accesso tramite social con l’ID client e il segreto della tua app.
  4. Copia la chiave pubblicabile Live (pk_live_) nella configurazione di produzione.
  5. Segui la checklist per la messa in produzione.

Prossimi passi

Guida all'integrazione

Schermate ospitate o proprie, archiviazione dei token, sessioni, step-up e risoluzione dei problemi.

React e Next.js

Componenti, hook, cookie HttpOnly e auth() lato server.

iOS, Android, React Native e Flutter

Accesso nativo con il browser di sistema, passkey e archiviazione protetta.

Protezione dai bot

Attiva le policy che bloccano i bot e la presa di controllo degli account.
Ultima modifica il 22 novembre 2026