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; per budget e protezione dai loop fuori controllo, vedi controllare la spesa delle API LLM.
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 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.
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 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, 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:
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.
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:
- Crea una nuova chiave con lo stesso schema di etichetta e lo stesso elenco di IP consentiti.
- Distribuiscila accanto alla vecchia, oppure cambia il secret e riavvia.
- Controlla che il traffico passi alla nuova chiave.
- 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 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».
- Imposta avvisi su spesa o frequenza di richieste insolite per chiave; il calcolatore dei costi delle API LLM ti dà una cifra mensile normale su cui tarare gli avvisi. Il nostro articolo su come controllare la spesa delle API LLM 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 protegge ciò che ci fai passare. Leggi entrambe le cose prima di andare in produzione.
