Panoramica
L’elenco degli IP consentiti è una funzionalità di sicurezza facoltativa che permette di limitare gli indirizzi IP da cui è possibile accedere alla tua API OpenAI.
Quando è abilitato, vengono consentite solo le richieste provenienti dagli indirizzi IP o dagli intervalli IP configurati. Le richieste provenienti da tutti gli altri IP vengono rifiutate, anche se includono una chiave API valida.
Questa funzionalità contribuisce a ridurre il rischio di utilizzo non autorizzato dell’API limitando l’accesso agli ambienti di rete attendibili.
Nota: l’elenco degli IP consentiti si applica solo alle richieste API. Non influisce sull’accesso a platform.openai.com né sull’autenticazione degli utenti.
Perché usare un elenco degli IP consentiti
L’elenco degli IP consentiti può aiutarti a:
Limitare l’accesso all’API alle infrastrutture note (ad esempio, i tuoi server o ambienti cloud)
Ridurre l’esposizione al rischio in caso di divulgazione di una chiave API
Aggiungere un ulteriore livello di controllo sulla provenienza del traffico API
L’elenco degli IP consentiti viene utilizzato soprattutto negli ambienti di produzione in cui il traffico API proviene da intervalli di rete fissi o ben definiti.
Come funziona
Configura un elenco di indirizzi IP o intervalli CIDR consentiti.
Le richieste provenienti dagli IP consentiti vengono accettate.
Le richieste provenienti da IP non presenti nell’elenco vengono rifiutate.
L’elenco degli IP consentiti può essere applicato:
A livello di organizzazione, oppure
A livello di progetto
Disponibilità
L’elenco degli IP consentiti è disponibile per tutti i clienti API.
Per configurare l’elenco degli IP consentiti, segui i passaggi riportati di seguito.
Configurare l’elenco degli IP consentiti
Nota: puoi aggiungere fino a 50 indirizzi IP o intervalli CIDR.
Apri Impostazioni.
Seleziona Sicurezza.
Seleziona Elenco degli IP consentiti.
Aggiungi uno o più indirizzi IP o intervalli CIDR.
(Facoltativo) Usa lo strumento Verifica per controllare se un IP è incluso nell’elenco degli IP consentiti.
Abilita l’elenco degli IP consentiti per:
Un progetto specifico, oppure
L’intera organizzazione.
Esegui richieste di prova dagli ambienti che prevedi di utilizzare.
Ti consigliamo di iniziare con un singolo progetto prima di applicare la restrizione all’intera organizzazione.
Le modifiche possono richiedere fino a 15 minuti per diventare effettive.
Nota: per configurare le impostazioni dell’elenco degli IP consentiti, devi disporre delle autorizzazioni appropriate nell’organizzazione.
Risoluzione dei problemi
Se le richieste non vanno a buon fine in modo imprevisto:
Verifica che la richiesta provenga da un indirizzo IP consentito.
Controlla se gli IP della tua infrastruttura sono cambiati.
Verifica che gli intervalli IP configurati siano corretti.
Attendi fino a 15 minuti per la propagazione delle modifiche alla configurazione.
Usa lo strumento Verifica per controllare se un IP è consentito.
Cosa succede quando una richiesta viene bloccata
Se una richiesta proviene da un indirizzo IP non presente nell’elenco degli IP consentiti, non andrà a buon fine e restituirà:
Stato HTTP: 401 Unauthorized
Codice di errore: ip_not_authorized
Esempio di risposta:
{
"error": {
"message": "Your IP is not authorized to access this organization.",
"type": "ip_not_authorized"
}
}
Domande frequenti
L’elenco degli IP consentiti impedisce qualsiasi utilizzo non autorizzato della mia chiave API?
No. L’elenco degli IP consentiti può contribuire a ridurre il rischio limitando la provenienza delle richieste API, ma non impedisce completamente ogni forma di uso improprio. Va utilizzato insieme ad altre buone pratiche di sicurezza, come l’archiviazione sicura delle chiavi, la loro rotazione e una solida protezione dell’account. Per una maggiore sicurezza, consulta le guide del nostro centro assistenza sulle buone pratiche per la sicurezza delle chiavi API e sulla prevenzione dell’utilizzo non autorizzato.
L’elenco degli IP consentiti influisce sulla latenza?
L’elenco degli IP consentiti può introdurre una latenza minima in alcuni casi, in genere nelle richieste iniziali. Non si prevede un impatto significativo sulle prestazioni complessive dell’API.
Come posso sapere se una richiesta non va a buon fine a causa dell’elenco degli IP consentiti?
Le richieste che non vanno a buon fine a causa dell’elenco degli IP consentiti restituiscono:
HTTP status: 401 UnauthorizedError code: ip_not_authorized