Vue d’ensemble
La liste d’adresses IP autorisées est une fonctionnalité de sécurité facultative qui vous permet de restreindre les adresses IP pouvant accéder à votre API OpenAI.
Lorsqu’elle est activée, seules les requêtes provenant des adresses IP ou des plages d’adresses IP configurées sont autorisées. Les requêtes provenant de toute autre adresse IP sont rejetées, même si elles incluent une clé API valide.
Cette fonctionnalité vise à réduire le risque d’utilisation non autorisée de l’API en limitant l’accès aux environnements réseau de confiance.
Remarque : La liste d’adresses IP autorisées s’applique uniquement aux requêtes API. Elle n’a aucune incidence sur l’accès à platform.openai.com ni sur la connexion des utilisateurs.
Pourquoi utiliser une liste d’adresses IP autorisées
La liste d’adresses IP autorisées peut vous aider à :
Limiter l’accès à l’API aux infrastructures connues (par exemple, vos serveurs ou vos environnements infonuagiques)
Réduire l’exposition en cas de fuite d’une clé API
Ajouter un niveau de contrôle supplémentaire sur la provenance du trafic API
La liste d’adresses IP autorisées est surtout utilisée dans les environnements de production où le trafic API provient de plages réseau fixes ou bien définies.
Fonctionnement
Vous configurez une liste d’adresses IP ou de plages CIDR autorisées.
Les requêtes provenant d’adresses IP autorisées sont acceptées.
Les requêtes provenant d’adresses IP absentes de la liste d’adresses autorisées sont rejetées.
La liste d’adresses IP autorisées peut s’appliquer :
À l’échelle de l’organisation, ou
À l’échelle du projet
Disponibilité
La liste d’adresses IP autorisées est offerte à tous les clients de l’API.
Pour configurer la liste d’adresses IP autorisées, suivez les étapes ci-dessous.
Configurer la liste d’adresses IP autorisées
Remarque : Vous pouvez ajouter jusqu’à 50 adresses IP ou plages CIDR.
Ouvrez les Paramètres.
Sélectionnez Sécurité.
Sélectionnez Liste d’adresses IP autorisées.
Ajoutez une ou plusieurs adresses IP ou plages CIDR.
(Facultatif) Utilisez l’outil Vérifier pour confirmer qu’une adresse IP figure dans votre liste d’adresses autorisées.
Activez la liste d’adresses autorisées pour :
Un projet précis, ou
L’ensemble de votre organisation.
Testez les requêtes à partir des environnements prévus.
Nous recommandons de commencer par un seul projet avant d’appliquer cette restriction à l’ensemble de l’organisation.
Une fois les modifications effectuées, les mises à jour peuvent prendre jusqu’à 15 minutes pour entrer en vigueur.
Remarque : Vous devez disposer des autorisations appropriées au sein de l’organisation pour configurer les paramètres de la liste d’adresses IP autorisées.
Dépannage
Si vos requêtes échouent de façon inattendue :
Confirmez que la requête provient d’une adresse IP autorisée.
Vérifiez si les adresses IP de votre infrastructure ont changé.
Vérifiez l’exactitude des plages d’adresses IP configurées.
Prévoyez jusqu’à 15 minutes pour la propagation des modifications de configuration.
Utilisez l’outil Vérifier pour confirmer qu’une adresse IP est autorisée.
Que se passe-t-il lorsqu’une requête est bloquée
Si une requête provient d’une adresse IP qui ne figure pas dans la liste d’adresses autorisées, elle échoue et renvoie :
Statut HTTP : 401 Unauthorized
Code d’erreur : ip_not_authorized
Exemple de réponse :
{
"error": {
"message": "Your IP is not authorized to access this organization.",
"type": "ip_not_authorized"
}
}
FAQ
La liste d’adresses IP autorisées empêche-t-elle toute utilisation non autorisée de ma clé API?
Non. La liste d’adresses IP autorisées peut réduire les risques en limitant la provenance des requêtes API, mais elle n’empêche pas entièrement toutes les formes d’utilisation abusive. Elle doit être utilisée avec d’autres pratiques exemplaires de sécurité, comme le stockage sécurisé des clés, la rotation des clés et une sécurité renforcée des comptes. Pour renforcer la sécurité, consultez nos guides du centre d’aide sur les pratiques exemplaires pour la sécurité des clés API et la prévention de l’utilisation non autorisée.
La liste d’adresses IP autorisées a-t-elle une incidence sur la latence?
La liste d’adresses IP autorisées peut entraîner une latence minime dans certains cas, généralement lors des premières requêtes. Elle ne devrait pas avoir d’incidence importante sur les performances globales de l’API.
Comment savoir si une requête échoue à cause de la liste d’adresses IP autorisées?
Les requêtes qui échouent à cause de la liste d’adresses IP autorisées renvoient :
Statut HTTP : 401 UnauthorizedCode d’erreur : ip_not_authorized