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 einePOST-Anfrage an /v1/risk/velocity/record mit dem Betreff, dem Aktionstyp und optionalen Metadaten:
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:Auflistung von Anomalien mit hoher Geschwindigkeit
Betreffs mit Geschwindigkeitswerten über einem Schwellenwert in Ihrem Mandanten abfragen: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 vonPOST /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
- API-Referenz zur Aufzeichnung von Geschwindigkeitsaktionen
- API-Referenz zum Abrufen von Geschwindigkeitsfenstern
- API-Referenz zum Auflisten von Geschwindigkeitsanomalien
- Leitfaden für Risikosignale
- Leitfaden zur Erkennung von Kontoübernahmen
- Leitfaden zur Erkennung von Deepfakes und Identitätsdiebstahl

