Bescherm minderjarigen, zorg voor wettelijke naleving en laat uw bedrijf veilig groeien
Ontwikkelaarsdocumentatie | API & Integratiegids - Overzicht
Overzicht
Welkom bij de Go.cam ontwikkelaarsdocumentatie.
Deze sectie biedt een uitgebreide handleiding voor de Go.cam-service, inclusief details over de werking ervan en stapsgewijze begeleiding voor de integratie in uw platform.
Aan de slag
Voordat u met het implementatieproces begint, moet u een Go.cam-account aanmaken. Een actief account geeft u toegang als partner en stelt u in staat de vereiste instellingen voor integratie te configureren. Accountactivering duurt doorgaans minder dan 24 uur.
Verificatiemethoden
Go.cam biedt vier verificatiemethoden die zijn ontworpen om ervoor te zorgen dat gebruikers geen minderjarigen zijn:
- Creditcardvalidatie
- Leeftijdsdetectie via selfie
- Leeftijdsextractie uit ID-document
- E-mailverificatie
- NFC ID-document
Eindgebruikers kunnen de verificatie voltooien met behulp van een van de beschikbare methoden.
Verificatiestroom
Het Go.cam verificatieproces kan vanuit twee perspectieven worden bekeken: eindgebruikerservaring en partnerintegratielogica.
1. Eindgebruikersstroom
Afb: Gebruikersverificatiestroomdiagram
Stappen voor gebruikersverificatie (zie Gebruikersverificatiestroomdiagram):
- 1. De gebruiker bezoekt een partnersite die wordt beschermd door het Go.cam leeftijdsverificatiesysteem.
- 2. De gebruiker start de verificatie door op de knop "Leeftijd verifiëren" te klikken.
- 3. Afhankelijk van de integratie van de partner zal de gebruiker ofwel:
- Worden omgeleid naar een door Go.cam gehoste verificatiepagina, of
- Interactie hebben met een iframe-overlay die de Go.cam verificatiestroom laadt.
- 4. De gebruiker selecteert een van de beschikbare verificatiemethoden:
- Creditcardvalidatie
- Leeftijdsdetectie via selfie
- Leeftijdsextractie uit ID-document
- E-mailverificatie
- NFC ID-document
- 5. De gebruiker verstrekt de vereiste informatie (bijv. creditcardgegevens, webcamtoegang, ID-afbeelding of een e-mailadres).
- 6. Na voltooiing toont Go.cam het resultaat:
- Succespagina: bevat een knop om terug te keren naar de partnersite.
- Foutpagina: bevat een "Opnieuw proberen"-optie en een QR-code om de verificatie op een mobiel apparaat voort te zetten. Indien succesvol, wordt de oorspronkelijke apparaatsessie gevalideerd.
- 7. Na een succesvolle verificatie wordt de gebruiker omgeleid naar de geconfigureerde teruglink-URL, waardoor de partnersite wordt ontgrendeld.
2. Partnerintegratie met omleidingslogica
Omleidingsstroom (zie Omleidingslogica Diagram):
- 1. De gebruiker bezoekt de partnersite en start de leeftijdsverificatie.
- 2. De partner genereert een Go.cam verificatie-URL met behulp van de SDK, en verstrekt:
- Cipher sleutel en HMAC sleutel
- Gebruikersmetadata (bijv. userId)
- 3. De gebruiker wordt omgeleid naar Go.cam om het verificatieproces te voltooien.
- 4. De gebruiker selecteert en voltooit een van de verificatiemethoden.
- 5. Go.cam toont een succes- of foutpagina.
- 6. Resultaten worden als volgt verwerkt:
- Verificatie-uitkomsten worden opgeslagen in Go.cam.
- Go.cam stuurt resultaten naar de geconfigureerde verificatieresultaat callback URL, samen met de verstrekte gebruikersgegevens (bijv. userId).
- Een cookie wordt aangemaakt op Go.cam met een versleutelde versie van de verificatiegegevens, die later kan worden ontsleuteld met behulp van de sleutels van de partner.
- 7. Bij succes wordt de gebruiker omgeleid naar de teruglink-URL, waardoor de partnersite wordt ontgrendeld.
3. Partnerintegratie met Iframe-logica
Iframe-stroom (zie Iframe Logica Diagram):
- 1. De gebruiker bezoekt de partnersite en start de leeftijdsverificatie.
- 2. De partner genereert een Go.cam verificatie-URL met behulp van de SDK, en verstrekt:
- Cipher sleutel en HMAC sleutel
- Gebruikersmetadata (bijv. userId)
- 3. Met behulp van de frontend SDK activeert de partner de iframe-overlay om de Go.cam verificatie-instantie te laden.
- 4. Zodra de iframe laadt:
- Een gebeurtenis bevestigt de initialisatie.
- Als er al een Go.cam verificatie-cookie bestaat, informeert een aparte gebeurtenis de partner (cookie-integriteit moet worden gevalideerd).
- 5. De gebruiker selecteert en voltooit een van de verificatiemethoden.
- 6. Go.cam toont een succes- of foutpagina:
- Succespagina: sluit de iframe-overlay.
- Foutpagina: maakt opnieuw proberen mogelijk.
- 7. Resultaten worden als volgt verwerkt:
- Verificatie-uitkomsten worden opgeslagen in Go.cam.
- Go.cam stuurt resultaten naar de geconfigureerde verificatieresultaat callback URL, samen met de verstrekte gebruikersgegevens (bijv. userId).
- Een cookie wordt aangemaakt op Go.cam met versleutelde verificatiegegevens, ontsleutelbaar via de sleutels van de partner.
- Een JavaScript-gebeurtenis kondigt verificatiesucces aan, waardoor de partner de opgeslagen cookie kan valideren.
- 8. Bij succes wordt de iframe-overlay verwijderd, waardoor de partnersite wordt ontgrendeld.
Terminologie
- Partner: U, de integrator die Go.cam op uw platform implementeert.
- Cipher sleutel / HMAC sleutel: Sleutels beschikbaar in uw Go.cam-account, gebruikt om verificatiegegevens te versleutelen en te valideren.
- Verificatieresultaat callback URL: Eindpunt gedefinieerd in uw Go.cam-account waar verificatieresultaten worden gepost.
- Teruglink-URL: URL gedefinieerd via de Go.cam SDK voor het omleiden van gebruikers na een succesvolle verificatie.
Verificatietypen
Go.cam biedt meerdere verificatiemethoden om ervoor te zorgen dat gebruikers aan de leeftijdsvereisten voldoen. Elke methode is ontworpen met privacy, veiligheid en compliance in gedachten.
1. Creditcardverificatie
- De gebruiker wordt tijdelijk omgeleid naar een beveiligde omgeving, waar hij wordt gevraagd zijn creditcardnummer en vervaldatum in te voeren.
- Er worden geen kosten in rekening gebracht. Alleen de geldigheid en integriteit van de kaart worden gecontroleerd.
- Dit is de enige verificatiemethode die gegevens naar de backend stuurt. De verwerking vindt plaats in een PCI DSS-compatibele omgeving.
- Go.cam slaat geen kaartgegevens op en stuurt deze niet door naar derden.
2. Leeftijdsverificatie via selfie
- Vereist webcamtoegang om het gezicht van de gebruiker in realtime vast te leggen.
- Een machine learning-model draait lokaal op het apparaat; er worden geen afbeeldingen geüpload of opgeslagen.
- Het proces:
- 1. De gebruiker centreert zijn gezicht in het midden van het scherm.
- 2. Er worden meerdere opnamen gemaakt. Uitschieters worden verwijderd en een gemiddelde voorspelde leeftijd wordt berekend.
- 3. Gezichtsconsistentiecontroles zorgen ervoor dat dezelfde persoon voor de camera blijft.
- 4. Een levendigheidsmeting is ook aanwezig, waarbij de gebruiker wordt gevraagd specifieke acties uit te voeren, afhankelijk van zijn huidige positie.
- Als de gebruiker als minderjarige wordt gedetecteerd, schakelt het proces automatisch over naar ID-documentverificatie:
- Gezichtsopnamen worden vergeleken met de documentfoto.
- Als de overeenkomst succesvol is, wordt de geboortedatum uit het document gehaald om de leeftijd te bevestigen.
- Als de gebruiker als volwassene is geverifieerd, wordt het proces succesvol voltooid. Anders kan de gebruiker binnen een sessievenster van 10 minuten opnieuw proberen voordat de sessie verloopt.
Certificering
- Go.cam is Challenge 25 gecertificeerd: personen ouder dan 18 die jonger lijken dan 25, kunnen worden gevraagd een identiteitsbewijs te tonen.
- Gecertificeerd door:
- Vereniging van Sites die Kinderbescherming Behartigen
- De toonaangevende wereldwijde provider van hoogwaardige webhostingoplossingen in Cloud-, VPS- en Dedicated hostinginfrastructuren.
- Centrale Autoriteit voor Toezicht en Bescherming van Minderjarigen op het Internet in Duitsland
- Leeftijdscontrole Certificeringsschema
- Leeftijdsverificatie wordt aangedreven door een open-source gezichtsherkenningsmodel. [Lees hier meer].
3. ID-documentverificatie
- De gebruiker selecteert een land en documenttype (ID-kaart, paspoort of rijbewijs).
- Ondersteunde regio's: alle Europese landen en de Verenigde Staten.
- Verificatie kan worden voltooid met behulp van:
- Een webcamfoto, of
- Een lokaal geüploade afbeelding.
- Afbeeldingen worden lokaal op het apparaat verwerkt; er wordt niets geüpload naar Go.cam-servers.
- Als er vooraf geen selfie-verificatie is uitgevoerd, wordt alleen de geboortedatum geëxtraheerd. De huidige leeftijd wordt vervolgens berekend en gecontroleerd tegen de wettelijke meerderjarigheid van het land.
- Documenttekstextractie maakt gebruik van een open-source OCR-model. [Lees hier meer].
4. E-mailverificatie
- Verifieert de leeftijd van de gebruiker op basis van historische e-mailactiviteit.
- Het systeem controleert of het opgegeven e-mailadres minimaal 13 jaar geleden in een datalek is verschenen.
- Aanname: als het e-mailadres 13 jaar geleden bestond, moet de gebruiker minimaal 20 jaar oud zijn (minimale leeftijd van 7 om het e-mailadres aan te maken + 13 jaar).
- Om eigendom te bevestigen, wordt een validatiecode naar het opgegeven adres gestuurd, die de gebruiker in het verificatievenster moet invoeren.
5. NFC ID-document
- Vereist een mobiel apparaat (iOS of Android) met NFC-functionaliteit om de biometrische chip in een e-paspoort of nationale eID-kaart te lezen, samen met cameratoegang om de Machine Readable Zone (MRZ) van het document te scannen.
- Alle documentgegevens, chipportretten en gezichtsvergelijkingen worden lokaal op het apparaat in vluchtig geheugen verwerkt; er worden geen ID-gegevens, foto's of biometrische gegevens geüpload of opgeslagen.
Het proces:
- De gebruiker opent de mobiele verificatiestroom (via QR-code, deep link of App Clip), die veilig de sessiereferentie en de live selfie-gezichtsdescriptor draagt.
- De gebruiker scant de MRZ van het document met de camera om de chip-toegangssleutel af te leiden.
- De gebruiker houdt het document tegen de NFC-antenne van het apparaat. De app authenticeert met de chip via BAC/PACE en leest de persoonlijke gegevens (DG1) en portretfoto (DG2).
- De geboortedatum en het land van uitgifte, geëxtraheerd uit de chip, worden lokaal gecontroleerd tegen de toepasselijke meerderjarigheidsleeftijd (standaard 18+, of landspecifieke drempels).
- Een lokaal machine learning-model vergelijkt de portretfoto van de chip met de live selfie-descriptor van de gebruiker om te bevestigen dat het document van de gebruiker is.
Eenvoudig, veilig en zonder opstartkosten
Bescherm minderjarigen, zorg voor wettelijke naleving en laat uw bedrijf veilig groeien