BroadRouter
Inizia

Limita le chiavi API ai tuoi server con le allowlist di IP

Aggiornato

Aggiungi all’allowlist dell’account gli indirizzi IPv4 o IPv6 in uscita dei tuoi server, o intervalli CIDR, fino a 32 voci. Le nuove chiavi ereditano l’elenco, a meno che tu non passi allowed_ips quando ne crei una. Le richieste da altri indirizzi ricevono un 403, e modifiche all’allowlist o revoche diventano effettive entro cinque secondi.

Una chiave esposta è il modo più comune in cui una fattura API va fuori controllo. BroadNet Inference ti dà due strumenti: un’allowlist di IP e una revoca rapida.

Due tipi di credenziale

Credenziale A cosa serve Trattala come
Chiave di inferenza Richieste ai modelli su /v1/* Un segreto per una sola app o un solo agente
Credenziale del portale Automazione dell’account: chiavi, IP consentiti, acquisti Pieni poteri sull’account

Entrambe vengono mostrate una sola volta. Il portale conserva solo un hash SHA-256, quindi non può mostrarti di nuovo la chiave. Una chiave di inferenza a consumo dura un anno dalla creazione, e un account può avere fino a dieci chiavi attive.

Imposta un’allowlist

Nella pagina dell’account aggiungi un indirizzo IPv4 o IPv6 o un intervallo CIDR per riga, fino a 32 voci. Un elenco vuoto significa nessuna restrizione per IP. Le nuove chiavi ereditano questo elenco dell’account. A ogni richiesta API l’edge controlla l’IP del client riportato da Cloudflare.

Per gestire l’elenco dell’account da uno script, PUT /portal/allowed_ips lo sostituisce con una sola chiamata (serve una credenziale del portale).

Per dare a una singola chiave un suo elenco, indicalo quando la crei con una credenziale del portale:

curl -X POST https://inference.broadnet.ai/portal/keys \
  -H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL" \
  -H "Content-Type: application/json" \
  -d '{"label":"worker-1","allowed_ips":["203.0.113.7","198.51.100.0/24"]}'

Un allowed_ips per chiave sostituisce, per quella chiave, l’elenco ereditato dall’account. La risposta contiene la chiave in chiaro una sola volta: salvala subito.

Revoca in fretta una chiave esposta

DELETE /portal/keys/{alias} revoca una chiave a consumo, e DELETE /portal/keys/hourly/{alias} revoca una chiave oraria (l’addebito dell’acquisto originale resta). Dopo una revoca o una modifica all’allowlist, le nuove richieste si fermano entro cinque secondi.

curl -X DELETE https://inference.broadnet.ai/portal/keys/$KEY_ALIAS \
  -H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL"

Imposta KEY_ALIAS con l’alias mostrato per la chiave nella pagina dell’account o in GET /portal/keys. L’alias non è la chiave segreta. Se viene esposta una credenziale del portale, revocala con DELETE /portal/credentials/{id}: può fare tutto ciò che può fare il tuo account.

Risoluzione dei problemi

  • 403 da un server che hai inserito nell’elenco. L’edge vede il tuo indirizzo pubblico in uscita, non l’IP privato del server. I server dietro un NAT gateway, un proxy o un load balancer escono con l’indirizzo di quel dispositivo. Un server con IPv6 può uscire in IPv6 anche se hai inserito solo il suo indirizzo IPv4. Inserisci l’indirizzo da cui la richiesta esce davvero, o un intervallo CIDR che lo includa.
  • Una nuova chiave ignora l’elenco dell’account. Un array allowed_ips per chiave sostituisce, per quella chiave, l’elenco ereditato dall’account. Controlla cosa hai passato alla creazione.
  • 409 key_limit_reached. L’account ha già dieci chiavi attive. Revocane una che non usi più.
  • Le richieste riescono ancora qualche secondo dopo la revoca. È normale per un massimo di cinque secondi, mentre la cache si aggiorna.

Una richiesta da un indirizzo che non è nell’elenco riceve un 403. Vedi tutti i codici di errore di BroadNet e quando ritentare. Per fare la prima richiesta con una nuova chiave, segui la guida all’SDK Python di OpenAI. La voce del glossario sull’allowlist di IP spiega il concetto in termini generali.

A metal key whose bow is shaped like curly braces { }, with the text "One API key. More possibilities."

Domande frequenti

Come limito una chiave API LLM all’indirizzo IP del mio server?

Aggiungi l’indirizzo pubblico in uscita del server, o un intervallo CIDR, all’allowlist dell’account nella pagina dell’account BroadNet, oppure passa allowed_ips quando crei la chiave con POST /portal/keys. Le richieste da qualsiasi altro indirizzo vengono rifiutate con un 403.

Un’allowlist vuota blocca tutto?

No. Un elenco vuoto significa nessuna restrizione per IP, quindi la chiave funziona da qualsiasi indirizzo. Aggiungi almeno una voce per attivare la restrizione.

Posso usare una chiave di inferenza per creare altre chiavi?

No. Le chiavi di inferenza chiamano solo le route dei modelli /v1/*. Per creare e revocare chiavi, cambiare gli IP consentiti e acquistare chiavi orarie serve una credenziale del portale, che ha pieni poteri sull’account.

Quanto è rapida la revoca di una chiave esposta?

Secondo la documentazione di BroadNet, le nuove richieste si fermano entro cinque secondi da una revoca o da una modifica all’allowlist, perché le decisioni di autorizzazione possono restare per tanto così in una cache replicata.

Leggi in MarkdownChiedi a ChatGPTChiedi a ClaudeChiedi a Perplexity