Documentazione sviluppatore | API e Guida all'Integrazione - Panoramica

Panoramica

Benvenuto nella documentazione per sviluppatori di Go.cam.

Questa sezione fornisce una panoramica completa del servizio Go.cam, inclusi i dettagli su come funziona e una guida passo dopo passo per integrarlo nella tua piattaforma.

Per iniziare

Prima di iniziare il processo di implementazione, dovrai creare un account Go.cam. Un account attivo ti concede l'accesso come partner e ti consente di configurare le impostazioni necessarie per l'integrazione. L'attivazione dell'account richiede generalmente meno di 24 ore.

Metodi di verifica

Go.cam fornisce quattro metodi di verifica progettati per garantire che gli utenti non siano minorenni:

• Validazione tramite carta di credito
• Rilevamento dell'età tramite selfie
• Estrazione dell'età da documento di identità
• Verifica tramite email

Gli utenti finali possono completare la verifica utilizzando uno qualsiasi dei metodi disponibili.

Flusso di verifica

Il processo di verifica Go.cam può essere visto da due prospettive: esperienza dell'utente finale e logica di integrazione del partner.

1. Flusso dell'utente finale

Fig: Diagramma del flusso di verifica dell'utente

Fasi della verifica dell'utente (vedi diagramma):

• 1. L'utente visita un sito partner protetto dal sistema di verifica dell'età Go.cam.
• 2. L'utente avvia la verifica cliccando sul pulsante "Verifica età".
• 3. A seconda dell'integrazione del partner, l'utente:
• Viene reindirizzato a una pagina di verifica ospitata da Go.cam, oppure
• Interagisce con un iframe che carica il flusso di verifica Go.cam.
• 4. L'utente seleziona uno dei metodi di verifica disponibili:
• Validazione tramite carta di credito
• Rilevamento dell'età tramite selfie
• Estrazione dell'età da documento di identità
• Verifica tramite email
• 5. L'utente fornisce le informazioni richieste (ad esempio dati della carta, accesso alla webcam, immagine del documento o indirizzo email).
• 6. Una volta completato, Go.cam mostra il risultato:
• Pagina di successo: include un pulsante per tornare al sito partner.
• Pagina di errore: include un'opzione "Riprova" e un codice QR per continuare la verifica su un dispositivo mobile. Se ha successo, la sessione originale verrà convalidata.
• 7. Dopo una verifica riuscita, l'utente viene reindirizzato al link di ritorno configurato, sbloccando il sito partner.

2. Integrazione del partner con logica di reindirizzamento

Fig: Diagramma della logica di reindirizzamento

Flusso di reindirizzamento (vedi diagramma):

• 1. L'utente accede al sito partner e avvia la verifica dell'età.
• 2. Il partner genera un URL di verifica Go.cam utilizzando l'SDK, fornendo:
• Cipher key e HMAC key
• Metadati utente (ad esempio userId)
• 3. L'utente viene reindirizzato a Go.cam per completare il processo di verifica.
• 4. L'utente seleziona e completa uno dei metodi di verifica.
• 5. Go.cam mostra una pagina di successo o errore.
• 6. I risultati vengono elaborati come segue:
• I risultati della verifica vengono memorizzati su Go.cam.
• Go.cam invia i risultati all'URL di callback configurato, insieme ai dati utente forniti (ad esempio userId).
• Viene creato un cookie su Go.cam contenente una versione cifrata dei dati di verifica, che può essere successivamente decifrata utilizzando le chiavi del partner.
• 7. In caso di successo, l'utente viene reindirizzato al link di ritorno, sbloccando il sito partner.

3. Integrazione del partner con logica iframe

Fig: Diagramma della logica iframe

Flusso iframe (vedi diagramma):

• 1. L'utente accede al sito partner e avvia la verifica dell'età.
• 2. Il partner genera un URL di verifica Go.cam utilizzando l'SDK, fornendo:
• Cipher key e HMAC key
• Metadati utente (ad esempio userId)
• 3. Utilizzando l'SDK frontend, il partner attiva l'overlay iframe per caricare l'istanza di verifica Go.cam.
• 4. Una volta caricato l'iframe:
• Un evento conferma l'inizializzazione.
• Se esiste già un cookie di verifica Go.cam, un evento separato notifica il partner (l'integrità del cookie deve essere verificata).
• 5. L'utente seleziona e completa uno dei metodi di verifica.
• 6. Go.cam mostra una pagina di successo o errore:
• Pagina di successo: chiude l'iframe.
• Pagina di errore: consente di riprovare.
• 7. I risultati vengono elaborati come segue:
• I risultati della verifica vengono memorizzati su Go.cam.
• Go.cam invia i risultati all'URL di callback configurato, insieme ai dati utente forniti (ad esempio userId).
• Viene creato un cookie su Go.cam contenente dati di verifica cifrati, decifrabili tramite le chiavi del partner.
• Un evento JavaScript segnala il successo della verifica, consentendo al partner di validare il cookie memorizzato.
• 8. In caso di successo, l'iframe viene rimosso, sbloccando il sito partner.

---

Terminologia

• Partner: Tu, l'integratore che implementa Go.cam sulla tua piattaforma.
• Cipher key / HMAC key: Chiavi disponibili nel tuo account Go.cam, utilizzate per cifrare e validare i dati di verifica.
• Verification result callback URL: Endpoint definito nel tuo account Go.cam dove vengono inviati i risultati della verifica.
• Link back URL: URL definito tramite l'SDK Go.cam per reindirizzare gli utenti dopo una verifica riuscita.

---

Tipi di verifica

Go.cam fornisce diversi metodi di verifica per garantire che gli utenti soddisfino i requisiti di età. Ogni metodo è progettato tenendo conto di privacy, sicurezza e conformità.

1. Verifica tramite carta di credito

• L'utente viene temporaneamente reindirizzato a un ambiente sicuro, dove gli viene richiesto di inserire il numero della carta di credito e la data di scadenza.
• Non viene effettuato alcun addebito. Vengono verificate solo la validità e l'integrità della carta.
• Questo è l'unico metodo che invia dati al backend. L'elaborazione avviene in un ambiente conforme PCI DSS.
• Go.cam non memorizza né trasmette i dati della carta a terze parti.

2. Verifica dell'età tramite selfie

• Richiede accesso alla webcam per catturare il volto dell'utente in tempo reale.
• Un modello di machine learning viene eseguito localmente sul dispositivo; nessuna immagine viene caricata o memorizzata.
• Il processo:
• 1. L'utente allinea il volto al centro dello schermo.
• 2. Vengono scattate più foto. I valori anomali vengono scartati e viene calcolata un'età media stimata.
• 3. I controlli di coerenza facciale garantiscono che la stessa persona rimanga davanti alla fotocamera.
• 4. È presente anche una misura di liveness, che richiede all'utente di eseguire azioni specifiche.
• Se l'utente viene rilevato come minorenne, il processo passa automaticamente alla verifica tramite documento:
• Le immagini del volto vengono confrontate con la foto del documento.
• Se la corrispondenza ha successo, viene estratta la data di nascita per confermare l'età.
• Se l'utente è verificato come adulto, il processo si conclude con successo. In caso contrario, può riprovare entro una finestra di sessione di 10 minuti prima della scadenza.

Certificazione

• Go.cam è certificata Challenge 25: gli individui sopra i 18 anni che sembrano più giovani di 25 potrebbero dover fornire un documento.
• Certificata da:
• Association of Sites Advocating Child Protection
• The leading global provider of high-performance web hosting solutions in Cloud, VPS, and Dedicated hosting infrastructures.
• Central Authority for the Supervision and Protection of Minors on the Internet in Germany
• Age Check Certification Scheme
• La verifica dell'età è basata su un modello open-source di riconoscimento facciale. [Scopri di più qui].

3. Verifica tramite documento di identità

• L'utente seleziona un paese e il tipo di documento (carta d'identità, passaporto o patente).
• Regioni supportate: tutti i paesi europei e gli Stati Uniti.
• La verifica può essere completata utilizzando:
• Una foto tramite webcam, oppure
• Un'immagine caricata localmente.
• Le immagini vengono elaborate localmente sul dispositivo; nulla viene caricato sui server Go.cam.
• Se non è stata effettuata una verifica tramite selfie in precedenza, viene estratta solo la data di nascita. L'età attuale viene quindi calcolata e confrontata con la maggiore età legale del paese.
• L'estrazione del testo del documento utilizza un modello OCR open-source. [Scopri di più qui].

4. Verifica tramite email

• Verifica l'età dell'utente basandosi sull'attività storica dell'email.
• Il sistema controlla se l'indirizzo email fornito è apparso in una violazione di dati almeno 13 anni fa.
• Ipotesi: se l'email esisteva 13 anni fa, l'utente deve avere almeno 20 anni (età minima di 7 anni per creare l'email + 13 anni).
• Per confermare la proprietà, viene inviato un codice di verifica all'indirizzo fornito, che l'utente deve inserire nella finestra di verifica.