Zum Hauptinhalt springen
Die API zur Geschwindigkeits- und Anomaliebewertung verfolgt, wie häufig ein Subjekt eine bestimmte Aktion über mehrere gleitende Zeitfenster hinweg ausführt – 1 Minute, 5 Minuten, 1 Stunde und 24 Stunden. Wenn der gewichtete Geschwindigkeitswert einen Schwellenwert überschreitet, erstellt die Plattform automatisch ein Risikosignal, das die Anomalieerkennung direkt mit der Anti-Betrugs-Identitäts-Firewall-Pipeline verbindet.
Die Geschwindigkeitsbewertung ist Teil der Anti-Fraud Identity Firewall. Signale, die durch Geschwindigkeitsanomalien erzeugt werden, fließen in dieselbe Pipeline wie andere Betrugssignale, sodass Sie sie von der Konsolenseite Risk & Fraud > Signals oder dem list signals endpoint abfragen und überprüfen können.

Funktionsweise

1

Aktionen aufzeichnen

Rufen Sie POST /v1/risk/velocity/record jedes Mal auf, wenn ein Subjekt eine verfolgte Aktion ausführt – Anmeldeversuche, API-Aufrufe, Transaktionsanfragen oder jede benutzerdefinierte Aktion.
2

Tracking im rollierenden Fenster

Die Plattform erhöht Zähler für das Subjekt und den Aktionstyp über vier rollierende Fenster (1 m, 5 m, 1 h, 24 h). Fenster werden automatisch zurückgesetzt, wenn sie ablaufen.
3

Gewichtete Bewertung

Ein Geschwindigkeitswert wird aus den Fensterzählungen berechnet. Kurze Fenster werden stärker gewichtet, um Bursts zu erkennen: 1 m × 30, 5 m × 20, 1 h × 10, 24 h × 5.
4

Automatische Signalerfassung

Wenn der Geschwindigkeitsscore 60 oder höher erreicht, nimmt die Plattform automatisch ein Risikosignal mit signal_type: "velocity" auf. Sie benötigen keinen separaten API-Aufruf.
5

Überprüfen und antworten

Fragen Sie Geschwindigkeitsfenster für ein Subjekt ab, listen Sie Anomalien mit hoher Geschwindigkeit in Ihrem Mandanten auf und überprüfen Sie Signale in der Konsole oder über die API.

Voraussetzungen

  • Ein aktiver Truthlocks-Mandant mit einem API-Schlüssel
  • Aktionsereignisdaten aus Ihrer Anwendung (Anmeldeversuche, API-Aufrufe, Transaktionen oder jede wiederholbare Aktion)

Eine Aktion aufzeichnen

Senden Sie eine POST-Anfrage an /v1/risk/velocity/record mit dem Betreff, dem Aktionstyp und optionalen Metadaten:
Die Antwort gibt die aktuellen Fensterzählungen, den berechneten Geschwindigkeitsscore und an, ob ein Risikosignal automatisch aufgenommen wurde:

Bewertungsmodell

Der Geschwindigkeitsscore ist eine gewichtete Summe der Aktionszählungen über vier gleitende Fenster. Kurze Fenster haben ein höheres Gewicht, um die Erkennung von Bursts zu priorisieren: Der Endwert ist auf 100 begrenzt. Wenn der Wert 60 oder höher erreicht, wird automatisch ein Risikosignal mit signal_type: "velocity" erfasst.

Score-Interpretation

Geschwindigkeitsfenster abfragen

Rufen Sie die aktuellen Geschwindigkeitsfenster für ein bestimmtes Subjekt ab:
Die Antwort enthält alle verfolgten Aktionstypen für das Subjekt, mit Zählungen pro Fenster und dem berechneten Geschwindigkeitsscore für jeden:

Auflistung von Anomalien mit hoher Geschwindigkeit

Betreffs mit Geschwindigkeitswerten über einem Schwellenwert in Ihrem Mandanten abfragen:
Jedes Ergebnis enthält das Subjekt, den Aktionstyp, die aktuellen Fensterzählungen und den Geschwindigkeitsscore, der die Anomalie qualifiziert hat:

Integrationsmuster

Blockieren oder Drosseln bei hoher Geschwindigkeit

Verwenden Sie den Geschwindigkeitsscore aus der Datensatzantwort, um zu entscheiden, ob eine Aktion zugelassen, gedrosselt oder blockiert werden soll:

Mit ATO-Erkennung kombinieren

Die Geschwindigkeitsbewertung verfolgt jeden Aktionstyp über mehrere Zeitfenster hinweg, während ATO-Erkennung speziell für anmeldebasierte Kontoübernahmemuster mit integrierten Schwellenwertregeln und Alarmverwaltung optimiert ist. Verwenden Sie beides zusammen für einen mehrschichtigen Schutz:
  • Geschwindigkeitsbewertung zur allgemeinen Missbrauchserkennung – API-Ratenmissbrauch, Transaktionsflut, Registrierungs-Spam
  • ATO-Erkennung für fokussierte Anmeldesicherheit – Geschwindigkeit fehlgeschlagener Anmeldungen, Warnungen bei Credential Stuffing, Risikoprofile von Subjekten

Über Webhooks überwachen

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

Benutzerdefinierte Aktionstypen

Sie können jeden Aktionstyp verfolgen, den Ihre Anwendung erzeugt. Häufige Beispiele:

Nutzungsabrechnung

Jeder Aufruf von POST /v1/risk/velocity/record erhöht den Nutzungszähler antifraud.velocity_records für Ihren Abrechnungszyklus. Sie können Ihren Verbrauch mit der Nutzungs-API oder in der Konsole unter Einstellungen > Abrechnung > Nutzung im Abschnitt Betrugsbekämpfung überwachen.
Die Quoten für Geschwindigkeitsaufzeichnungen variieren je nach Planstufe. Details zu allen Anti-Fraud-Produkten mit Zähler finden Sie in der Abrechnungsübersicht.

Was als Nächstes kommt