BroadRouter
Inizia

Chiavi API LLM sicure: conservazione, rotazione e IP consentiti

A cura del team di BroadNet Inference · 6 min di lettura · Pubblicato · Aggiornato

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.

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:

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

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.

Leggi in MarkdownChiedi a ChatGPTChiedi a ClaudeChiedi a Perplexity