Zum Hauptinhalt springen
Die API zur Erkennung von Kontoübernahmen (ATO) überwacht die Anmeldeaktivität pro Subjekt und kennzeichnet verdächtige Muster in Echtzeit. Sie verfolgt die Geschwindigkeit fehlgeschlagener Anmeldungen in einem rollierenden einstündigen Fenster, weist ein Risikoniveau basierend auf konfigurierbaren Schwellenwerten zu und erstellt automatisch Warnungen und Risikosignale, wenn diese Schwellenwerte überschritten werden.
Die ATO-Erkennung ist Teil der Anti-Fraud Identity Firewall. Warnungen und Risikosignale fließen in dieselbe Pipeline wie andere Betrugssignale, sodass Sie diese auf der Konsolenseite Risk & Fraud > Signals oder über den list signals endpoint abfragen und überprüfen können.

Funktionsweise

1

Login-Ereignisse senden

Rufen Sie POST /v1/risk/ato/evaluate jedes Mal auf, wenn ein Anmeldeereignis auftritt – fehlgeschlagene Versuche, wiederholte Fehler, Anmeldungen von neuen Geräten oder erfolgreiche Anmeldungen.
2

Geschwindigkeitsverfolgung

Die Plattform erhöht (oder setzt zurück) den Zähler für fehlgeschlagene Anmeldungen für das Subjekt in einem rollierenden einstündigen Fenster. Erfolgreiche Anmeldungen setzen das Fenster zurück.
3

Zuordnung des Risikolevels

Ein Risikolevel wird aus der aktuellen Anzahl fehlgeschlagener Anmeldungen abgeleitet. Die Antwort enthält das Risikolevel, den numerischen Wert und den aktuellen Zählerwert.
4

Automatische Alarme und Signale

Wenn ein Subjekt einen Schwellenwert überschreitet, erstellt die Plattform einen Alarm und nimmt ein Risikosignal mit signal_type: "ato" auf. Sie benötigen keinen separaten API-Aufruf.
5

Überprüfen und antworten

Fragen Sie ATO-Profile ab, listen Sie Warnungen auf und überprüfen Sie Signale in der Konsole oder über die API, um Bedrohungen zu untersuchen und darauf zu reagieren.

Voraussetzungen

  • Ein aktiver Truthlocks-Mandant mit einem API-Schlüssel
  • Anmeldeereignisdaten aus Ihrem Authentifizierungssystem (fehlgeschlagene Anmeldungen, Erfolge, neue Geräteereignisse)

Ein Anmeldeereignis bewerten

Senden Sie eine POST-Anfrage an /v1/risk/ato/evaluate mit dem Betreff und den Ereignisdetails:
Die Antwort teilt Ihnen die aktuelle Risikoposition mit und ob ein Alarm ausgelöst wurde:

Schwellenwertregeln

Die Plattform weist ein Risikoniveau basierend auf der Anzahl fehlgeschlagener Anmeldungen innerhalb eines rollierenden Ein-Stunden-Fensters zu: Wenn ein Schwellenwert überschritten wird:
  1. Eine Warnung wird in der ATO-Warnungstabelle erstellt
  2. Ein Risikosignal wird automatisch mit signal_type: "ato" und dem entsprechenden Score erfasst
  3. Die Antwort enthält alert: true, die alert_type und die signal_id

Ereignistypen

Risikoprofil eines Subjekts prüfen

Rufen Sie das aktuelle ATO-Risikoprofil für ein Subjekt ab, ohne eine neue Bewertung auszulösen:
Das Profil enthält das aktuelle Risikoniveau, die Anzahl fehlgeschlagener Anmeldungen und Listen bekannter IP-Adressen und Geräte, die dem Subjekt zugeordnet sind.

Warnmeldungen auflisten

ATO-Warnungen für Ihren Mandanten abfragen, optional nach Betreff gefiltert:
Jede Warnung enthält das Subjekt, den Warnungstyp, das Risikoniveau zum Zeitpunkt der Auslösung und einen Verweis auf das automatisch erfasste Risikosignal.

Integrationsmuster

Blockieren oder Anfechten bei erhöhtem Risiko

Verwenden Sie den risk_level aus der Auswertungsantwort, um zu entscheiden, ob ein Login zugelassen, angefochten oder blockiert werden soll:

Mit Ereignisnormalisierung kombinieren

Die ATO-Bewertung kann die Ereignisnormalisierungspipeline ergänzen. Verwenden Sie die Ereignisnormalisierung für eine breite Risikobewertung über alle Identitätsereignisse hinweg und die ATO-Bewertung für eine fokussierte Kontoüberwachungsüberwachung mit schwellenwertbasierten Warnungen.

Mit Geschwindigkeitsbewertung kombinieren

Die ATO-Erkennung konzentriert sich auf loginbasierte Kontoübernahmemuster mit integrierten Schwellenwertregeln und Warnungsverwaltung. Velocity Scoring verfolgt jeden Aktionstyp über mehrere rollierende Zeitfenster (1 m, 5 m, 1 h, 24 h) mit gewichteter Burst-Erkennung. Verwenden Sie beides zusammen für einen mehrschichtigen Schutz:
  • ATO-Erkennung für fokussierte Anmeldesicherheit – Geschwindigkeit fehlgeschlagener Anmeldungen, Warnungen bei Credential Stuffing, Risikoprofile von Subjekten
  • Geschwindigkeitsbewertung zur allgemeinen Missbrauchserkennung – API-Ratenmissbrauch, Transaktionsflut, Registrierungs-Spam oder jede benutzerdefinierte Aktionstyp
Beide erzeugen Risikosignale in derselben einheitlichen Pipeline, sodass Sie alle Signale von einem Ort aus abfragen und überprüfen können.

Über Webhooks überwachen

Konfigurieren Sie einen Webhook-Endpunkt, um Echtzeitbenachrichtigungen zu erhalten, wenn ATO-Warnungen erstellt werden, damit Ihr Sicherheitsteam ohne Abfragen reagieren kann.

Was als Nächstes kommt