SDK di verifica dell'identità web: JavaScript e iframe

Queste guide riguardano la verifica dell’identità. Per l’accesso degli utenti finali, usa le guide della piattaforma Authentication; i nuovi pacchetti Authentication dipendono dalla release.

Integra la verifica Didit nella tua applicazione web. Offriamo sette metodi di integrazione per adattarsi alla tua architettura e ai requisiti di esperienza utente: scegli quello più adatto al tuo stack.

Scegli il tuo metodo di integrazione: dagli iframe senza codice, per una configurazione rapida, al controllo programmatico completo con il nostro SDK JavaScript, oppure plugin pronti all’uso per WordPress, Shopify e Salesforce.

Metodi di integrazione

Metodo	Tempo di configurazione	Backend?	Ideale per
SDK JavaScript	3 minuti	Opzionale	Controllo completo: React/Vue/Angular/Next.js/Nuxt/Svelte/vanilla
InContext (Iframe)	< 1 minuto	Opzionale	Esperienza integrata senza reindirizzamento
Redirect	5 minuti	Sì	Massima compatibilità, flussi cross-device
WebView (iOS/Android)	15 minuti	Sì	Alternativa mobile quando non è disponibile un SDK nativo
WordPress + WooCommerce	5 minuti	Nessun codice	Siti WordPress, negozi WooCommerce
Shopify	5 minuti	Nessun codice	Negozi Shopify: verifica al checkout o dell’account
Salesforce	10 minuti	Nessun codice	CRM Salesforce: verifica dei record Contact/Lead

Raccomandazione: per le applicazioni web in produzione, usa l’SDK JavaScript per la migliore UX e il controllo programmatico completo. Usa l’iframe InContext per la configurazione più rapida, Redirect quando serve la verifica cross-device, e le integrazioni dedicate WordPress / Shopify / Salesforce se lavori su queste piattaforme.

SDK JavaScript

L’SDK JavaScript di Didit offre un modo programmatico per integrare la verifica, con il controllo completo dell’esperienza utente. Funzionalità principali:

Gestione delle sessioni e callback degli eventi
Supporto per React, Vue, Angular, NextJS, Nuxt, Svelte e JS vanilla
Supporto TypeScript completo
Modalità modale e inline

Avvio rapido:

import { DiditSdk } from '@didit-protocol/sdk-web';

DiditSdk.shared.onComplete = (result) => {
  switch (result.type) {
    case 'completed':
      console.log('Verification completed!');
      console.log('Session ID:', result.session?.sessionId);
      console.log('Status:', result.session?.status);
      break;
    case 'cancelled':
      console.log('User cancelled verification');
      break;
    case 'failed':
      console.error('Verification failed:', result.error?.message);
      break;
  }
};

// Start verification with the `url` returned by POST /v3/session/ (or your UniLink)
DiditSdk.shared.startVerification({
  url: 'https://verify.didit.me/session/3FaJ9wLqX2Mz'
});

→ Documentazione completa dell’SDK JavaScript

InContext (Iframe)

Integra il flusso di verifica direttamente nella tua applicazione tramite un iframe. Un’esperienza fluida, senza reindirizzare gli utenti fuori dal tuo sito. Funzionalità principali:

UniLink (nessun backend richiesto): configurazione in < 1 minuto
Sessione API (con backend): personalizzazione completa
Implementazioni modali e inline
Esempi di componenti React

Avvio rapido:

<iframe 
  src="https://verify.didit.me/u/YOUR_WORKFLOW_ID_BASE64"
  style="width: 100%; height: 700px; border: none;" 
  allow="camera; microphone; geolocation; clipboard-write; fullscreen; autoplay; encrypted-media; digital-credentials-get"
></iframe>

→ Documentazione completa di InContext

Redirect

Reindirizza gli utenti alla pagina di verifica ospitata da Didit. Al termine, gli utenti tornano al tuo URL di callback. Funzionalità principali:

Massima compatibilità con i browser
Supporto per la verifica cross-device
Integrazione semplice
Funziona quando l’accesso alla fotocamera nell’iframe presenta problemi

Avvio rapido:

// After creating a session via your backend
window.location.href = verificationUrl;

→ Documentazione completa di Redirect

Confronto

Funzionalità	SDK JavaScript	InContext (Iframe)	Redirect
Tempo di configurazione	3 min	< 1 min	5 min
Backend richiesto	Opzionale	Opzionale	Sì
Resta sul tuo dominio	Sì	Sì	No
Supporto cross-device	Sì	Sì	Sì
Controllo programmatico completo	Sì	Limitato	Solo callback
Callback degli eventi	In tempo reale	`postMessage`	Solo callback
White-label	Sì	Sì	Sì
Compatibilità con i browser	Tutti	Tutti	Tutti

Tutti e tre i metodi forniscono i risultati finali firmati tramite webhook: la tabella sopra descrive l’esperienza utente nel browser, non il modo in cui ricevi la decisione sulla verifica.

Configurazione

Permessi richiesti per l’iframe

Per le integrazioni con iframe InContext, includi sempre questi permessi:

allow="camera; microphone; geolocation; clipboard-write; fullscreen; autoplay; encrypted-media; digital-credentials-get"

Repository di esempio

Esempi web SDK

Esempi per React, Vue, Angular, Next.js, Nuxt, Svelte e JS vanilla

Esempio iframe

Esempi di iframe con UniLink e con sessione API

Demo completa Next.js

Integrazione Next.js end-to-end

Pacchetto NPM

@didit-protocol/sdk-web su npm

Correlati

Webhook: ricevi sul tuo backend i risultati di verifica firmati
API Create Session: l’endpoint alla base di ogni SDK web
SDK nativi: iOS, Android, React Native, Flutter

Guide

Autenticazione

Model Context Protocol (MCP)

SDK web

SDK nativi

SDK server

Integrazioni

SDK di verifica dell'identità web: JavaScript e iframe

Metodi di integrazione

SDK JavaScript

InContext (Iframe)

Redirect

Confronto

Configurazione

Permessi richiesti per l’iframe

Repository di esempio

Esempi web SDK

Esempio iframe

Demo completa Next.js

Pacchetto NPM

Correlati

​Metodi di integrazione

​SDK JavaScript

​InContext (Iframe)

​Redirect

​Confronto

​Configurazione

​Permessi richiesti per l’iframe

​Repository di esempio

Esempi web SDK

Esempio iframe

Demo completa Next.js

Pacchetto NPM

​Correlati

Metodi di integrazione

SDK JavaScript

InContext (Iframe)

Redirect

Confronto

Configurazione

Permessi richiesti per l’iframe

Repository di esempio

Correlati