---
title: "Sicurezza chiavi API LLM: variabili, rotazione, IP | BroadRouter"
description: "Chiavi API LLM fuori da codice e log, una chiave per ogni carico di lavoro, rotazione regolare, solo gli IP dei tuoi server e revoca di una fuga in pochi secondi."
url: https://broadrouter.com/it/blog/llm-api-key-security/
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/blog/llm-api-key-security/) (aggiornato il 2026-11-15).

# Chiavi API LLM sicure: conservazione, rotazione e IP consentiti

A cura del team di BroadNet Inference · 6 min di lettura · Pubblicato 2026-11-14 · Aggiornato 2026-11-15

Conserva le chiavi API LLM in un secret manager, mai nel codice o nel browser. Dai a ogni app o agente la propria chiave, ruotala a scadenza fissa e legala ai tuoi server con un elenco di IP consentiti. BroadNet Inference indica che i suoi elenchi accettano 32 voci, che la revoca blocca le nuove richieste entro cinque secondi e che le chiavi durano un anno.

## Punti chiave

-   Non distribuire mai una chiave in un browser o in un’app mobile: chiama l’LLM dal tuo server.
-   Una chiave per ogni carico di lavoro: con fino a 10 chiavi attive per account BroadNet, una fuga si isola facilmente.
-   Gli elenchi di IP consentiti impediscono a una chiave rubata di funzionare altrove. BroadNet accetta fino a 32 voci IPv4, IPv6 o CIDR.
-   Su BroadNet Inference la revoca e le modifiche all’elenco degli IP consentiti hanno effetto entro cinque secondi.
-   Le chiavi scadono un anno dopo la creazione, quindi la rotazione deve essere una routine, non un’emergenza.

**In questa pagina**

1.  Dove conservare una chiave API LLM?
2.  Si può mettere una chiave API in un browser o in un’app mobile?
3.  Perché dare a ogni carico di lavoro la sua chiave?
4.  Come proteggono una chiave gli elenchi di IP consentiti?
5.  Perché separare le chiavi di inferenza dalle credenziali di amministrazione?
6.  Ogni quanto ruotare le chiavi API?
7.  Cosa fare quando una chiave finisce online?
8.  Come finiscono le chiavi nei log?
9.  Come limitare i danni di una fuga che non hai ancora scoperto?
10.  Quali controlli sulle chiavi offre BroadNet Inference?

Per proteggere una chiave API LLM, conservala in un secret manager e chiama il modello solo dal tuo server, mai da un browser o da un’app. Dai a ogni carico di lavoro la propria chiave, ruota le chiavi a scadenza fissa, legale agli IP dei tuoi server con un elenco di IP consentiti e, se una chiave finisce online, prima revocala e poi indaga.

Questo articolo raccoglie le abitudini che tengono al sicuro le chiavi, con i controlli specifici che offre BroadNet Inference. Per i passaggi nel portale, clic per clic, vedi la [guida a chiavi API e IP consentiti](https://broadrouter.com/it/guides/api-keys-ip-allow-lists/); per budget e protezione dai loop fuori controllo, vedi [controllare la spesa delle API LLM](https://broadrouter.com/it/blog/llm-api-spend-control/).

## Dove conservare una chiave API LLM?

Conserva le chiavi in un secret manager o nei secret cifrati della tua piattaforma, mai nel codice. L’[OWASP Secrets Management Cheat Sheet](https://cheatsheetseries.owasp.org/cheatsheets/Secrets_Management_Cheat_Sheet.html) tratta le opzioni in dettaglio. Tieni presente la sua avvertenza: le variabili d’ambiente «are generally accessible to all processes and may be included in logs or system dumps» (traduzione: sono in genere accessibili a tutti i processi e possono finire nei log o nei dump di sistema), quindi OWASP preferisce, quando puoi scegliere, file di secret montati o il recupero dei secret da un secret store. Una variabile d’ambiente valorizzata da un secret manager all’avvio è la via di mezzo più diffusa.

```python
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],  # fails loudly if missing
)
```

Usa `os.environ[...]`, non `os.getenv(...)` con un valore di riserva scritto nel codice: è proprio così che le chiavi finiscono in Git. Per lo sviluppo locale un file `.env` va bene, purché sia in `.gitignore` fin dal primo commit. Attiva il secret scanning e la push protection del tuo host Git. Su GitHub, la [push protection](https://docs.github.com/en/code-security/secret-scanning/introduction/about-push-protection) blocca i push che contengono formati di secret noti prima che arrivino al repository; la push protection per gli utenti è attiva per impostazione predefinita, ma quella a livello di repository è disattivata per impostazione predefinita e deve attivarla un amministratore del repository o un owner dell’organizzazione.

## Si può mettere una chiave API in un browser o in un’app mobile?

No. Tutto ciò che distribuisci a un client può essere estratto. Il codice front-end e i bundle delle app sono pubblici, per quanto minificati od offuscati. Chiama l’LLM dal tuo server, autentica lì i tuoi utenti e applica i tuoi limiti per utente prima di inoltrare la richiesta.

Lo stesso vale per gli strumenti desktop che dai ad altri. Se un collega deve usare un agente di coding, dagli una chiave sua sul suo account invece di condividerne una.

## Perché dare a ogni carico di lavoro la sua chiave?

Su BroadNet Inference un account può avere **fino a dieci chiavi attive**. Usale:

| Etichetta della chiave | Usata da |
| --- | --- |
| `prod-api` | Backend di produzione |
| `prod-worker` | Job batch |
| `staging` | Ambiente di staging |
| `agent-ci` | Agente di coding nella CI |
| `dev-laptop-<name>` | Sviluppo locale |

Quando una chiave finisce online revochi solo quella, e le altre continuano a funzionare. Le etichette rendono leggibile anche l’utilizzo: vedi quale carico di lavoro spende quanto. Dai alle chiavi il nome di ciò che le usa, non di chi le ha create.

## Come proteggono una chiave gli elenchi di IP consentiti?

Con un [elenco di IP consentiti](https://broadrouter.com/it/glossary/ip-allow-list/), una chiave rubata non funziona da nessuna parte tranne che sulla tua infrastruttura. Su BroadNet Inference:

-   L’elenco dell’account accetta **fino a 32 voci**, un indirizzo IPv4 o IPv6 o un intervallo CIDR per riga.
-   Un elenco vuoto significa nessuna restrizione.
-   Le nuove chiavi ereditano l’elenco dell’account, a meno che tu non crei una chiave con i suoi `allowed_ips`, che per quella chiave sostituiscono l’elenco ereditato.
-   Una richiesta da un indirizzo fuori elenco viene rifiutata con un 403 («refused by model, route or IP policy»; traduzione: rifiutata dalla policy su modello, route o IP).

Crea una chiave con il suo elenco tramite l’API 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":"prod-worker","allowed_ips":["203.0.113.7","198.51.100.0/24"]}'
```

La risposta contiene la chiave in chiaro una sola volta. Salvala subito nel tuo secret manager: non si può rileggere. I passaggi completi sono nella [guida agli IP consentiti](https://broadrouter.com/it/guides/api-keys-ip-allow-lists/).

Gli elenchi di IP consentiti sono adatti ai server con IP di uscita stabili: una VPS, un NAT gateway, un IP fisso d’ufficio. Per i portatili che cambiano rete, usa una chiave separata senza elenco e tieni bassa l’esposizione del saldo.

## Perché separare le chiavi di inferenza dalle credenziali di amministrazione?

BroadNet usa due tipi di credenziale:

| Credenziale | Cosa può fare | Dove conservarla |
| --- | --- | --- |
| Chiave di inferenza | Richieste ai modelli su `/v1/*` | Dove gira l’app |
| Credenziale del portale | Creare e revocare chiavi, cambiare gli IP consentiti, fare acquisti | Solo nei tuoi strumenti di automazione o di amministrazione |

La documentazione dice di trattare ogni credenziale del portale come pieno controllo dell’account. Non distribuire mai una credenziale del portale accanto alla tua applicazione. Se il server dell’app viene compromesso, l’attaccante deve ottenere una chiave di inferenza, non il controllo dell’account.

## Ogni quanto ruotare le chiavi API?

OWASP raccomanda una rotazione regolare «so that any stolen credentials will only work for a short time» (traduzione: così che eventuali credenziali rubate funzionino solo per poco tempo). Le chiavi BroadNet durano **un anno** dalla creazione, quindi ogni chiave andrà comunque sostituita. Fai della rotazione una routine:

1.  Crea una nuova chiave con lo stesso schema di etichetta e lo stesso elenco di IP consentiti.
2.  Distribuiscila accanto alla vecchia, oppure cambia il secret e riavvia.
3.  Controlla che il traffico passi alla nuova chiave.
4.  Revoca la vecchia chiave con `DELETE /portal/keys/{alias}`.

Dato che un account può avere fino a dieci chiavi attive, puoi tenere vecchia e nuova in parallelo per qualche minuto senza interruzioni. Anticipa la rotazione per le chiavi a cui aveva accesso un membro del team che se ne va.

## Cosa fare quando una chiave finisce online?

Quando una chiave finisce online, prima revocala e poi indaga. Su BroadNet Inference le nuove richieste si fermano **entro cinque secondi** da una revoca o da una modifica all’elenco degli IP consentiti; la documentazione spiega che le decisioni di autorizzazione possono restare in una cache replicata per quell’intervallo limitato.

Dopo la revoca:

-   controlla l’utilizzo della chiave nella pagina dell’account o con `GET /portal/usage`;
-   scopri come è uscita (storico dei commit, log della CI, uno screenshot condiviso);
-   ruota gli altri secret conservati nello stesso posto.

Una chiave revocata o bloccata restituisce 401 o 403; vedi la [guida agli errori](https://broadrouter.com/it/guides/errors-and-retries/) perché il tuo monitoraggio non li tratti come errori transitori.

## Come finiscono le chiavi nei log?

Nei log una fuga sfugge facilmente. Oscura l’header `Authorization` nel logging di debug HTTP, negli strumenti di segnalazione degli errori e nei log di accesso dei proxy. Quando contatti l’assistenza, invia `X-Request-ID`, orario, route, stato e l’**alias** della chiave, mai la chiave stessa. Secondo la documentazione di BroadNet il portale conserva solo un hash di ogni chiave, quindi non può nemmeno mostrarti una chiave persa.

## Come limitare i danni di una fuga che non hai ancora scoperto?

Anche con tutte le abitudini qui sopra, metti in conto che una chiave possa uscire, un giorno. Riduci il raggio d’azione:

-   Tieni il saldo a consumo a un livello che saresti disposto a perdere, e ricarica quando serve.
-   Usa un piano flat per gli agenti più pesanti: una sessione di un piano ha un prezzo fisso, quindi una chiave di piano rubata non può gonfiare una fattura a token. Vedi [cosa significa davvero «illimitato»](https://broadrouter.com/it/blog/what-unlimited-llm-api-really-means/).
-   Imposta avvisi su spesa o frequenza di richieste insolite per chiave; il [calcolatore dei costi delle API LLM](https://broadrouter.com/tools/llm-api-cost-calculator/) ti dà una cifra mensile normale su cui tarare gli avvisi. Il nostro articolo su [come controllare la spesa delle API LLM](https://broadrouter.com/it/blog/llm-api-spend-control/) tratta budget e avvisi.

## Quali controlli sulle chiavi offre BroadNet Inference?

| Controllo | BroadNet Inference |
| --- | --- |
| Chiave mostrata una volta, conservata come hash | Sì |
| Chiavi attive per account | Fino a 10 |
| Durata della chiave | Un anno |
| Elenco di IP consentiti | Fino a 32 voci IPv4, IPv6 o CIDR |
| Elenco di IP consentiti per chiave | Sì, `allowed_ips` alla creazione |
| La revoca ha effetto | Entro cinque secondi |
| Credenziale di amministrazione separata | Credenziale del portale |

Le chiavi proteggono il tuo account; la [zero data retention](https://broadrouter.com/it/privacy/) protegge ciò che ci fai passare. Leggi entrambe le cose prima di andare in produzione.

Strumenti gratuiti sul tema (in inglese)

-   [OpenAI to BroadNet migration helper](https://broadrouter.com/tools/openai-to-broadnet-migration/) Paste OpenAI SDK code; get base URL, key and model edits, a diff and the checks that remain.
-   [max\_tokens calculator for reasoning models](https://broadrouter.com/tools/reasoning-token-budget/) Answer length + reasoning budget + margin = a max\_tokens that does not cut the answer off.
-   [JSON schema generator for LLM structured output](https://broadrouter.com/tools/json-schema-generator/) Sample JSON to strict schema, Pydantic, Zod and a ready request.
-   [LLM JSON output validator](https://broadrouter.com/tools/llm-json-output-validator/) Parse errors by line and column, safe repairs, cut-off detection and JSON Schema checks for model output.

[Strumenti gratuiti (in inglese)](https://broadrouter.com/tools/)

## Termini in questo articolo

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

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

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

[Agente di coding AI (AI coding agent)](https://broadrouter.com/it/glossary/coding-agent/)

Un agente di coding AI è uno strumento software in cui un modello linguistico lavora su una codebase in un ciclo: legge file, li modifica, esegue comandi come i test, legge l’output e decide il passo successivo finché il compito è finito o si raggiunge un limite.

[Token](https://broadrouter.com/it/glossary/token/)

Un token è l’unità di testo che un modello linguistico legge e scrive: una parola, una parte di parola, un segno di punteggiatura o una sequenza di byte prodotta dal tokenizer del modello. Le API LLM contano, limitano e di solito fatturano l’uso in token.

[Zero data retention (nessuna conservazione dei dati)](https://broadrouter.com/it/glossary/zero-data-retention/)

La zero data retention (ZDR) è una policy di gestione dei dati in cui un provider AI elabora prompt e output solo per servire una richiesta e poi non ne conserva il contenuto, né in log né in cache né in dati di addestramento. Di solito restano registri senza contenuti, come conteggi di token e tempi.

[Credito prepagato (prepaid credit)](https://broadrouter.com/it/glossary/prepaid-credit/)

Il credito prepagato è denaro aggiunto a un account API prima dell’uso. Ogni richiesta scala il proprio costo dal saldo e, quando il saldo si esaurisce, le richieste a consumo si fermano finché non ricarichi. Limita la spesa a quanto hai versato.

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

## Domande frequenti

### Dove devo conservare una chiave API LLM?

In un secret manager o nei secret cifrati della tua piattaforma, iniettata nel processo come variabile d’ambiente, per esempio BROADNET\_API\_KEY. Non nel codice sorgente, non in un file .env committato e mai nel codice front-end.

### Quanto velocemente posso revocare una chiave BroadNet Inference?

Secondo la documentazione di BroadNet, le nuove richieste si fermano entro cinque secondi da una revoca o da una modifica all’elenco degli IP consentiti, perché le decisioni di autorizzazione possono restare in una cache replicata per quell’intervallo limitato.

### Quanto dura una chiave BroadNet Inference?

Una chiave a consumo dura un anno dalla creazione. Un account può avere fino a dieci chiavi attive, quindi puoi creare la sostituta prima che la vecchia scada.

### BroadNet può mostrarmi di nuovo una chiave se la perdo?

No. Secondo la documentazione di BroadNet la chiave in chiaro viene restituita una sola volta e il portale ne conserva solo l’hash. Crea una nuova chiave e revoca la vecchia.

### Cosa devo fare se la mia chiave API compatibile con OpenAI è finita online?

Prima revocala, poi indaga. Controlla l’utilizzo della chiave per individuare traffico sconosciuto, scopri da dove è uscita (storico dei commit, log della CI, screenshot), ruota gli altri secret conservati nello stesso posto ed emetti una chiave sostitutiva con un elenco di IP consentiti.

## Continua a leggere

-   [Controllo della spesa API LLM: budget, limiti sulle chiavi e cicli](https://broadrouter.com/it/blog/llm-api-spend-control/)
-   [Dati sensibili e API LLM: oscura, minimizza, registra meno](https://broadrouter.com/it/blog/llm-api-sensitive-data/)
-   [Errore 429 nelle API LLM: backoff, jitter e limitatori](https://broadrouter.com/it/blog/handle-llm-api-429-rate-limits/)
-   [GDPR e API LLM: 15 domande da fare al tuo provider](https://broadrouter.com/it/blog/gdpr-llm-api-checklist/)
-   [Hardware GPU e serving di BroadNet, come li descrive BroadNet](https://broadrouter.com/it/blog/broadnet-gpu-fleet-and-serving/)
-   [Cache delle risposte delle API LLM: una cache esatta in Python](https://broadrouter.com/it/blog/cache-llm-responses-cut-cost/)
-   [Guida: 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: 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-blog-llm-api-key-security&utm_content=page-cta) ·

**Fonti**

-   [Riferimento API di BroadNet Inference, limiti: durata delle chiavi, chiavi attive (consultato il 2026-11-14) (in inglese)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-blog-llm-api-key-security&utm_content=sources#limits)
-   [Riferimento API di BroadNet Inference, IP consentiti e chiavi del portale (consultato il 2026-11-14) (in inglese)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-blog-llm-api-key-security&utm_content=sources#ip-allow-lists)
-   [OWASP Secrets Management Cheat Sheet (consultato il 2026-11-14)](https://cheatsheetseries.owasp.org/cheatsheets/Secrets_Management_Cheat_Sheet.html)
-   [GitHub Docs, secret scanning (consultata il 2026-11-14)](https://docs.github.com/en/code-security/secret-scanning/about-secret-scanning)
-   [GitHub Docs, la push protection (consultata il 2026-11-14)](https://docs.github.com/en/code-security/secret-scanning/introduction/about-push-protection)
