Passer au contenu principal
L’intégration OpenAI Platform collecte les journaux d’audit de l’organisation pour la supervision de la sécurité et la détection. Elle couvre les modifications administratives, l’activité des clés API, la configuration des identités et les tentatives de connexion, sans nécessiter de logiciel sur les appareils des employés.
Cette intégration se connecte à l’API Platform d’OpenAI sur platform.openai.com. Elle n’utilise pas les identifiants de la ChatGPT Enterprise Admin Console et ne collecte pas le contenu des prompts ni des réponses.

​
Prérequis

Avant de configurer cette intégration, assurez-vous que :
  1. Vous êtes Organization Owner dans OpenAI API Platform
  2. Vous pouvez modifier les contrôles des données de l’organisation
  3. Vous pouvez créer une clé Admin API d’API Platform

​
Étape 1 : activer la journalisation d’audit

  1. Connectez-vous à OpenAI Platform
  2. Ouvrez Settings → Data controls → Data retention
  3. Sous Audit logging, cliquez sur Enable
  4. Enregistrez vos modifications
L’activation de la journalisation d’audit est en pratique irréversible. Elle ne peut pas être désactivée dans les paramètres de l’organisation ; un Organization Owner doit contacter le support OpenAI pour demander une modification.
La journalisation d’audit doit être activée pour qu’OpenAI mette les enregistrements d’audit à disposition via l’API. OpenAI ne récupère pas rétroactivement l’activité antérieure à l’activation de ce paramètre. Une organisation dont la journalisation vient d’être activée peut renvoyer un journal d’audit vide jusqu’à ce que quelqu’un effectue une action administrative après l’activation.

​
Étape 2 : créer une clé Admin API restreinte

  1. Ouvrez Organization Admin keys
  2. Cliquez sur Create new admin key
  3. Saisissez un nom descriptif, par exemple Wirespeed Audit Logs
  4. Sous Permissions, sélectionnez Restricted
  5. Définissez Audit Logs Scope sur Read
  6. Laissez désactivées les autorisations de gestion sans rapport
  7. Créez la clé et copiez-la immédiatement
OpenAI n’affiche la clé qu’une seule fois. Si elle est perdue, supprimez-la et créez une autre clé. Conservez-la en lieu sûr.
Utilisez une clé Admin d’API Platform, dont la forme masquée commence par sk-admin.... Les clés standard de modèle ou de projet et les clés Admin d’espace de travail ChatGPT ne peuvent pas accéder à ce point de terminaison. Wirespeed ne nécessite pas Organization Administration Write.

​
Étape 3 : connecter OpenAI Platform à Wirespeed

  1. Dans Wirespeed, ouvrez Intégrations → Ajouter une intégration
  2. Recherchez et sélectionnez OpenAI Platform
  3. Collez la clé Admin API
  4. Cliquez sur Intégrer
Wirespeed valide la clé auprès du point de terminaison Audit Logs de l’organisation avant d’activer l’intégration. Une connexion réussie prouve seulement que la clé peut appeler ce point de terminaison. Elle ne signifie pas que des événements existent déjà.

​
Quels événements sont collectés ?

Wirespeed importe tous les types d’événements renvoyés par l’API Audit Logs de l’organisation OpenAI, notamment :
  • Les connexions et déconnexions réussies ou en échec
  • Les modifications d’utilisateurs, d’invitations, de groupes et de comptes de service
  • Les attributions de rôles et d’autorisations
  • La création, la mise à jour et la suppression de clés API
  • Les modifications de la liste d’autorisation d’IP et de la configuration SCIM
  • Les modifications de projets, de l’organisation et des limites de débit
  • Les modifications d’identités de charge de travail, de tunnels, de certificats et de clés externes
La première synchronisation demande jusqu’à sept jours d’historique disponible. Les événements antérieurs à l’activation de la journalisation d’audit ne sont pas disponibles. OpenAI conserve les journaux d’audit dans la mesure du possible et ne garantit pas de durée de conservation fixe.
Les journaux d’audit d’OpenAI contiennent des métadonnées administratives, et non le contenu des requêtes ou des réponses des modèles. Les paramètres Zero Data Retention d’OpenAI ne modifient pas la disponibilité des journaux d’audit.

​
Détections gérées

Wirespeed évalue les événements collectés pour détecter : Les connexions réussies et en échec sont également normalisées en tant qu’événements d’authentification pour les recherches SIEM et les détections de connexion multiplateformes. Wirespeed ne crée pas de détection individuelle pour chaque connexion.

​
Dépannage

​
Clé API non valide

En cas d’erreurs 401 :
  1. Vérifiez que la clé a été collée en entier, sans espaces
  2. Vérifiez qu’il s’agit d’une clé Admin d’API Platform, et non d’une clé API OpenAI standard
  3. Si la clé a été supprimée ou perdue, créez-en une nouvelle et mettez à jour Wirespeed

​
Autorisation sur les journaux d’audit manquante

En cas d’erreurs 403 ou de portée manquante :
  1. Créez la clé en tant qu’Organization Owner d’OpenAI API Platform
  2. Sélectionnez les autorisations Restricted
  3. Définissez Audit Logs Scope sur Read
  4. Remplacez la clé dans Wirespeed

​
L’intégration se connecte mais aucun événement n’apparaît

Une intégration au statut Sain avec uniquement une entrée de journal « Integration added » signifie généralement qu’OpenAI a renvoyé une liste vide. Vérifiez que des événements existent chez le fournisseur avant de les attendre dans Wirespeed :
"data": [] avec "has_more": false signifie que Wirespeed n’a rien à ingérer. Ensuite :
  1. Vérifiez que la journalisation d’audit est Active sous Data controls → Data retention
  2. Créez puis supprimez une clé API de projet, ou déconnectez-vous puis reconnectez-vous
  3. Attendez quelques minutes et relancez la requête jusqu’à ce que data contienne des événements
  4. Prévoyez une minute de plus pour que Wirespeed interroge l’API
N’utilisez pas la clé Admin collée dans Wirespeed comme clé de modèle. Ce sont les clés API de projet et l’activité des sessions du tableau de bord qui produisent des enregistrements d’audit.

​
Limitation du débit

OpenAI peut renvoyer des réponses 429 lors d’une collecte à fort volume. Wirespeed relance la collecte lors d’une synchronisation ultérieure sans avancer au-delà de la période incomplète.

​
Ressources supplémentaires