Entwicklerdokumentation | API- und Integrationsleitfaden – Überblick

Überblick

Willkommen in der Go.cam Entwicklerdokumentation.

Dieser Abschnitt bietet einen umfassenden Überblick über den Go.cam-Service, einschließlich Details zu seiner Funktionsweise sowie eine Schritt-für-Schritt-Anleitung zur Integration in Ihre Plattform.

Erste Schritte

Bevor Sie mit dem Implementierungsprozess beginnen, müssen Sie ein Go.cam-Konto erstellen. Ein aktives Konto gewährt Ihnen Zugriff als Partner und ermöglicht die Konfiguration der erforderlichen Einstellungen für die Integration. Die Aktivierung des Kontos dauert in der Regel weniger als 24 Stunden.

Verifizierungsmethoden

Go.cam bietet vier Verifizierungsmethoden, die sicherstellen sollen, dass Nutzer keine Minderjährigen sind:

• Kreditkartenvalidierung
• Altersbestimmung per Selfie
• Altersbestimmung anhand eines Ausweisdokuments
• E-Mail-Verifizierung

Endnutzer können die Verifizierung mit jeder der verfügbaren Methoden durchführen.

Verifizierungsablauf

Der Go.cam-Verifizierungsprozess kann aus zwei Perspektiven betrachtet werden: Endnutzererfahrung und Integrationslogik des Partners.

1. Ablauf für Endnutzer

Abb.: Diagramm des Verifizierungsablaufs für Nutzer

Schritte der Nutzerverifizierung (siehe Diagramm):

• 1. Der Nutzer besucht eine Partnerseite, die durch das Go.cam-Altersverifizierungssystem geschützt ist.
• 2. Der Nutzer startet die Verifizierung durch Klicken auf die Schaltfläche „Alter verifizieren“.
• 3. Je nach Integration des Partners wird der Nutzer:
• Zu einer von Go.cam gehosteten Verifizierungsseite weitergeleitet, oder
• Mit einem iframe-Overlay interagieren, das den Go.cam-Verifizierungsablauf lädt.
• 4. Der Nutzer wählt eine der verfügbaren Verifizierungsmethoden:
• Kreditkartenvalidierung
• Altersbestimmung per Selfie
• Altersbestimmung anhand eines Ausweisdokuments
• E-Mail-Verifizierung
• 5. Der Nutzer gibt die erforderlichen Informationen ein (z. B. Kreditkartendaten, Webcam-Zugriff, Ausweisbild oder E-Mail-Adresse).
• 6. Nach Abschluss zeigt Go.cam das Ergebnis an:
• Erfolgsseite: enthält eine Schaltfläche zur Rückkehr zur Partnerseite.
• Fehlerseite: enthält eine „Erneut versuchen“-Option und einen QR-Code, um die Verifizierung auf einem mobilen Gerät fortzusetzen. Bei Erfolg wird die ursprüngliche Sitzung validiert.
• 7. Nach erfolgreicher Verifizierung wird der Nutzer zur konfigurierten Rückleitungs-URL weitergeleitet und erhält Zugriff auf die Partnerseite.

2. Partnerintegration mit Weiterleitungslogik

Abb.: Diagramm der Weiterleitungslogik

Weiterleitungsablauf (siehe Diagramm):

• 1. Der Nutzer greift auf die Partnerseite zu und startet die Altersverifizierung.
• 2. Der Partner generiert eine Go.cam-Verifizierungs-URL mithilfe des SDK und übermittelt:
• Cipher key und HMAC key
• Nutzermetadaten (z. B. userId)
• 3. Der Nutzer wird zu Go.cam weitergeleitet, um den Verifizierungsprozess abzuschließen.
• 4. Der Nutzer wählt eine Verifizierungsmethode und führt sie aus.
• 5. Go.cam zeigt eine Erfolgs- oder Fehlerseite an.
• 6. Die Ergebnisse werden wie folgt verarbeitet:
• Die Verifizierungsergebnisse werden bei Go.cam gespeichert.
• Go.cam sendet die Ergebnisse an die konfigurierte Callback-URL zusammen mit den bereitgestellten Nutzerdaten (z. B. userId).
• Ein Cookie wird bei Go.cam erstellt, das eine verschlüsselte Version der Verifizierungsdaten enthält und später mit den Schlüsseln des Partners entschlüsselt werden kann.
• 7. Bei Erfolg wird der Nutzer zur Rückleitungs-URL weitergeleitet und erhält Zugriff auf die Partnerseite.

3. Partnerintegration mit iframe-Logik

Abb.: Diagramm der iframe-Logik

iframe-Ablauf (siehe Diagramm):

• 1. Der Nutzer greift auf die Partnerseite zu und startet die Altersverifizierung.
• 2. Der Partner generiert eine Go.cam-Verifizierungs-URL mithilfe des SDK und übermittelt:
• Cipher key und HMAC key
• Nutzermetadaten (z. B. userId)
• 3. Mithilfe des Frontend-SDK aktiviert der Partner das iframe-Overlay, um die Go.cam-Verifizierungsinstanz zu laden.
• 4. Sobald das iframe geladen ist:
• Bestätigt ein Ereignis die Initialisierung.
• Falls bereits ein Go.cam-Verifizierungs-Cookie existiert, informiert ein separates Ereignis den Partner (die Integrität des Cookies muss überprüft werden).
• 5. Der Nutzer wählt eine Verifizierungsmethode und schließt sie ab.
• 6. Go.cam zeigt eine Erfolgs- oder Fehlerseite an:
• Erfolgsseite: schließt das iframe-Overlay.
• Fehlerseite: ermöglicht einen erneuten Versuch.
• 7. Die Ergebnisse werden wie folgt verarbeitet:
• Die Verifizierungsergebnisse werden bei Go.cam gespeichert.
• Go.cam sendet die Ergebnisse an die konfigurierte Callback-URL zusammen mit den bereitgestellten Nutzerdaten (z. B. userId).
• Ein Cookie wird bei Go.cam erstellt, das verschlüsselte Verifizierungsdaten enthält und mit den Schlüsseln des Partners entschlüsselt werden kann.
• Ein JavaScript-Ereignis signalisiert den erfolgreichen Abschluss der Verifizierung und ermöglicht es dem Partner, das gespeicherte Cookie zu validieren.
• 8. Bei Erfolg wird das iframe entfernt und der Zugriff auf die Partnerseite freigeschaltet.

---

Terminologie

• Partner: Sie, der Integrator, der Go.cam auf Ihrer Plattform implementiert.
• Cipher key / HMAC key: Schlüssel, die in Ihrem Go.cam-Konto verfügbar sind und zur Verschlüsselung sowie Validierung der Verifizierungsdaten verwendet werden.
• Verification result callback URL: Endpoint, der in Ihrem Go.cam-Konto definiert ist und an den die Verifizierungsergebnisse gesendet werden.
• Link back URL: URL, die über das Go.cam-SDK definiert wird, um Nutzer nach erfolgreicher Verifizierung weiterzuleiten.

---

Verifizierungstypen

Go.cam bietet mehrere Verifizierungsmethoden, um sicherzustellen, dass Nutzer die Altersanforderungen erfüllen. Jede Methode wurde unter Berücksichtigung von Datenschutz, Sicherheit und Compliance entwickelt.

1. Kreditkartenverifizierung

• Der Nutzer wird vorübergehend in eine sichere Umgebung weitergeleitet, in der er seine Kreditkartennummer und das Ablaufdatum eingibt.
• Es werden keine Gebühren erhoben. Es werden lediglich die Gültigkeit und die Integrität der Karte überprüft.
• Dies ist die einzige Verifizierungsmethode, die Daten an das Backend sendet. Die Verarbeitung erfolgt in einer PCI-DSS-konformen Umgebung.
• Go.cam speichert oder übermittelt keine Kartendaten an Dritte.

2. Altersverifizierung per Selfie

• Erfordert Zugriff auf die Webcam, um das Gesicht des Nutzers in Echtzeit zu erfassen.
• Ein Machine-Learning-Modell wird lokal auf dem Gerät ausgeführt; es werden keine Bilder hochgeladen oder gespeichert.
• Der Ablauf:
• 1. Der Nutzer richtet sein Gesicht in der Mitte des Bildschirms aus.
• 2. Es werden mehrere Aufnahmen gemacht. Ausreißer werden verworfen und ein durchschnittlich geschätztes Alter berechnet.
• 3. Gesichtskonsistenzprüfungen stellen sicher, dass dieselbe Person vor der Kamera bleibt.
• 4. Eine Liveness-Prüfung ist ebenfalls vorhanden und fordert den Nutzer zu bestimmten Aktionen auf.
• Wird der Nutzer als minderjährig erkannt, wechselt der Prozess automatisch zur Dokumentenverifizierung:
• Gesichtsaufnahmen werden mit dem Dokumentenfoto verglichen.
• Bei erfolgreicher Übereinstimmung wird das Geburtsdatum extrahiert, um das Alter zu bestätigen.
• Wird der Nutzer als volljährig verifiziert, ist der Prozess erfolgreich abgeschlossen. Andernfalls kann er innerhalb eines 10-Minuten-Sitzungsfensters erneut versuchen.

Zertifizierung

• Go.cam ist Challenge 25 zertifiziert: Personen über 18, die jünger als 25 erscheinen, können zur Vorlage eines Ausweises aufgefordert werden.
• Zertifiziert von:
• 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
• Die Altersverifizierung basiert auf einem Open-Source-Gesichtserkennungsmodell. [Mehr erfahren].

3. Dokumentenverifizierung

• Der Nutzer wählt ein Land und einen Dokumenttyp (Personalausweis, Reisepass oder Führerschein).
• Unterstützte Regionen: alle europäischen Länder und die Vereinigten Staaten.
• Die Verifizierung kann durchgeführt werden mittels:
• Eines Webcam-Fotos, oder
• Eines lokal hochgeladenen Bildes.
• Bilder werden lokal auf dem Gerät verarbeitet; es werden keine Daten an Go.cam-Server gesendet.
• Wurde zuvor keine Selfie-Verifizierung durchgeführt, wird nur das Geburtsdatum extrahiert. Das aktuelle Alter wird berechnet und mit der gesetzlichen Volljährigkeit des Landes abgeglichen.
• Die Texterkennung erfolgt über ein Open-Source-OCR-Modell. [Mehr erfahren].

4. E-Mail-Verifizierung

• Überprüft das Alter des Nutzers anhand historischer E-Mail-Aktivität.
• Das System prüft, ob die angegebene E-Mail-Adresse in einem Datenleck vor mindestens 13 Jahren aufgetaucht ist.
• Annahme: Wenn die E-Mail vor 13 Jahren existierte, muss der Nutzer mindestens 20 Jahre alt sein (Mindestalter von 7 Jahren zur Erstellung einer E-Mail + 13 Jahre).
• Zur Bestätigung des Besitzes wird ein Bestätigungscode an die angegebene Adresse gesendet, den der Nutzer im Verifizierungsfenster eingeben muss.