Gesichtssuche & Sperrliste: Benutzerbiometrie

​

Wie Gesichter einem Benutzer zugeordnet werden

​

Gesichtssuche (1:N)

• Duplikaterkennung beim Onboarding: verhindern, dass dieselbe Person zwei Konten anlegt.
• Umgekehrte Suche: den Benutzer hinter einem CCTV-Standbild oder einem Bild in einer Betrugsuntersuchung identifizieren.
• Wiedererkennung von Bestandskunden: KYC für einen wiederkehrenden Kunden überspringen.

• POST /v3/face-search/: eigenständige Gesichtssuche

​

Duplikaterkennung

• Sitzungen mit Duplikat-Kennzeichnung automatisch ablehnen.
• zur Prüfung markieren: an einen menschlichen Analysten weiterleiten.
• nur warnen: die Sitzung zulassen, aber ein Risiko-Tag hinzufügen.

​

Sperrliste für Gesichter

​

Ein importiertes Gesicht einem Benutzerprofil hinzufügen

# 1. Create or retrieve the User keyed by your vendor_data
curl -X POST https://verification.didit.me/v3/users/create/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vendor_data": "user-42",
    "display_name": "Jane Doe",
    "metadata": { "previous_provider": "legacy-kyc-vendor" }
  }'

# Response includes:
# { "didit_internal_id": "11111111-2222-3333-4444-555555555555", ... }

# 2. Upload the imported face to the User profile
curl -X POST https://verification.didit.me/v3/organization/$ORGANIZATION_ID/application/$APPLICATION_ID/vendor-users/by-id/11111111-2222-3333-4444-555555555555/faces/upload/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "<base64-encoded-jpg-or-png>",
    "comment": "Imported from previous KYC provider"
  }'

​

So erfolgt die Sperrung

​

Ein Gesicht in die Sperrliste hochladen

​

Ein Gesicht aus der Sperrliste entfernen

​

Aufbewahrte biometrische Templates nach dem Löschen einer Sitzung

• Es enthält nur das numerische Gesichts-Template und Aufbewahrungsmetadaten. Es enthält niemals das Gesichtsbild, das Liveness-Video, Dokumentdaten, extrahierte Identitätsfelder, die Entscheidung oder die ID der gelöschten Sitzung.
• Es nimmt an der Duplikatserkennung, der Gesichtssuche, der biometrischen Authentifizierung und Ihren Gesichtslisten genauso teil wie das Gesicht einer aktiven Sitzung. Treffer werden mit source: "retained_template", dem vendor_user_id und vendor_data des Benutzers sowie einer biometric_template_id gemeldet.
• Es handelt sich um biometrische Daten mit einem endlichen expires_at. Das Template wird entfernt, wenn der Benutzer gelöscht wird, wenn eine Sitzung dieses Benutzers mit deletion_instruction: "privacy_erasure" gelöscht wird, wenn es abläuft oder wenn Sie es unter Lists → Biometric templates oder über die Biometric Templates API entfernen.
• Eine Sitzung, die ohne vendor_data erstellt wurde, hat keinen Benutzer, mit dem ein Template verknüpft werden könnte. Beim Löschen wird ineligible_no_vendor_user gemeldet, und das Embedding wird zusammen mit der Sitzung gelöscht.
• Aufbewahrte Templates werden niemals auf die Sperrliste gesetzt. Ein Eintrag in der Gesichts-Sperrliste, der aus der gelöschten Sitzung erstellt wurde, behält seinen eigenen, unabhängigen biometrischen Eintrag und Lebenszyklus.

​

Zusammenfassung des Gesichts-Lebenszyklus

​

Ein Gesicht über die Konsole hochladen

1. Navigieren Sie zu Users → [user] → Actions → Upload face.
2. Wählen Sie ein Bild aus; Didit extrahiert das größte Gesicht und speichert einen neuen Gesichtseintrag, der mit dem Benutzer verknüpft ist.
3. Das Gesicht wird für Profilnachweise, Duplikatserkennung und Gesichtssuche registriert. Verwenden Sie den Bereich Sperrliste, wenn künftige passende Sitzungen abgelehnt werden sollen.

• Sie ein bekanntes Porträt eines Kunden haben, das über einen Offline-Kanal verifiziert wurde.
• Sie eine Sperrliste mit bekannten Betrügern aus Ihrer Betrugsdatenbank vorbefüllen möchten.

​

Datenschutz und Aufbewahrung

• Gesichts-Embeddings sind numerische Vektoren, keine Bilder. Die Bilder selbst werden in verschlüsseltem Objektspeicher mit Zugriff über signierte URLs gespeichert. Ein Gesichts-Embedding stellt biometrische Daten dar.
• Die Aufbewahrung richtet sich nach der Datenaufbewahrung Ihrer Anwendung. Aufbewahrte biometrische Templates folgen dem strengeren, endlichen Aufbewahrungszeitraum der Aufbewahrung biometrischer Templates.
• Beim Löschen einer Sitzung werden das Bild und standardmäßig das Embedding gelöscht. Wenn Ihre Anwendung die Aufbewahrung biometrischer Templates aktiviert hat, bleibt beim Löschen einer Sitzung ein bildfreies Template erhalten, bis es abläuft oder entfernt wird.
• Bei einer Anfrage gemäß GDPR/CCPA zum Recht auf Vergessenwerden löschen Sie die Sitzungen der Person mit deletion_instruction: "privacy_erasure" oder löschen Sie den Benutzer. Beides entfernt auch alle aufbewahrten Templates. Von Ihnen verwaltete Einträge in der Gesichts-Sperrliste bleiben bestehen, bis Sie sie entfernen.

​

Nächste Schritte