> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wirespeed.co/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenAI Platform

> Supervisez l’activité d’administration, de configuration et d’authentification dans votre organisation OpenAI API Platform

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.

> [!NOTE]
>
> 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](https://platform.openai.com/)
2. Ouvrez **Settings** → **Data controls** → **Data retention**
3. Sous **Audit logging**, cliquez sur **Enable**
4. Enregistrez vos modifications

> [!WARNING]
>
> 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](https://platform.openai.com/settings/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

> [!WARNING]
>
> 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.

> [!NOTE]
>
> 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**](https://app.wirespeed.co/settings/integrations?tab=browse)
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.

> [!NOTE]
>
> 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 :

| Détection | Condition |
| - | - |
| Liste d’autorisation d’IP modifiée | Une liste d’autorisation est créée, mise à jour, supprimée, activée ou désactivée |
| Rôle de propriétaire ou d’administrateur attribué | Un utilisateur ou un compte de service reçoit un accès élevé |
| Configuration SCIM modifiée | Le provisionnement SCIM est activé ou désactivé |
| Clé API à privilèges élevés | Une clé API est créée avec **All** dans le tableau de bord (`scopes` vide), ou créée/mise à jour avec une portée `.write` / `:write` / `admin` |

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 :

```bash theme={null}
curl -sS "https://api.openai.com/v1/organization/audit_logs?limit=5" \
  -H "Authorization: Bearer $OPENAI_ADMIN_KEY"
```

`"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

* [API Admin et Audit Logs d’OpenAI](https://help.openai.com/en/articles/9687866-admin-and-audit-logs-api-for-the-api-platform)
* [Guide des API Admin d’OpenAI](https://developers.openai.com/api/docs/guides/admin-apis)
* [Référence de l’API Audit Logs d’OpenAI](https://developers.openai.com/api/reference/resources/organization/subresources/audit_logs/)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.