> ## 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.

# Cursor

> Supervisez les modifications d’administration, d’accès et de configuration dans vos équipes et votre organisation Cursor Enterprise

L’intégration Cursor collecte le **journal d’audit** de Cursor pour la
supervision de la sécurité et la détection. Elle couvre les connexions, les
modifications des membres et des rôles, le cycle de vie des clés API et des
comptes de service, les limites de dépenses, le mode de confidentialité, les
hooks et règles de l’équipe, les serveurs MCP, les intégrations et la stratégie
réseau des agents cloud, sans nécessiter de logiciel sur les appareils des
employés.

> [!NOTE]
>
> Wirespeed lit uniquement les métadonnées du journal d’audit. Il ne collecte pas
> les prompts, l’historique des conversations, le code généré ni l’activité des
> agents.

## Prérequis

Les journaux d’audit de Cursor nécessitent un forfait **Cursor Enterprise**. Les
clés API d’un forfait Teams ne peuvent pas lire le journal d’audit, et Wirespeed
les refuse lors de la connexion.

Choisissez la clé qui correspond à votre configuration Cursor :

| Clé | Qui la crée | Scope | Journal d’audit couvert |
| - | - | - | - |
| **Clé API d’organisation** (recommandée lorsqu’elle est disponible) | Un administrateur de l’organisation | `auditlogs:read` (lecture seule) | Toutes les équipes liées à l’organisation, ainsi que les événements propres à l’organisation, comme les modifications du SSO et du fournisseur d’identité |
| **Clé API d’équipe** | Un administrateur de l’équipe | Permission **View audit logs** (lecture seule) | Une seule équipe |

Une clé d’organisation n’existe que si votre entreprise a configuré une
**organisation** Cursor qui relie ses équipes Enterprise. Si vous disposez d’une
seule équipe Enterprise sans organisation, utilisez une clé API d’équipe.

## Étape 1 : créer une clé

### Clé API d’organisation

1. Connectez-vous au [tableau de bord Cursor](https://cursor.com/dashboard) en
   tant qu’administrateur de l’organisation
2. Ouvrez les paramètres **API Keys** de l’organisation et cliquez sur **New API Key**
3. Nommez la clé, par exemple `Wirespeed Audit Log`, et sélectionnez le scope
   **`auditlogs:read`**
4. Créez la clé et copiez-la

### Clé API d’équipe

1. Connectez-vous au [tableau de bord Cursor](https://cursor.com/dashboard) en
   tant qu’administrateur de l’équipe
2. Ouvrez **Settings → API Keys** et cliquez sur **New API Key**
3. Nommez la clé, par exemple `Wirespeed Audit Log`
4. Ouvrez la liste des permissions et sélectionnez **Audit logs → View audit
   logs**. Décochez toute autre permission, y compris **General → View team
   resources**, que Cursor sélectionne par défaut
5. Créez la clé et copiez-la

Cursor n’affiche la clé qu’une seule fois. Conservez-la en lieu sûr.

## Étape 2 : connecter Cursor à Wirespeed

1. Dans Wirespeed, ouvrez Intégrations → [**Ajouter une intégration**](https://app.wirespeed.co/settings/integrations?tab=browse)
2. Recherchez et sélectionnez **Cursor**
3. Choisissez **Clé API d’organisation** ou **Clé API d’équipe** selon la clé que
   vous avez créée
4. Collez la clé
5. Cliquez sur **Intégrer**

Wirespeed lit le journal d’audit avec la clé avant d’activer l’intégration. Une
connexion réussie prouve que la clé peut lire le journal d’audit ; 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 le journal d’audit,
notamment :

* Les connexions et déconnexions
* Les invitations, ajouts, retraits et changements de rôle des membres, ainsi que
  les identifiants révoqués
* Les clés API d’équipe, d’organisation et d’utilisateur, les comptes de service
  et les clés de compte de service
* Les paramètres de l’équipe, les limites de dépenses et le mode de confidentialité
* Les hooks, règles, commandes et serveurs MCP de l’équipe
* Les intégrations Slack, de dépôts et Bugbot
* Les modifications des groupes d’annuaire, du SSO et du fournisseur d’identité
* Les secrets et la stratégie réseau des agents cloud

La première synchronisation demande jusqu’à sept jours d’historique. Chaque
interrogation collecte ensuite les événements à partir de la fenêtre précédente,
en lisant avec deux minutes de retard sur le temps réel et en relisant un court
chevauchement pour récupérer les événements indexés tardivement. Cursor limite
chaque requête du journal d’audit à une période de 30 jours.

## Détections gérées

Wirespeed évalue les événements collectés pour repérer les modifications de
configuration et de posture. Elles sont informatives sauf indication contraire :

| Détection | Événement |
| - | - |
| Utilisateur supprimé | `remove_user` |
| Rôle de propriétaire attribué | `update_user_role` vers `OWNER` ou `FREE_OWNER` (persistance) |
| Clé API ou compte de service créé | Création de `team_api_key`, `organization_api_key` ou `user_api_key` ; création de `service_account` ; création ou rotation de `api_key` (persistance) |
| Clé API ou compte de service révoqué | Révocation de `team_api_key`, `organization_api_key` ou `user_api_key` ; archivage de `service_account` |
| Limite de dépenses modifiée | Limite de dépenses de l’équipe ou par utilisateur dans `team_settings` ou `user_spend_limit`, ou limite de dépenses d’un compte de service |
| Paramètres d’équipe modifiés | Toute autre modification de `team_settings` |
| Serveur MCP d’équipe modifié | `mcp_server_config` au niveau de l’équipe |
| Hook d’équipe modifié | `team_hook`. Les hooks d’équipe exécutent un script sur la machine de chaque membre |
| Règle ou commande d’équipe modifiée | `team_rule` ou `team_command` |
| Intégration modifiée | `slack_account_link`, `team_repo` ou `bugbot_installation` |
| Mode de confidentialité d’équipe modifié | `privacy_mode` au niveau de l’équipe |
| Paramètres SSO modifiés | `organization_identity_provider` (clés d’organisation uniquement) |
| Stratégie réseau des agents cloud modifiée | `cloud_agent_environment_settings` |
| Échec de connexion | `login` avec `success: false` |

Les connexions sont également normalisées en événements d’authentification pour
les recherches SIEM et les détections de connexion multiplateformes.

## Dépannage

### Clé invalide

Une erreur `401` signifie que la clé est incorrecte, incomplète ou révoquée.
Vérifiez que la clé a été collée en entier, sans espaces, puis créez si
nécessaire une clé de remplacement et mettez à jour Wirespeed.

### La clé ne peut pas lire les journaux d’audit

Une erreur `403` signifie que la clé ne peut pas lire le journal d’audit.
Vérifiez que :

1. Votre forfait Cursor est **Enterprise**
2. Une clé d’équipe dispose de la permission **Audit logs → View audit logs**
3. Une clé d’organisation dispose du scope `auditlogs:read`
4. Le type de clé sélectionné dans Wirespeed correspond à la clé : une clé
   d’organisation connectée en tant que clé d’équipe, ou l’inverse, est refusée

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

Une intégration en bon état journalise `0 new logs ingested` à chaque
interrogation lorsqu’il n’existe aucun nouvel événement. Vérifiez que des
événements existent avant de les attendre dans Wirespeed :

```bash theme={null}
curl -sS "https://api.cursor.com/teams/audit-logs?startTime=7d&pageSize=5" \
  --config - <<< "user = \"$CURSOR_API_KEY:\""
```

Pour une clé d’organisation, utilisez `https://api.cursor.com/organizations/audit-logs`.
Un tableau `events` vide signifie qu’il n’y a rien à ingérer pour Wirespeed.

### Limitation du débit

Cursor autorise 20 requêtes au journal d’audit par minute par équipe ou
organisation, partagées entre toutes les clés et intégrations. En cas de réponse
`429`, Wirespeed conserve sa position et réessaie lors de la synchronisation
suivante.

## Ressources supplémentaires

* [Conformité et supervision dans Cursor](https://cursor.com/docs/enterprise/compliance-and-monitoring)
* [Admin API de Cursor : journaux d’audit](https://cursor.com/docs/account/teams/admin-api#get-audit-logs)
* [Organization Admin API de Cursor](https://cursor.com/docs/account/organizations/organization-admin-api)
* [Présentation de l’API Cursor](https://cursor.com/docs/api)


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