Zum Hauptinhalt springen
Blocklists verhindern, dass Benutzer, die Ihre Compliance-Prüfungen nicht bestanden haben, neue Sitzungen erstellen oder neue Transaktionen ausführen. Didit unterstützt Sperrlisten nach Kennungstyp, sodass Sie denselben problematischen Akteur über mehrere Datenpunkte hinweg sperren können (Gesicht, Dokument, E-Mail, Telefon, Benutzer vendor_data).

​
Unterstützte Kennungstypen für Benutzer

Jeder Kennungstyp wird an der jeweils passenden Stelle durchgesetzt:
  • Gesicht und Dokument: Durchsetzung während einer neuen Sitzung.
  • E-Mail und Telefon: Durchsetzung während eines Sitzungsschritts, der sie erfasst, oder in einem Transaktions-Payload.
  • IP und Gerät: Durchsetzung während der Geräte- und IP-Analyse in einer Sitzung.
  • Benutzer vendor_data: Durchsetzung bei der Erstellung einer Sitzung oder Transaktion.

​
So funktioniert das Sperren

Eine abgelehnte Sitzung sperrt niemanden. Die Sitzung endet mit Declined, der Benutzer bleibt ACTIVE und es wird kein Listeneintrag angelegt, sodass dieselbe Person eine weitere Sitzung starten kann. Das Sperren ist ein manueller Schritt: Fügen Sie den Eintrag über die Sperrlisten-Seite oder mit der Lists API hinzu. Ein USER-Eintrag (das vendor_data des Benutzers) setzt außerdem den Status des Benutzers auf BLOCKED.
1

Automatisch: bei Treffer auf der Sperrliste

Passt eine eingehende Sitzung zu einem bestehenden Sperrlisteneintrag, wird die Sitzung automatisch mit einem Ursachencode wie blocked_face, blocked_document, blocked_email usw. abgelehnt.
2

Manuell: aus der Konsole

Ein Analyst sperrt einen Benutzer unter Users → [user] → Actions → Add to blocklist und wählt eine oder mehrere zu erfassende Kennungen aus.
3

Programmatisch: über die Lists API

Verwenden Sie die Lists API, um Einträge programmatisch hinzuzufügen. Dies ist dieselbe API, die die Konsole im Hintergrund verwendet.

​
Systemlisten vs. benutzerdefinierte Listen

Jede Anwendung hat Systemsperrlisten, eine pro Kennungstyp, die Didit automatisch verwaltet. Sie können sie nicht umbenennen oder löschen. Benutzerdefinierte Listen können Sie selbst anlegen, benennen und eingrenzen.

​
Benutzer per API zur Sperrliste hinzufügen

Verwenden Sie die Lists API, um einen Sperrlisteneintrag hinzuzufügen. Um einen Benutzer über vendor_data zu sperren, fügen Sie einen Eintrag vom Typ USER zur entsprechenden Sperrliste hinzu:
  1. Alle Listen abrufen, gefiltert nach entry_type=user und is_system=true, um die System User Blocklist zu finden.
  2. Einen Eintrag anlegen in dieser Liste, wobei value auf das vendor_data des Benutzers gesetzt wird.
Um einen Benutzer über das Gesicht zu sperren, siehe Gesichter & Biometrie. Um über E-Mail, Telefon, Dokument oder IP zu sperren, verwenden Sie die entsprechende Systemsperrliste mit der passenden Kennung in value.

​
Durchsetzungsablauf

Bei Gesichts- und Dokumentsperrlisten erfolgt die Prüfung im Verifizierungsschritt:

​
Aus der Sperrliste entfernen

  • Konsole: Sperrliste → [Typ] → Zeilenaktionen → Entfernen.
  • API: Verwenden Sie den Eintrag löschen-Endpoint mit der UUID der Liste und der UUID des Eintrags.
Das Entfernen des Eintrags setzt den Benutzer nicht automatisch wieder auf ACTIVE zurück. Verwenden Sie PATCH /v3/users/{vendor_data}/update-status/, um den Status zu ändern, wenn Sie neue Sitzungen wieder zulassen möchten.

​
Audit-Trail der Sperrliste

Jedes Hinzufügen und Entfernen auf einer Sperrliste wird im Audit-Log protokolliert:
  • Wer den Eintrag hinzugefügt hat (E-Mail des Benutzers oder 'system', 'api').
  • Wann.
  • Optionaler comment, der den Grund erläutert.
  • Verknüpfte Sitzung oder Transaktion, falls der Eintrag automatisch erzeugt wurde.

​
Nächste Schritte

Lists API

Vollständige API-Referenz für Sperr- und Freigabelisten.

Sperrliste in der Konsole

Sperrlisten über die Benutzeroberfläche verwalten.

Gesichter & Biometrie

So funktionieren Gesichtssperrlisten.
Zuletzt geändert am 7. November 2026