---
title: "Limitare una chiave API LLM agli IP dei tuoi server | BroadRouter"
description: "Proteggi le chiavi di BroadNet Inference con le allowlist di IP, separa chiavi di inferenza e credenziali del portale, revoca subito una chiave esposta. Con curl."
url: https://broadrouter.com/it/guides/api-keys-ip-allow-lists/
lang: it
updated: 2026-11-16
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/guides/api-keys-ip-allow-lists/) (aggiornato il 2026-11-16).

# Limita le chiavi API ai tuoi server con le allowlist di IP

Aggiornato 2026-11-16

Aggiungi all’allowlist dell’account gli indirizzi IPv4 o IPv6 in uscita dei tuoi server, o intervalli CIDR, fino a 32 voci. Le nuove chiavi ereditano l’elenco, a meno che tu non passi allowed\_ips quando ne crei una. Le richieste da altri indirizzi ricevono un 403, e modifiche all’allowlist o revoche diventano effettive entro cinque secondi.

Una chiave esposta è il modo più comune in cui una fattura API va fuori controllo. BroadNet Inference ti dà due strumenti: un’allowlist di IP e una revoca rapida.

## Due tipi di credenziale

| Credenziale | A cosa serve | Trattala come |
| --- | --- | --- |
| Chiave di inferenza | Richieste ai modelli su `/v1/*` | Un segreto per una sola app o un solo agente |
| Credenziale del portale | Automazione dell’account: chiavi, IP consentiti, acquisti | Pieni poteri sull’account |

Entrambe vengono mostrate una sola volta. Il portale conserva solo un hash SHA-256, quindi non può mostrarti di nuovo la chiave. Una chiave di inferenza a consumo dura un anno dalla creazione, e un account può avere fino a dieci chiavi attive.

## Imposta un’allowlist

Nella pagina dell’account aggiungi un indirizzo IPv4 o IPv6 o un intervallo CIDR per riga, fino a 32 voci. Un elenco vuoto significa nessuna restrizione per IP. Le nuove chiavi ereditano questo elenco dell’account. A ogni richiesta API l’edge controlla l’IP del client riportato da Cloudflare.

Per gestire l’elenco dell’account da uno script, `PUT /portal/allowed_ips` lo sostituisce con una sola chiamata (serve una credenziale del portale).

Per dare a una singola chiave un suo elenco, indicalo quando la crei con una credenziale del portale:

```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"]}'
```

Un `allowed_ips` per chiave sostituisce, per quella chiave, l’elenco ereditato dall’account. La risposta contiene la chiave in chiaro una sola volta: salvala subito.

## Revoca in fretta una chiave esposta

`DELETE /portal/keys/{alias}` revoca una chiave a consumo, e `DELETE /portal/keys/hourly/{alias}` revoca una chiave oraria (l’addebito dell’acquisto originale resta). Dopo una revoca o una modifica all’allowlist, le nuove richieste si fermano entro cinque secondi.

```bash
curl -X DELETE https://inference.broadnet.ai/portal/keys/$KEY_ALIAS \
  -H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL"
```

Imposta `KEY_ALIAS` con l’alias mostrato per la chiave nella pagina dell’account o in `GET /portal/keys`. L’alias non è la chiave segreta. Se viene esposta una credenziale del portale, revocala con `DELETE /portal/credentials/{id}`: può fare tutto ciò che può fare il tuo account.

## Risoluzione dei problemi

-   **403 da un server che hai inserito nell’elenco.** L’edge vede il tuo indirizzo pubblico in uscita, non l’IP privato del server. I server dietro un NAT gateway, un proxy o un load balancer escono con l’indirizzo di quel dispositivo. Un server con IPv6 può uscire in IPv6 anche se hai inserito solo il suo indirizzo IPv4. Inserisci l’indirizzo da cui la richiesta esce davvero, o un intervallo CIDR che lo includa.
-   **Una nuova chiave ignora l’elenco dell’account.** Un array `allowed_ips` per chiave sostituisce, per quella chiave, l’elenco ereditato dall’account. Controlla cosa hai passato alla creazione.
-   **409 `key_limit_reached`.** L’account ha già dieci chiavi attive. Revocane una che non usi più.
-   **Le richieste riescono ancora qualche secondo dopo la revoca.** È normale per un massimo di cinque secondi, mentre la cache si aggiorna.

Una richiesta da un indirizzo che non è nell’elenco riceve un 403. Vedi [tutti i codici di errore di BroadNet e quando ritentare](https://broadrouter.com/it/guides/errors-and-retries/). Per fare la prima richiesta con una nuova chiave, segui [la guida all’SDK Python di OpenAI](https://broadrouter.com/it/guides/openai-python-sdk/). La [voce del glossario sull’allowlist di IP](https://broadrouter.com/it/glossary/ip-allow-list/) spiega il concetto in termini generali.

_[image: A metal key whose bow is shaped like curly braces { }, with the text "One API key. More possibilities."]_

## Termini in questa guida

[Chiave API (API key)](https://broadrouter.com/it/glossary/api-key/)

Una chiave API è una stringa segreta che identifica e autorizza un client che chiama un’API. Le API LLM di solito la vogliono in un header Authorization: Bearer, e chiunque possieda la chiave può fare richieste fatturate all’account a cui appartiene.

[Pagamento a consumo (pay-as-you-go)](https://broadrouter.com/it/glossary/pay-as-you-go/)

Il pagamento a consumo è un modello di prezzo in cui paghi solo ciò che usi, misurato per unità come token, richieste o minuti di audio, senza abbonamento né impegno minimo. La maggior parte delle API LLM fattura così, da un saldo prepagato o con una fattura periodica.

[IP allow list (whitelist di IP)](https://broadrouter.com/it/glossary/ip-allow-list/)

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.

[Tool calling (chiamata di strumenti)](https://broadrouter.com/it/glossary/tool-calling/)

Il tool calling, detto anche function calling, è una funzionalità delle API LLM in cui il modello restituisce una richiesta strutturata di eseguire una funzione definita dallo sviluppatore, con argomenti JSON. L’applicazione esegue la funzione e rimanda il risultato; il modello non esegue mai codice da solo.

## Domande frequenti

### Come limito una chiave API LLM all’indirizzo IP del mio server?

Aggiungi l’indirizzo pubblico in uscita del server, o un intervallo CIDR, all’allowlist dell’account nella pagina dell’account BroadNet, oppure passa allowed\_ips quando crei la chiave con POST /portal/keys. Le richieste da qualsiasi altro indirizzo vengono rifiutate con un 403.

### Un’allowlist vuota blocca tutto?

No. Un elenco vuoto significa nessuna restrizione per IP, quindi la chiave funziona da qualsiasi indirizzo. Aggiungi almeno una voce per attivare la restrizione.

### Posso usare una chiave di inferenza per creare altre chiavi?

No. Le chiavi di inferenza chiamano solo le route dei modelli /v1/\*. Per creare e revocare chiavi, cambiare gli IP consentiti e acquistare chiavi orarie serve una credenziale del portale, che ha pieni poteri sull’account.

### Quanto è rapida la revoca di una chiave esposta?

Secondo la documentazione di BroadNet, le nuove richieste si fermano entro cinque secondi da una revoca o da una modifica all’allowlist, perché le decisioni di autorizzazione possono restare per tanto così in una cache replicata.

## Guide correlate

-   [Codici di errore di BroadNet Inference e quando ritentare](https://broadrouter.com/it/guides/errors-and-retries/)
-   [Usare l’SDK Python di OpenAI con BroadNet Inference](https://broadrouter.com/it/guides/openai-python-sdk/)

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-guides-api-keys-ip-allow-lists&utm_content=page-cta) ·

**Fonti**

-   [Riferimento API di BroadNet Inference, allowlist di IP (verificato il 2026-11-16) (in inglese)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-guides-api-keys-ip-allow-lists&utm_content=sources#ip-allow-lists)
-   [Riferimento API di BroadNet Inference, chiavi orarie e credenziali del portale (verificato il 2026-11-16) (in inglese)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-guides-api-keys-ip-allow-lists&utm_content=sources#hourly-keys)
-   [Riferimento API di BroadNet Inference, limiti (durata delle chiavi e chiavi attive) (verificato il 2026-11-16) (in inglese)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-guides-api-keys-ip-allow-lists&utm_content=sources#limits)
