Sperrlisten-API: Sperrlisten & Allowlists

Mit der Lists API verwalten Sie typisierte Listen für Ihre Anwendung. System-Sperrlisten werden automatisch erstellt und bei der Verifizierung sowie beim Transaktions-Screening geprüft. Sie können außerdem Zulassungslisten und benutzerdefinierte Listen für Workflow-Bedingungen erstellen.

Konzepte

Typ	Beschreibung
Sperrliste	Vom System erstellt, eine pro Eintragstyp. Einträge in einer Sperrliste führen bei der Verifizierung oder beim Transaktions-Screening automatisch zur Ablehnung.
Zulassungsliste	Vom Benutzer erstellt. Wird in Workflow-Bedingungen verwendet und unterdrückt Duplikat- und Wiederverwendungsaktionen für vertrauenswürdige übereinstimmende Einträge.
Benutzerdefiniert	Vom Benutzer erstellt. Flexible Listen für Workflow-Verzweigungen, Überwachungsregeln oder manuelle Prüfung.

Eintragstypen

Eintragstyp	Geprüft bei	Bei Treffer
`face`	Liveness-Verifizierung	Sitzung abgelehnt
`document`	Ausweisverifizierung (OCR)	Sitzung abgelehnt
`phone`	Telefonverifizierung	Sitzung abgelehnt
`email`	E-Mail-Verifizierung	Sitzung abgelehnt
`ip_address`	Geräte- und IP-Analyse (unterstützt CIDR-Bereiche)	Sitzung abgelehnt
`device_fingerprint`	Geräte- und IP-Analyse	Sitzung abgelehnt
`wallet_address`	Transaktions-Screening	Transaktion abgelehnt
`bank_account`	Transaktions-Screening	Transaktion abgelehnt
`user`	Transaktions-Screening	Benutzer gesperrt
`business`	Transaktions-Screening	Unternehmen gesperrt
`country`	Workflow-Bedingungen	Konfigurierbar
`key`	Benutzerdefinierte Nutzung	Konfigurierbar

Zulassungslisten

Zulassungslisten heben Sperrlisten oder Echtheitsprüfungen nicht auf. Sie unterdrücken nur Duplikat- und Wiederverwendungsaktionen für denselben Eintragstyp. Ein Gesicht in einer Gesichts-Zulassungsliste kann zum Beispiel die Aktion DUPLICATED_FACE überspringen, eine IP-Adresse in einer IP-Zulassungsliste kann die Aktion DUPLICATED_IP_ADDRESS überspringen, und ein Geräte-Fingerprint in einer Geräte-Zulassungsliste kann die Aktion DUPLICATED_DEVICE_FINGERPRINT überspringen. Didit protokolliert trotzdem eine informative Warnung zur Zulassungsliste, damit Sie nachvollziehen können, warum die Duplikataktion nicht ausgeführt wurde.

System-Sperrlisten

Jede Anwendung erhält automatisch 10 System-Sperrlisten (eine pro unterstütztem Eintragstyp) und eine System-Liste High Risk Countries. Diese können weder gelöscht noch umbenannt werden. Sie können über die API oder über die Konsole Einträge hinzufügen.

Rückverfolgbarkeit

Jeder Eintrag in einer Sperrliste kann mit seiner Quelle verknüpft werden, sodass Sie von der Liste zum ursprünglichen Datensatz navigieren können:

Aus einer Sitzung: Übergeben Sie reference_session_id beim Erstellen eines Eintrags. Didit extrahiert den Wert (Gesicht, Dokument, Telefon, E-Mail, IP oder Gerät) automatisch, markiert das zugrunde liegende Modell als gesperrt und verknüpft den Eintrag wieder mit der Sitzung. Didit liest den neuesten Datensatz dieses Typs in der Sitzung. Um einen Wert aus einem früheren Datensatz aufzunehmen, fügen Sie ihn über value ohne reference_session_id hinzu.
Aus einer Transaktion, einem Benutzer oder einem Unternehmen: Übergeben Sie reference_object_uuid mit der UUID der Entität und fügen Sie metadata.reference_type hinzu ("transaction", "vendor_user" oder "vendor_business"), damit die Konsole zum ursprünglichen Datensatz zurückverknüpfen kann.

Endpoints

Alle Listen abrufen

Alle Listen einer Anwendung abrufen.

Einträge auflisten

Einträge einer Liste abrufen.

Eintrag erstellen

Einen Wert zu einer Sperrliste hinzufügen: per Wert, Sitzungsreferenz oder Transaktionsreferenz.

Eintrag löschen

Einen Eintrag entfernen und die zugrunde liegende Entität entsperren.

Gesicht hochladen

Ein Gesichtsbild direkt in eine Gesichts-Sperrliste hochladen.

​Konzepte

​Eintragstypen

​Zulassungslisten

​System-Sperrlisten

​Rückverfolgbarkeit

​Endpoints