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
/8copre oltre 16 milioni di indirizzi.