BroadRouter
Inizia

IP allow list (whitelist di IP)

Aggiornato

Una IP allow list è un controllo di sicurezza che accetta richieste solo da indirizzi IP o intervalli CIDR elencati e rifiuta tutti gli altri. Su un’API limita i danni di una chiave trapelata, perché la chiave non funziona dalle reti che non sono nella lista.

Detto anche: whitelist IP, lista di IP consentiti, IP consentiti, restrizione IP, limitare una chiave API per IP, IP allow list, IP allowlist, IP whitelist, allowed IPs, IP restriction, allowed_ips

Per default una chiave API funziona da qualsiasi luogo. Una allow list la lega ai posti in cui esegui davvero il tuo codice.

Come funziona

Il bordo della rete dell’API confronta l’IP di origine di ogni richiesta con una lista. Se l’indirizzo è nella lista, o dentro un intervallo elencato, la richiesta prosegue verso il normale controllo della chiave. Altrimenti viene rifiutata.

Gli intervalli si scrivono in notazione CIDR: un indirizzo, una barra e la lunghezza del prefisso. L’RFC 4632 spiega che la lunghezza del prefisso indica quanti bit iniziali sono fissi. Per IPv4:

Voce Copre
203.0.113.7 un indirizzo
198.51.100.0/24 256 indirizzi, da 198.51.100.0 a 198.51.100.255
10.0.0.0/16 65.536 indirizzi

IPv6 usa la stessa idea con indirizzi a 128 bit, come 2001:db8::/48.

L’indirizzo che conta è il tuo IP di uscita (egress): l’indirizzo pubblico da cui esce il traffico del server. Dietro un NAT, un load balancer o un proxy aziendale, spesso non è l’indirizzo che la macchina mostra per sé.

Perché è importante

Le chiavi API sono bearer token: chiunque ne abbia una può usarla. Le chiavi trapelano tramite commit, log, screenshot e portatili. Con una allow list, una chiave rubata non funziona dalla rete dell’attaccante, e una fuga passa da incidente di spesa a non-evento. GitHub, per esempio, applica la sua allow list alle chiamate API e ai personal access token oltre che agli accessi web.

Il prezzo è un po’ di lavoro operativo. Ogni nuovo server, regione o runner di CI richiede di aggiungere il suo IP di uscita, e gli IP dinamici richiedono un percorso di uscita fisso.

Su BroadNet Inference

Nella pagina dell’account, aggiungi un indirizzo IPv4 o IPv6 o un intervallo CIDR per riga, fino a 32 voci. Una lista vuota significa nessuna restrizione. Le nuove chiavi ereditano la lista dell’account. Un allowed_ips per chiave la sostituisce per quella chiave:

curl -X POST https://inference.broadnet.ai/portal/keys \
  -H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL" \
  -H "Content-Type: application/json" \
  -d '{"label":"worker-1","allowed_ips":["203.0.113.7","198.51.100.0/24"]}'

Le richieste da altri indirizzi ricevono un 403. Dopo una modifica o la revoca di una chiave, le nuove richieste si fermano entro cinque secondi. I passaggi completi sono in chiavi API e IP allow list, e la tabella degli errori è in errori e retry. Per il quadro più ampio della protezione dei dati, vedi la checklist ZDR.

Errori comuni

  • Elencare l’indirizzo privato di un server, come 10.x.x.x, invece del suo IP pubblico di uscita.
  • Usare un intervallo molto ampio per far sparire gli errori. Un /8 copre oltre 16 milioni di indirizzi.

Domande frequenti

Una IP allow list basta a proteggere una chiave API?

No. È uno strato di difesa. Continua a tenere le chiavi sui server, fuori dal codice e dai log, dai a ogni app la sua chiave e revoca subito le chiavi trapelate.

I miei server girano su infrastruttura serverless o con autoscaling. Posso usare una allow list?

Solo se il traffico in uscita parte da indirizzi noti. Fallo passare da un NAT gateway o da un proxy di uscita con IP fissi, poi elenca quelli.

Che errore ricevo da un IP che non è nella lista?

Su BroadNet Inference, un 403. Anche le altre API di solito restituiscono 403.

Leggi in MarkdownChiedi a ChatGPTChiedi a ClaudeChiedi a Perplexity