Usa le variazioni di posizione per informare la revisione degli accessi

Confronta la posizione derivata dall'IP di un accesso con il punto precedente memorizzato per quell'utente per segnalare gli accessi che meritano un secondo sguardo — disponibilità e applicazione del piano per questo endpoint non sono ancora confermate, quindi discuti dell'accesso prima di integrarlo in produzione.

Discuti l'accesso al controllo del rischio Leggi il riferimento del controllo del rischio →

Disponibilità

POST /v1/risk/check condivide lo stesso middleware a chiave segreta della ricerca IP, che verifica solo che una chiave sia una chiave segreta — non applica in modo indipendente una famiglia di piani di rischio separata, e il prezzo di rischio precaricato non ha un prezzo attivo configurato. Verifica con noi la disponibilità e i termini attuali prima di affidarti a questo endpoint in produzione.

Estrazione affidabile dell'IP del client

Watch-IP non estrae l'IP dell'utente finale dalla tua richiesta per questo endpoint — lo fornisci tu come ip. Risolvilo dalla tua catena di header proxy/CDN affidabile sul tuo backend, con la stessa attenzione che applicheresti ovunque ti affidi a un IP client per una decisione di sicurezza.

ID utente opaco

Passa il tuo identificatore interno come userId. Watch-IP mantiene esattamente una posizione memorizzata per coppia (il tuo account cliente, userId) — riutilizza lo stesso identificatore tra gli accessi di un utente in modo che la baseline resti significativa.

Prima baseline, poi un pre-controllo

La primissima chiamata di un utente restituisce sempre risk: "low" con un previousLocation null — non c'è ancora nulla con cui confrontare. Per gli accessi successivi, chiama con commit: false come segnale anticipato prima della tua decisione di autenticazione; quella chiamata legge la baseline memorizzata senza spostarla.

Esegui il commit dopo la tua verifica

Una volta sicuro che l'accesso sia legittimo — password ed eventuale secondo fattore già verificati — chiama di nuovo lasciando commit al suo valore predefinito (true), così questa osservazione diventa la nuova baseline per il prossimo accesso.

Concorrenza e nuovi tentativi

La v1 memorizza un unico punto più recente, non una cronologia — due chiamate con commit ravvicinate sovrascrivono lo stesso valore, e una richiesta ritentata dopo un timeout può a sua volta eseguire il commit e spostare la baseline. Progetta la tua logica di retry tenendo conto di questo, anziché presumere che ogni commit venga registrato in modo indipendente.

Cambi di rete legittimi

Viaggi di lavoro, wifi di hotel o aeroporto, rotazione IP degli operatori mobili e l'uso normale di una VPN possono tutti produrre una classificazione media o alta — la v1 non ha alcuna soppressione consapevole di VPN/datacenter. Tratta un accesso segnalato come un input al tuo processo di revisione, non come prova di compromissione.

Cosa questo non garantisce

Una classificazione alta è un calcolo grezzo di velocità tra due punti, non una conferma di compromissione dell'account, e una classificazione bassa non scagiona un accesso sospetto per altri motivi. La conservazione segue il comportamento di archiviazione sopra descritto: il punto memorizzato persiste finché il controllo con commit successivo non lo sovrascrive, senza scadenza automatica e senza un endpoint di eliminazione attualmente disponibile — tienine conto in qualsiasi impegno di conservazione dei dati che assumi verso i tuoi utenti.