BroadRouter
Inizia

Chiave API (API key)

Aggiornato

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.

Detto anche: chiave API, API key, chiave segreta, token API, chiave di inferenza, API token, secret key, bearer token, inference key

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.

Domande frequenti

Posso mettere una chiave API LLM in un’app web o mobile?

No. Tutto ciò che arriva a un client può essere estratto. Tieni la chiave su un server e fai chiamare alla tua app il tuo server, che poi chiama l’API LLM.

Cosa devo fare se una chiave finisce in giro?

Revocala subito, creane una nuova e controlla l’uso nel periodo in cui era esposta. Poi scopri come è trapelata, per esempio da un commit, da una riga di log o da uno screenshot.

Quante chiavi posso avere su BroadNet Inference?

Fino a dieci chiavi a consumo attive per account. Ognuna dura un anno dalla creazione. Le chiavi dei piani sono separate.

Leggi in MarkdownChiedi a ChatGPTChiedi a ClaudeChiedi a Perplexity