Una chiave API funziona come una password per un programma. È anche un’autorizzazione a spendere: chi la possiede può usare il tuo saldo.
Come funziona
Le API LLM trattano la chiave come un bearer token. Il client la invia a ogni richiesta:
curl https://inference.broadnet.ai/v1/models \
-H "Authorization: Bearer $BROADNET_API_KEY"
La RFC 6750 definisce bearer token un token che “any party in possession of the token” (traduzione: chiunque sia in possesso del token) può usare. Non c’è un secondo fattore. Per questo la stessa RFC dice che i client devono inviare i bearer token sempre su TLS (https://).
Il provider cerca la chiave, trova l’account, controlla limiti e policy, e poi serve o rifiuta la richiesta. Una chiave mancante o sbagliata di solito restituisce 401; una chiave rifiutata da una policy, come una allowlist di IP, di solito restituisce 403.
Perché è importante
Una chiave trapelata è uno dei modi più comuni in cui la spesa di un’API va fuori controllo, perché dei bot scandagliano il codice pubblico in cerca di segreti. Può anche esporre dati se la chiave raggiunge endpoint che restituiscono dettagli dell’account. Le buone pratiche, in linea con le indicazioni OWASP sui segreti:
- Carica le chiavi da variabili d’ambiente o da un secrets manager. Non metterle mai in un commit né dentro le immagini dei container.
- Dai a ogni app o agente la sua chiave, così puoi revocarne una senza fermare tutto.
- Ruota le chiavi a intervalli regolari e subito dopo ogni sospetta fuga.
- Limita dove funziona una chiave, per esempio con una allowlist degli IP dei server.
Su BroadNet Inference
BroadNet separa due credenziali. Una chiave di inferenza chiama i modelli su /v1/*. Una credenziale del portale automatizza l’account: chiavi, IP consentiti e acquisti. Considera la seconda come un’autorità piena sull’account.
Entrambe vengono mostrate una sola volta. BroadNet conserva solo un hash SHA-256, quindi non può mostrarti di nuovo la chiave. Una chiave a consumo dura un anno, e un account può avere fino a dieci chiavi attive. Ogni chiave può avere la sua lista di IP consentiti. Dopo una revoca o una modifica della allowlist, le nuove richieste si fermano entro cinque secondi.
Le chiavi dei piani flat sono separate e non scalano mai il tuo saldo. I passaggi di configurazione sono in chiavi API e allowlist di IP, e i codici di stato in errori e retry.
Errori comuni
- Registrare nei log gli header completi delle richieste. Così la chiave finisce nei log.
- Condividere una sola chiave in tutto il team. Perdi la possibilità di revocare l’accesso a una singola persona.
- Inviare la chiave all’assistenza. Invia invece il valore dell’header
X-Request-ID.