FaceGuard

Surt FaceGuard ermöglicht es Ihnen, Gesichtsverifikation für sicheres Einloggen in Ihre Web- oder Mobilanwendung zu integrieren. Nutzer schließen einen schnellen Gesichtsscan ab, der mit ihrem gespeicherten Basisfoto verglichen wird – alles innerhalb Ihrer App.

1

Zugangsdaten holen

API-Schlüssel + Workflow-ID aus Ihrem Dashboard

2

Token generieren

Serverseitiger Aufruf zum Erstellen eines Portal-Tokens

3

FaceGuard einbetten

SDK, iframe oder WebView in Ihrem Frontend

So funktioniert es

1. Ihr Backend fordert einen Portal-Token von der Surt-API an
2. Ihr Frontend öffnet FaceGuard (SDK, iframe oder WebView) mit diesem Token
3. Ihr Nutzer schließt den Gesichtsscan ab (automatische Aufnahme bei Gesichtserkennung)
4. Surt sendet das Ergebnis per postMessage-Events

Integrationsmethoden

Methode	Plattform	Am besten für
NPM-Paket	Web (React, Vue, etc.)	Schnellste Integration, erkennt automatisch Mobil-/Desktop-Gerät
iFrame	Web	Volle Kontrolle über Größe und Layout
React Native	iOS, Android via RN	Mobile Apps mit React Native
Natives iOS	iOS (Swift)	Native iOS-Apps
Natives Android	Android (Kotlin)	Native Android-Apps

Geräteverhalten

FaceGuard passt sich automatisch an das Gerät an:

• Mobil / Tablet: Öffnet direkt den Kamera-Flow für den Gesichtsscan
• Desktop: Zeigt einen QR-Code für die Übergabe ans Smartphone, mit "Hier verifizieren"-Fallback für Webcam

Kommunikation

Alle Integrationsmethoden verwenden postMessage für die Echtzeitkommunikation. Events umfassen:

• surt:ready: FaceGuard ist geladen und bereit
• close mit Grund: approved, rejected, canceled, bypass_active, no_base_photo oder error

Schnellzugriff

• Schnellstart: In 5 Minuten einsatzbereit
• Authentifizierung: API-Zugangsdaten holen
• NPM-Paket: Empfohlene Web-Integration
• API-Referenz: Backend-Endpunkte
• Fehlercodes: Statuscodes und Close-Gründe