Sicurezza e gestione delle chiavi API di Watch-IP
Questa pagina descrive i controlli di accesso effettivamente implementati oggi nell'API di Watch-IP: come funzionano i due tipi di chiave, come vengono applicate le origini, come le chiavi possono essere ruotate o revocate e come segnalare un problema di sicurezza. Non rivendica una certificazione di conformità né un audit di sicurezza indipendente — nessuno dei due è stato completato al momento della stesura di questo testo.
Due tipi di chiave, due controlli diversi
Le chiavi pubblicabili (usate per GET /v1/geo e POST /v1/email/validate) sono pensate per essere eseguite nel codice del browser e non sono segrete — il controllo è l'elenco di origini consentite configurato per la chiave, verificato rispetto all'header Origin/Referer della richiesta. Le chiavi segrete (usate per GET/POST /v1/lookup e POST /v1/risk/check) sono credenziali da server a server senza alcun controllo dell'origine, poiché non esiste un header Origin del browser in una chiamata backend; tratta una chiave segreta come una password di database, non come un identificatore pubblico. Consulta l'autenticazione per il formato di richiesta previsto per ciascun tipo di chiave.
Come viene applicato il blocco per origine
Una richiesta con chiave pubblicabile proveniente da un'origine non presente nell'elenco consentito della chiave riceve un 403 senza alcun header Access-Control-Allow-Origin impostato. Il fatto che il browser blocchi quella risposta prima che il JavaScript della tua pagina possa leggerla è l'applicazione effettiva del controllo — il corpo dell'errore JSON è secondario. Il blocco per origine non rende segreta la chiave stessa e non impedisce a un client non browser di inviare un header Origin contraffatto; protegge specificamente la superficie delle chiamate da browser.
Trasporto e archiviazione
Il traffico verso l'API e la dashboard è crittografato in transito (TLS/HTTPS); l'API non accetta HTTP in chiaro per le richieste autenticate con chiave. Le chiavi API sono archiviate con hash (SHA-256), non in chiaro, quindi la sola compromissione di un database non esporrebbe valori di chiave utilizzabili.
Rotazione e revoca
Puoi revocare o ruotare una chiave dalla dashboard. La revoca non è istantanea ovunque: la validità della chiave viene messa in cache fino a 5 minuti dopo una ricerca, quindi una chiave revocata può continuare a essere accettata fino a 5 minuti dopo la revoca — tienine conto per la rapidità con cui puoi interrompere l'accesso dopo un sospetto di compromissione, e ruota in modo proattivo anziché affidarti solo alla revoca per un incidente urgente.
Limitazione della frequenza
Ogni chiave è soggetta a un limite di frequenza per account cliente su una finestra fissa di un minuto, condivisa tra qualsiasi endpoint tu chiami — non un budget per singola rotta. Questo limita il danno che una singola chiave trafugata o utilizzata in modo improprio può causare in una breve finestra, anche se non sostituisce di per sé la rotazione di una chiave compromessa.
Segnalare un problema di sicurezza
Scrivi a security@watch-ip.com se ritieni che una chiave sia stata compromessa o hai trovato un problema di sicurezza nell'API o nella dashboard. Al momento non gestiamo un programma pubblico di bug bounty né deteniamo una certificazione di sicurezza di terze parti — se questo cambierà, questa pagina lo indicherà con una data, non con un badge.