Gebruik locatiewijzigingen om inlogbeoordeling te ondersteunen

Vergelijk de IP-afgeleide locatie van een inlog met het vorige opgeslagen punt voor die gebruiker om inlogs te markeren die een tweede blik verdienen — beschikbaarheid en handhaving per abonnement voor dit endpoint zijn nog niet bevestigd, dus bespreek toegang voordat je in productie integreert.

Bespreek toegang tot de risicocontrole Lees de risicocontrole-referentie →

Beschikbaarheid

POST /v1/risk/check deelt dezelfde geheime-sleutelmiddleware als IP-lookup, die controleert of een sleutel een geheime sleutel is — het handhaaft geen aparte risicoabonnementsfamilie onafhankelijk, en de voorgeladen risicoprijzen hebben geen actieve prijs geconfigureerd. Bevestig de huidige beschikbaarheid en voorwaarden bij ons voordat je hierop vertrouwt in productie.

Betrouwbare extractie van het client-IP

Watch-IP haalt voor dit endpoint het IP-adres van de eindgebruiker niet zelf uit je verzoek — jij geeft het op als ip. Leid het af uit je eigen vertrouwde proxy-/CDN-headerketen op je backend, dezelfde zorgvuldigheid die je overal zou toepassen waar je een client-IP vertrouwt voor een beveiligingsbeslissing.

Ondoorzichtige gebruikers-ID

Geef je eigen interne identificatie door als userId. Watch-IP bewaart precies één opgeslagen locatie per combinatie van (jouw klantaccount, userId) — hergebruik dezelfde identificatie bij de inlogs van een gebruiker, zodat de baseline betekenisvol blijft.

Eerste baseline, dan een voorcontrole

De allereerste aanroep van een gebruiker geeft altijd risk: "low" terug met een null previousLocation — er is nog niets om mee te vergelijken. Roep voor latere inlogs aan met commit: false als een vroeg signaal voorafgaand aan je eigen authenticatiebeslissing; die aanroep leest de opgeslagen baseline zonder deze te verplaatsen.

Commit na je eigen verificatie

Zodra je er zeker van bent dat de inlog legitiem is — wachtwoord en eventuele tweede factor al geverifieerd — roep opnieuw aan met commit op de standaardwaarde (true), zodat deze observatie de nieuwe baseline wordt voor de volgende inlog.

Gelijktijdigheid en herhaalde pogingen

v1 slaat één meest recente punt op, geen geschiedenis — twee vlak na elkaar gecommitte aanroepen overschrijven dezelfde waarde, en een herhaald verzoek na een time-out kan zelf ook een commit uitvoeren en de baseline verschuiven. Ontwerp je retrylogica hiermee in gedachten in plaats van aan te nemen dat elke commit onafhankelijk wordt geregistreerd.

Legitieme netwerkwijzigingen

Zakenreizen, hotel- of luchthaven-wifi, wisselende IP's van mobiele providers en gewoon VPN-gebruik kunnen allemaal een gemiddelde of hoge classificatie opleveren — v1 heeft geen VPN-/datacenterbewuste onderdrukking. Behandel een gemarkeerde inlog als één input voor je eigen beoordelingsproces, geen bewijs van compromittering.

Wat dit niet garandeert

Een hoge classificatie is een ruwe snelheidsberekening tussen twee punten, geen bevestiging van accountovername, en een lage classificatie ontslaat een inlog die om andere redenen verdacht is niet van verdenking. Retentie volgt het opslaggedrag hierboven: het opgeslagen punt blijft bestaan tot de volgende gecommitte controle het overschrijft, zonder automatisch verval en zonder momenteel beschikbaar verwijder-endpoint — houd daar rekening mee bij eventuele dataretentietoezeggingen aan je eigen gebruikers.