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

