Présentation

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 à une infrastructure connue (par exemple, vos serveurs ou vos environnements cloud)

• Réduire les risques en cas de fuite d’une clé API

• Ajouter un niveau de contrôle supplémentaire sur l’origine 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 sont rejetées.

La liste d’adresses IP autorisées peut s’appliquer :

• Au niveau de l’organisation, ou

• Au niveau du projet

Disponibilité

La liste d’adresses IP autorisées est disponible pour 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.

1. Ouvrez les Paramètres.

2. Sélectionnez Sécurité.

3. Sélectionnez Liste d’adresses IP autorisées.

4. Ajoutez une ou plusieurs adresses IP ou plages CIDR.

5. (Facultatif) Utilisez l’outil Vérifier pour vérifier si une adresse IP figure dans votre liste d’adresses autorisées.

6. Activez la liste d’adresses IP autorisées pour :

   • Un projet spécifique, ou

   • L’ensemble de votre organisation.

7. Testez les requêtes depuis les environnements prévus.

Nous vous recommandons de commencer par un seul projet avant d’appliquer ce filtrage à toute l’organisation.

Une fois les modifications effectuées, leur prise en compte peut prendre jusqu’à 15 minutes.


Remarque : vous devez disposer des autorisations appropriées au sein de l’organisation pour configurer la liste d’adresses IP autorisées.

Dépannage

Si vos requêtes échouent de manière inattendue :

• Vérifiez 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 vérifier si 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 contribuer à réduire les risques en limitant l’origine des requêtes API, mais elle n’empêche pas toutes les formes d’utilisation abusive. Elle doit être utilisée en complément d’autres bonnes pratiques de sécurité, comme le stockage sécurisé des clés, leur rotation et une sécurité renforcée des comptes. Pour renforcer votre sécurité, consultez les guides de notre centre d’aide sur les bonnes pratiques de sécurité des clés API et la prévention des utilisations non autorisées.

La liste d’adresses IP autorisées a-t-elle une incidence sur la latence ?

La liste d’adresses IP autorisées peut introduire une latence minime dans certains cas, généralement lors des premières requêtes. Elle ne devrait pas affecter de manière significative 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 :

• HTTP status: 401 Unauthorized

• Error code: ip_not_authorized