> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Benutzersperrliste: Gesichter, Dokumente, E-Mails sperren > So setzt Didit Sperren für Benutzer-Entitäten durch: Identifikatortypen, Prüfung einer Sperre sowie Hinzufügen und Entfernen von Einträgen. 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 | Typ | Schlüssel | Trifft zu, wenn … | | - | - | - | | Gesicht | `FACE` | Das Liveness-Selfie einer neuen Sitzung stimmt mit dem gesperrten Gesicht überein | | Dokumentnummer | `DOCUMENT` | Die Einreichung eines neuen Ausweises stimmt mit der gesperrten Dokumentnummer überein | | E-Mail | `EMAIL` | Eine neue Sitzung oder Transaktion verwendet die gesperrte E-Mail-Adresse | | Telefon | `PHONE` | Eine neue Sitzung oder Transaktion verwendet die gesperrte Telefonnummer | | Adresse | `IP_ADDRESS` | Die Adresse des Absenders stimmt überein; unterstützt werden einzelne Adressen (`1.2.3.4`) und CIDR-Bereiche (`10.0.0.0/8`) | | Geräte-Fingerprint | `DEVICE_FINGERPRINT` | Der Geräte-Fingerprint des Absenders stimmt überein | | Benutzer | `USER` | Die Sitzung oder Transaktion verwendet das gesperrte `vendor_data` | 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 > [!NOTE] > > 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](https://docs.didit.me/de/console/blocklist-users.md) oder mit der [Lists API](https://docs.didit.me/de/management-api/lists/overview.md) 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](https://docs.didit.me/de/management-api/lists/overview.md), 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. | Liste | Erstellt von | Beschreibung | | - | - | - | | System Face Blocklist | Didit | Kanonische Gesichtssperrliste für die Anwendung | | System Document Blocklist | Didit | Kanonische Sperrliste für Dokumentnummern | | System Email Blocklist | Didit | Kanonische E-Mail-Sperrliste | | System Phone Blocklist | Didit | Kanonische Telefonsperrliste | | System User Blocklist | Didit | Gesperrte `vendor_data`-Kennungen | | Benutzerdefinierte Sperrlisten | Sie | Eingegrenzte Listen, z. B. pro Region, pro Partner oder pro Risikostufe | ## Benutzer per API zur Sperrliste hinzufügen Verwenden Sie die [Lists API](https://docs.didit.me/de/management-api/lists/overview.md), 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](https://docs.didit.me/de/management-api/lists/list.md), gefiltert nach `entry_type=user` und `is_system=true`, um die System User Blocklist zu finden. 2. [Einen Eintrag anlegen](https://docs.didit.me/de/management-api/lists/create-entry.md) in dieser Liste, wobei `value` auf das `vendor_data` des Benutzers gesetzt wird. Um einen Benutzer über das Gesicht zu sperren, siehe [Gesichter & Biometrie](https://docs.didit.me/de/entities/users/faces-and-biometrics.md#ein-gesicht-in-die-sperrliste-hochladen). Um über E-Mail, Telefon, Dokument oder IP zu sperren, verwenden Sie die entsprechende Systemsperrliste mit der passenden Kennung in `value`. ## Durchsetzungsablauf ```mermaid theme={null} sequenceDiagram participant Client participant Didit participant Lists as Blocklist check participant Workflow Client->>Didit: POST /v3/session/ (vendor_data=user-42) Didit->>Lists: Does user-42 match a USER blocklist? Lists-->>Didit: Match found Didit-->>Client: Session auto-declined (reason: blocked_user) ``` Bei Gesichts- und Dokumentsperrlisten erfolgt die Prüfung im Verifizierungsschritt: ```mermaid theme={null} sequenceDiagram participant User participant Didit participant Lists as Face Blocklist User->>Didit: Liveness capture Didit->>Lists: Embedding search Lists-->>Didit: Match similarity > threshold Didit-->>User: Session declined (reason: blocked_face) ``` ## Aus der Sperrliste entfernen * **Konsole**: *Sperrliste → \[Typ] → Zeilenaktionen → Entfernen*. * **API**: Verwenden Sie den [Eintrag löschen](https://docs.didit.me/de/management-api/lists/delete-entry.md)-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](https://docs.didit.me/de/console/audit-logs.md) 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 > [card] [Lists API](https://docs.didit.me/de/management-api/lists/overview.md) > > Vollständige API-Referenz für Sperr- und Freigabelisten. > [card] [Sperrliste in der Konsole](https://docs.didit.me/de/console/blocklist-users.md) > > Sperrlisten über die Benutzeroberfläche verwalten. > [card] [Gesichter & Biometrie](https://docs.didit.me/de/entities/users/faces-and-biometrics.md) > > So funktionieren Gesichtssperrlisten. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.