Standortänderungen zur Login-Überprüfung nutzen

Vergleichen Sie den IP-abgeleiteten Standort eines Logins mit dem zuvor gespeicherten Punkt für diesen Nutzer, um Logins zu kennzeichnen, die einen zweiten Blick verdienen — Verfügbarkeit und Tarif-Durchsetzung für diesen Endpoint sind noch nicht bestätigt, besprechen Sie den Zugriff daher vor der Integration in die Produktion.

Zugriff auf die Risikoprüfung besprechen Die Risikoprüfungs-Referenz lesen →

Verfügbarkeit

POST /v1/risk/check nutzt dieselbe Middleware für geheime Schlüssel wie die IP-Abfrage, die lediglich prüft, dass ein Schlüssel ein geheimer Schlüssel ist — sie erzwingt keine eigenständige Risiko-Tariffamilie, und für die eingerichtete Risiko-Preisgestaltung ist kein aktiver Preis konfiguriert. Bestätigen Sie aktuelle Verfügbarkeit und Bedingungen bei uns, bevor Sie sich in der Produktion auf diesen Endpoint verlassen.

Zuverlässige Ermittlung der Client-IP

Watch-IP extrahiert für diesen Endpoint nicht die IP des Endnutzers aus Ihrer Anfrage — Sie geben sie als ip an. Ermitteln Sie sie aus Ihrer eigenen vertrauenswürdigen Proxy-/CDN-Header-Kette in Ihrem Backend, mit derselben Sorgfalt, die Sie überall anwenden würden, wo Sie einer Client-IP für eine Sicherheitsentscheidung vertrauen.

Undurchsichtige Nutzer-ID

Übergeben Sie Ihre eigene interne Kennung als userId. Watch-IP speichert genau einen Standort pro Paar (Ihr Kundenkonto, userId) — verwenden Sie dieselbe Kennung über die Logins eines Nutzers hinweg wieder, damit die Baseline aussagekräftig bleibt.

Erste Baseline, dann eine Vorabprüfung

Der allererste Aufruf eines Nutzers liefert immer risk: "low" mit einem null-previousLocation — es gibt noch nichts zum Vergleich. Rufen Sie bei späteren Logins mit commit: false als frühes Signal vor Ihrer eigenen Authentifizierungsentscheidung auf; dieser Aufruf liest die gespeicherte Baseline, ohne sie zu verändern.

Nach eigener Verifizierung übernehmen

Sobald Sie sicher sind, dass der Login legitim ist — Passwort und ein etwaiger zweiter Faktor bereits verifiziert —, rufen Sie erneut mit commit auf dem Standardwert (true) auf, sodass diese Beobachtung zur neuen Baseline für den nächsten Login wird.

Nebenläufigkeit und Wiederholungen

v1 speichert einen einzelnen, aktuellsten Punkt, keine Historie — zwei kurz aufeinanderfolgende übernommene Aufrufe überschreiben denselben Wert, und eine nach einem Timeout wiederholte Anfrage kann selbst übernehmen und die Baseline verschieben. Gestalten Sie Ihre Wiederholungslogik entsprechend, statt anzunehmen, dass jede Übernahme unabhängig erfasst wird.

Legitime Netzwerkänderungen

Geschäftsreisen, Hotel- oder Flughafen-WLAN, IP-Wechsel bei Mobilfunkanbietern und gewöhnliche VPN-Nutzung können alle eine mittlere oder hohe Einstufung erzeugen — v1 hat keine VPN-/Rechenzentrums-bewusste Unterdrückung. Behandeln Sie einen gekennzeichneten Login als eine Eingabe für Ihren eigenen Prüfprozess, nicht als Beweis für eine Kompromittierung.

Was dies nicht garantiert

Eine hohe Einstufung ist eine reine Geschwindigkeitsberechnung zwischen zwei Punkten, keine Bestätigung einer Kontoübernahme, und eine niedrige Einstufung entlastet keinen Login, der aus anderen Gründen verdächtig ist. Die Aufbewahrung folgt dem oben beschriebenen Speicherverhalten: Der gespeicherte Punkt bleibt bestehen, bis die nächste übernommene Prüfung ihn überschreibt, ohne automatischen Ablauf und derzeit ohne verfügbaren Löschendpoint — berücksichtigen Sie das bei jeder Datenaufbewahrungszusage gegenüber Ihren eigenen Nutzern.