---
title: "Cos’è una IP allow list per una chiave API? Esempi CIDR"
description: "Una IP allow list accetta richieste solo da IP o intervalli CIDR elencati. Come protegge una chiave API LLM, come funziona il CIDR e le insidie degli IP cloud."
url: https://broadrouter.com/it/glossary/ip-allow-list/
lang: it
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Tradotto dall’inglese con l’aiuto dell’IA. [Leggi l’originale in inglese](https://broadrouter.com/glossary/ip-allow-list/) (aggiornato il 2026-11-14).

# IP allow list (whitelist di IP)

Aggiornato 2026-11-14

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](https://broadrouter.com/it/glossary/api-key/) 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:

```bash
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](https://broadrouter.com/it/guides/api-keys-ip-allow-lists/), e la tabella degli errori è in [errori e retry](https://broadrouter.com/it/guides/errors-and-retries/). Per il quadro più ampio della protezione dei dati, vedi la [checklist ZDR](https://broadrouter.com/it/blog/zero-data-retention-llm-api-checklist/).

## 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.

## Vedi anche

-   [Chiave API (API key)](https://broadrouter.com/it/glossary/api-key/) (termine)
-   [Zero data retention (nessuna conservazione dei dati)](https://broadrouter.com/it/glossary/zero-data-retention/) (termine)
-   [Rate limit (limite di frequenza)](https://broadrouter.com/it/glossary/rate-limit/) (termine)
-   [Limita le chiavi API ai tuoi server con le allowlist di IP](https://broadrouter.com/it/guides/api-keys-ip-allow-lists/) (guida)
-   [Codici di errore di BroadNet Inference e quando ritentare](https://broadrouter.com/it/guides/errors-and-retries/) (guida)
-   [API LLM con zero data retention: una checklist di 10 domande](https://broadrouter.com/it/blog/zero-data-retention-llm-api-checklist/) (articolo)

Provalo sul tuo carico di lavoro reale. I nuovi account partono con USD 5 di credito per Gemma e trascrizione. DeepSeek, GLM e Qwen3.8 richiedono una ricarica.

[Inizia](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-glossary-ip-allow-list&utm_content=page-cta) ·

**Fonti**

-   [RFC 4632: Classless Inter-domain Routing (CIDR)](https://www.rfc-editor.org/rfc/rfc4632)
-   [GitHub Docs, gestire gli indirizzi IP consentiti di un’organizzazione](https://docs.github.com/en/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization)
-   [Riferimento API di BroadNet Inference, IP allow list (in inglese)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-glossary-ip-allow-list&utm_content=sources#ip-allow-lists)
