GuidesOneMux

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.

AI

Résumé · TL;DR

Pour le triage du support client, conservez la clé d’application OpenAI dans un composant serveur de confiance, envoyez uniquement des informations de dossier minimisées et expurgées, consignez les décisions plutôt que les secrets ou les conversations complètes, et exigez une validation humaine avant toute action destinée au client. Utilisez des identifiants distincts, assortis du moindre privilège, pour les différents traitements et documentez leur renouvellement ou leur révocation.

Points clés

  • Ne placez pas de clé API d’application dans du code généré par un agent, un navigateur, une image de conteneur, le code source ou des journaux.
  • Expurgez les informations personnelles et confidentielles avant d’envoyer un dossier de support à un modèle ; limitez aussi les informations conservées ensuite.
  • Laissez le modèle suggérer une catégorie, un niveau de priorité et un brouillon, mais ne le laissez pas clôturer des dossiers, émettre des remboursements ou envoyer des réponses sans validation humaine.
  • Séparez les identifiants par traitement, accordez uniquement les permissions API nécessaires et répétez les procédures de renouvellement et de révocation des clés.
Sur cette page (7)

Le modèle le plus sûr : conseiller, pas agir

Pour le triage du support client, la première étape utile consiste généralement à classer et résumer les demandes, plutôt qu’à les résoudre de façon autonome. Un modèle peut suggérer une file d’attente, un degré d’urgence et un résumé provisoire, tandis qu’un agent du support vérifie les éléments disponibles et décide de la suite.

Conservez la clé d’application OpenAI dans un service serveur de confiance qui effectue la requête API. Ne l’exposez pas au navigateur du client ni au code exécuté dans un environnement d’agent. Le guide de sécurité du sandbox OpenAI indique 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. Il recommande de conserver la clé d’application en dehors de cet environnement et de ne pas intégrer de clés au code source, aux images ou aux journaux. Consignes de sécurité du sandbox OpenAI

Les exemples ci-dessous sont donnés à titre indicatif et n’ont pas été testés en tant que configuration. Adaptez-les à votre client API, à vos exigences en matière de confidentialité et à votre système de support.

Un flux de triage minimal

  1. Votre système de support reçoit un dossier et supprime les champs inutiles au triage.
  2. Un backend de confiance expurge les valeurs sensibles et envoie le texte restant à OpenAI à l’aide d’un identifiant côté serveur.
  3. Le modèle renvoie une proposition de catégorie, de priorité et un court résumé.
  4. Votre application présente cette proposition à un agent du support autorisé. L’agent approuve ou modifie l’action suivante.
  5. Votre système consigne la décision et les métadonnées d’audit nécessaires, sans conserver de secrets ni dupliquer inutilement toute la conversation.

Par exemple, le backend peut transmettre un prompt volontairement limité et un dossier expurgé. Évitez d’inclure des mots de passe, des données de carte bancaire, des jetons d’authentification ou l’historique de compte sans rapport avec le dossier. Les règles d’expurgation doivent être appliquées avant la requête, et pas seulement au moment d’écrire les journaux.

# Illustrative pseudocode: provide an already-redacted case to your API client.
# Keep credential loading and the API call in a trusted backend service.

def propose_triage(api_client, redacted_case):
    response = api_client.create_response(
        instructions=(
            "Suggest a support category, priority, and concise summary. "
            "Do not claim to have resolved the case or send a reply. "
            "If information is insufficient, say what is missing."
        ),
        input=redacted_case,
    )
    return response

Ce schéma n’est pas un exemple prêt à l’emploi pour le SDK OpenAI : les noms de méthodes et les champs de requête dépendent du client et du point de terminaison API utilisés. Avant toute mise en œuvre, consultez la documentation API à jour pour vérifier le point de terminaison, les paramètres pris en charge et le format de réponse. Ne considérez pas la sortie du modèle comme une autorisation d’effectuer une action de support.

Séparer les clés et les permissions

Dans la mesure du possible, utilisez des identifiants distincts pour les différentes applications ou charges de travail. Vous limitez ainsi les conséquences d’une erreur et pouvez révoquer un identifiant sans interrompre des services sans rapport. Restreignez l’accès au système qui a besoin de la clé ; stockez-la dans un coffre de secrets géré ou dans un dispositif serveur protégé équivalent, et injectez-la uniquement dans le composant de confiance qui effectue la requête.

Pour l’environnement Agents API décrit dans les consignes d’OpenAI, la clé d’application nécessite api.agents.read et api.agents.write pour les sessions, ainsi que api.responses.write pour l’inférence. La gestion des coffres nécessite api.vaults.read et api.vaults.write. Le guide distingue la clé d’environnement de la clé d’application : la clé d’environnement permet de connecter des environnements et ne peut pas autoriser d’autres actions API. Accordez les permissions requises par les fonctionnalités API que vous utilisez réellement ; ne donnez pas de permissions de coffre à un service de triage qui ne gère pas de coffres.

Si un environnement d’agent ou un sandbox intervient, considérez comme exposé au code généré par l’agent tout ce qui est accessible à ce code. Pour les identifiants de tiers, les consignes recommandent de les conserver hors de l’environnement et de recourir, selon le cas, à un proxy de confiance ou à une approche fondée sur un coffre. Un secret injecté dans l’environnement reste accessible au code qui y est exécuté.

Expurger les journaux sans perdre leur valeur d’audit

Les journaux aident à examiner les erreurs de classification, les problèmes d’accès et les incidents, mais ils ne doivent pas devenir une seconde copie de la boîte de réception du support. Évitez d’y consigner des clés API, des en-têtes d’autorisation, des prompts complets, des messages bruts de clients ou des réponses du modèle susceptibles de répéter des informations sensibles.

Privilégiez des enregistrements structurés et limités, comme une référence de dossier interne, l’heure de la requête, l’identifiant du modèle ou du point de terminaison, l’état de l’expurgation, la catégorie proposée, la décision humaine et la catégorie d’erreur. Contrôlez l’accès à ces enregistrements et définissez leur durée de conservation. Si des exemples de conversations sont nécessaires aux évaluations de qualité, créez un jeu de données distinct, minimisé et soumis à une gouvernance spécifique, au lieu de conserver discrètement les données de production.

L’expurgation peut échouer lorsque des informations personnelles figurent dans du texte libre, des fils de courriels cités, des pièces jointes ou des formats inhabituels. Testez les règles sur des dossiers réalistes, examinez les données qui quittent votre système et prévoyez une solution de repli sûre lorsque le service ne peut pas supprimer les informations sensibles avec suffisamment de fiabilité.

Définir une procédure de renouvellement et de révocation

Un plan de renouvellement doit désigner un responsable et préciser où l’identifiant est stocké, quels services l’utilisent, qui peut le remplacer et comment vérifier le changement. Voici une procédure pratique :

  1. Créez un identifiant de remplacement doté uniquement des permissions nécessaires.
  2. Mettez à jour le coffre de secrets du service de confiance, puis déployez ou rechargez l’identifiant selon votre processus habituel de gestion des changements.
  3. Vérifiez qu’une requête de triage sans risque aboutit, sans exposer l’identifiant dans les diagnostics.
  4. Révoquez l’ancien identifiant et confirmez que le service n’en dépend plus.
  5. Consignez la date, le responsable, la charge de travail concernée et le résultat — jamais la valeur secrète.

Définissez une fréquence de révision adaptée aux risques et aux exigences opérationnelles de votre organisation. Révoquez rapidement une clé si une exposition est suspectée ; n’attendez pas le prochain renouvellement programmé. Les consignes d’OpenAI recommandent explicitement de renouveler ou de révoquer les clés si nécessaire et de révoquer immédiatement les identifiants en cas de suspicion d’exposition.

Validation humaine et gestion des échecs

Faites de la validation une règle du système, pas seulement une consigne dans le prompt. Dans ce flux de travail, le modèle ne doit pas avoir directement accès aux outils qui envoient des messages aux clients, modifient l’état d’un compte ou émettent des remboursements. Présentez sa suggestion comme une proposition, affichez les éléments pertinents après expurgation et exigez la confirmation d’une personne autorisée avant toute action ayant des conséquences.

Si l’API est indisponible, si la réponse est mal formée ou si l’expurgation échoue, orientez le dossier vers la file d’attente manuelle existante. Ne transformez pas discrètement une classification incertaine en action automatique.

Liste de contrôle

  • La clé d’application reste dans un backend de confiance, et non dans un navigateur ou un environnement d’agent.
  • Les identifiants sont séparés par charge de travail et limités aux permissions nécessaires.
  • Les champs sensibles sont supprimés avant l’inférence et exclus des journaux courants.
  • Le résultat du triage est fourni à titre indicatif ; une personne valide les actions destinées aux clients ou modifiant un compte.
  • Un responsable désigné peut remplacer ou révoquer les identifiants, et la procédure a été répétée.
  • Les échecs et les résultats incertains sont redirigés vers un processus manuel sûr.

Le choix de conception essentiel consiste à garder les identifiants et les actions ayant des conséquences hors de portée du modèle. Utilisez le modèle pour organiser le travail du support, limitez les données auxquelles il accède et faites de la validation humaine le dernier garde-fou.

FAQ

Puis-je placer une clé API OpenAI dans un sandbox d’agent ?

Évitez de placer la clé d’application dans un environnement d’agent. Les consignes de sécurité du sandbox OpenAI indiquent que le code généré par un agent peut accéder aux fichiers, aux identifiants et au réseau de l’environnement, et recommandent de conserver la clé d’application en dehors de celui-ci. Utilisez un backend de confiance pour effectuer les requêtes API.

Que doivent contenir les journaux de triage du support client ?

Ne conservez que les métadonnées nécessaires au fonctionnement et à l’audit, comme une référence de dossier interne, un horodatage, l’état de l’expurgation, la catégorie proposée, la décision humaine et la catégorie d’erreur. Évitez de consigner les clés API, les en-têtes d’autorisation, les messages complets des clients et les sorties sensibles du modèle.

Le modèle doit-il envoyer automatiquement une réponse au client ?

Dans un processus de triage soumis à une validation humaine, non. Utilisez la sortie du modèle comme une suggestion et exigez qu’un agent du support autorisé examine et approuve les actions destinées aux clients ou modifiant un compte.

Quand faut-il renouveler une clé API OpenAI ?

Définissez une fréquence de révision régulière, adaptée à vos risques et à vos exigences opérationnelles, et renouvelez les identifiants si nécessaire. Si une exposition est suspectée, révoquez immédiatement l’identifiant et suivez votre procédure de remplacement et de vérification.

Articles liés