Sécuriser les clés API OpenAI dans un flux de questions-réponses sur des documents
Un modèle pratique de sécurité pour répondre à des questions sur des documents avec OpenAI : séparer les identifiants, limiter les autorisations, expurger les journaux et renouveler les clés en toute sécurité tout en conservant l’attribution des sources.
Résumé · TL;DR
Dans une application de questions-réponses sur des documents, conservez les identifiants de l’application OpenAI dans un magasin de secrets fiable côté serveur, et non dans un navigateur, un environnement isolé, un fichier source ou un journal. Accordez à chaque charge de travail uniquement les accès nécessaires, expurgez les données sensibles des journaux et renouvelez les identifiants selon une procédure documentée de chevauchement puis de révocation. Joignez des références aux sources à chaque réponse afin que les utilisateurs puissent vérifier les affirmations dans les documents récupérés.
Points clés
- Gardez la clé de l’application OpenAI hors du code généré par un agent et des autres environnements d’exécution non fiables.
- Utilisez un projet ou une frontière dédiée à la charge de travail et n’accordez que les autorisations API nécessaires à l’application.
- Consignez les identifiants de requête, les durées et les identifiants des sources plutôt que les identifiants secrets, les extraits de documents ou les invites complètes.
- Joignez aux réponses les identifiants des documents et les références aux pages ou sections ; ne prenez pas une réponse fluide pour une preuve.
- Pour renouveler une clé, déployez un identifiant de remplacement, vérifiez le trafic, puis révoquez l’ancien ; en cas de suspicion d’exposition, révoquez-le immédiatement.
Sur cette page (6)
Un système de questions-réponses sur des documents doit remplir deux objectifs : répondre à partir des bons contenus et empêcher que ses identifiants se retrouvent dans le flux de traitement des documents. Par défaut, il est plus sûr de faire appeler OpenAI par un serveur d’application fiable, tout en intégrant explicitement la récupération et la gestion des citations à votre propre flux de travail. Ne placez pas la clé de l’application dans un navigateur, un document, une invite, un dépôt de code source ou un environnement isolé accessible à un agent.
Définir une frontière de confiance
Un flux courant se déroule ainsi : un utilisateur pose une question ; votre application récupère les passages pertinents dans un magasin de documents autorisé ; le serveur envoie la question et les passages sélectionnés à OpenAI ; l’application renvoie la réponse accompagnée de références à ces passages. La clé doit rester côté serveur, dans un magasin de secrets géré ou une configuration protégée équivalente, et non dans du code transmis à un utilisateur ou dans une charge de travail capable d’inspecter son environnement.
Les recommandations de sécurité d’OpenAI concernant les environnements isolés signalent que le code généré par un agent peut accéder aux fichiers, aux identifiants et aux ressources réseau disponibles dans son environnement. Elles recommandent des charges de travail isolées, des environnements distincts lorsque les données ne doivent pas être partagées, des projets OpenAI dédiés aux applications ou aux charges de travail et la conservation de la clé API de l’application hors de l’environnement. Elles précisent également qu’il ne faut pas intégrer les clés dans des images, du code source ou des journaux. Consultez les recommandations de sécurité d’OpenAI sur les environnements isolés.
Pour les questions-réponses sur des documents, cela signifie qu’il faut traiter les documents téléversés et le code généré par le modèle comme des entrées non fiables. Un processus de récupération ne doit recevoir que les documents et les outils nécessaires à sa tâche. Il ne doit pas hériter d’un identifiant d’application sans restriction simplement parce qu’il doit envoyer une question pour inférence.
Limiter les autorisations et séparer les identifiants
Créez un projet ou une frontière d’identifiants distincts pour cette application au lieu de partager une clé à usage général entre des charges de travail sans lien. Appliquez les autorisations les plus limitées disponibles pour les opérations API réellement utilisées par votre implémentation. Les recommandations d’OpenAI citées indiquent api.agents.read et api.agents.write pour les sessions, api.responses.write pour l’inférence, ainsi que api.vaults.read et api.vaults.write pour la gestion des coffres-forts. Ce sont des exemples correspondant aux cas d’utilisation documentés de l’Agents API ; n’accordez pas toutes les autorisations par défaut. Vérifiez celles qui sont nécessaires pour les API que vous appelez réellement.
Si un environnement d’exécution doit se connecter à OpenAI, le guide décrit l’utilisation d’une clé d’environnement distincte pour cette connexion. Il précise que cette clé permet de connecter des environnements et ne peut pas autoriser d’autres opérations API. Gardez-la séparée de la clé de l’application. Pour les services tiers, conservez les identifiants dans l’application ou auprès d’un proxy fiable ; n’injectez pas de secrets à longue durée de vie dans un environnement où le code généré peut les lire.
Expurger les journaux sans perdre leur valeur opérationnelle
Les journaux aident à diagnostiquer les récupérations vides, les requêtes échouées et les citations manquantes, mais les invites et les documents complets peuvent contenir des informations personnelles, confidentielles ou commercialement sensibles. Ne consignez que les données nécessaires au fonctionnement du service, par exemple :
- Un identifiant de requête, un horodatage, un statut et une latence.
- Le modèle et la version de l’application, si cela facilite le débogage.
- Les identifiants internes des documents et les références aux pages ou sections, plutôt que le texte intégral récupéré.
- Une catégorie d’erreur expurgée, et non les en-têtes de requête ou les valeurs secrètes.
Par défaut, ne consignez jamais les en-têtes d’autorisation, les clés API, les invites complètes des utilisateurs ou des passages entiers de documents. Si vous avez besoin d’un débogage temporaire portant sur le contenu, appliquez une procédure contrôlée et limitée dans le temps, avec des restrictions d’accès et une date de suppression clairement définie. Vérifiez également les systèmes d’application, de proxy, de traçage et de signalement des erreurs : l’expurgation dans le journal principal de l’application ne nettoie pas automatiquement les autres points de capture.
Voici un exemple de modèle de journalisation :
log_event(
request_id="generated-request-id",
outcome="success",
retrieved_sources=["policy-17:p4", "handbook-03:section-2"],
credential="[never include]",
prompt="[omit or redact]",
passage_text="[omit or redact]"
)
Il s’agit de pseudocode, et non d’un exemple testé du SDK OpenAI. Adaptez-le à votre système de journalisation et vérifiez que les secrets sont supprimés avant que les événements ne quittent le processus de l’application.
Intégrer l’attribution des sources au contrat de réponse
Ne demandez pas au modèle d’inventer des citations après coup. Préservez les métadonnées des sources pendant la récupération, associez chaque passage à l’identifiant de son document et à sa page, sa section ou son URL, puis transmettez ces métadonnées à l’étape de génération de la réponse. Imposez le format attendu par votre application : une réponse accompagnée de références provenant uniquement de l’ensemble récupéré. Validez ensuite les références dans le code de l’application avant de les afficher.
Si la récupération ne renvoie aucun passage pertinent, indiquez que les documents disponibles ne permettent pas d’étayer une réponse ou demandez à l’utilisateur de préciser sa question. Si une affirmation de la réponse ne peut pas être reliée à une source renvoyée, signalez qu’elle n’est pas étayée ou omettez-la. Une citation n’est utile que si l’emplacement référencé existe et contient des éléments qui étayent l’affirmation. L’implémentation exacte de la récupération et du format de réponse dépend des API choisies ; les recommandations de sécurité citées ici ne prescrivent aucune implémentation particulière pour les questions-réponses sur des documents ou les citations.
Définir une procédure de renouvellement des identifiants
Documentez les étapes avant qu’un incident ne survienne. Une procédure pratique consiste à :
- Identifier l’application, le projet, l’entrée du magasin de secrets et les services qui utilisent l’identifiant actuel.
- Créer un identifiant de remplacement doté des mêmes accès minimaux requis et le stocker dans le magasin de secrets approuvé.
- Déployer le remplacement au moyen d’une modification contrôlée de la configuration. Évitez de l’afficher pendant le déploiement ou de l’inclure dans des artefacts de compilation.
- Envoyer une question de test dans le flux de travail habituel. Vérifiez que l’inférence aboutit, que les citations pointent toujours vers les bonnes sources et que les journaux ne contiennent ni secrets ni texte de document.
- Surveiller les erreurs, puis révoquer l’ancien identifiant une fois l’utilisation du remplacement confirmée. Supprimez les copies obsolètes des systèmes de déploiement et des environnements de développement locaux.
- Si une exposition est suspectée, révoquer immédiatement l’identifiant concerné, examiner les accès et les journaux, puis en émettre un autre. N’attendez pas la prochaine échéance prévue.
Les recommandations d’OpenAI indiquent qu’il faut renouveler ou révoquer les clés lorsque nécessaire et révoquer immédiatement les identifiants si une exposition est suspectée. Votre organisation doit définir son propre intervalle de renouvellement en fonction des risques, de sa politique et des contraintes opérationnelles ; la source citée ne prescrit pas de calendrier universel.
Liste de vérification avant le lancement
- La clé de l’application est conservée côté serveur et reste inaccessible aux navigateurs et au code généré par un agent.
- La charge de travail est isolée de façon appropriée, avec un projet ou un environnement dédié lorsque cela se justifie.
- Les autorisations sont limitées aux opérations nécessaires à l’application.
- Les journaux excluent les clés, les en-têtes d’autorisation, les invites brutes et les passages récupérés dans leur intégralité.
- Les réponses comprennent des références validées aux documents récupérés.
- Une personne responsable est désignée pour déployer un identifiant de remplacement et révoquer l’ancien.
Le principe de conception est simple : gardez les identifiants hors de l’environnement de traitement des documents et veillez à ce que les citations renvoient à des sources récupérées. Vous réduirez ainsi les conséquences d’une compromission de la charge de travail tout en permettant aux utilisateurs de vérifier sur quoi repose la réponse.
FAQ
Puis-je mettre une clé API OpenAI dans une application de questions-réponses sur des documents accessible depuis un navigateur ?
N’exposez pas la clé de l’application dans le code du navigateur. Effectuez les requêtes OpenAI depuis un composant serveur fiable qui récupère la clé dans une configuration protégée ou un gestionnaire de secrets.
Dois-je consigner les invites et les passages de documents récupérés pour déboguer les réponses ?
Évitez de le faire par défaut. Privilégiez les identifiants de requête, le statut, la durée et les identifiants des sources. Si un débogage temporaire portant sur le contenu est nécessaire, limitez l’accès, fixez une échéance de suppression et veillez à ne jamais capturer d’identifiants secrets.
À quelle fréquence faut-il renouveler les clés API OpenAI ?
Les recommandations de sécurité d’OpenAI citées indiquent qu’il faut renouveler ou révoquer les clés lorsque nécessaire, mais ne définissent pas d’intervalle universel. Fixez un calendrier en fonction des risques et de la politique de votre organisation, et révoquez immédiatement toute clé dont l’exposition est suspectée.
Comment rendre fiables les citations dans les réponses sur des documents ?
Conservez les métadonnées des identifiants de documents et des pages, sections ou URL pendant la récupération, limitez les références aux sources récupérées et validez chaque référence avant de l’afficher. Ne comptez pas sur le modèle pour inventer des citations.
Articles liés
Guides
Diagnostiquer les erreurs de l’API OpenAI dans un système de questions-réponses sur documents
Un guide pratique pour résoudre les erreurs d’authentification, les limites de débit, les délais d’attente et les réponses dont les sources sont mal attribuées.
Guides
Estimer le coût de Kimi K3.1 Pro Highspeed pour le Q&R sur des documents
Estimation reproductible du coût du question-réponse sur des documents avec Kimi K3.1 Pro Highspeed : tarifs officiels et OneMux, hypothèses de cache et calculs selon le volume d’utilisation.
Guides
Sécuriser les clés API OpenAI pour le triage du support client
Un processus de sécurité pratique pour utiliser OpenAI dans le triage du support client : protéger les clés API, expurger les journaux, limiter les permissions, renouveler les identifiants et exiger une validation humaine.
Guides
Coût de l’API Gemini 4 Argon pour les questions-réponses sur des documents : estimation reproductible
Estimez le coût de l’API Gemini 4 Argon pour les questions-réponses sur des documents à partir d’hypothèses explicites sur les tokens, de l’attribution des sources, de scénarios de cache et d’une comparaison avec les tarifs publiés par OneMux.