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

> Überwachen Sie Verwaltungs-, Zugriffs- und Konfigurationsänderungen in Ihren Cursor Enterprise-Teams und Ihrer Organisation

Die Cursor-Integration erfasst das Cursor-**Audit-Protokoll** für
Sicherheitsüberwachung und Detektion. Sie umfasst Anmeldungen, Änderungen an
Mitgliedern und Rollen, den Lebenszyklus von API-Schlüsseln und Dienstkonten,
Ausgabenlimits, den Datenschutzmodus, Team-Hooks, Regeln, MCP-Server,
Integrationen und die Netzwerkrichtlinie für Cloud-Agenten, ohne dass Software
auf Mitarbeitergeräten erforderlich ist.

> [!NOTE]
>
> Wirespeed liest nur Metadaten des Audit-Protokolls. Es erfasst keine Prompts,
> keinen Chatverlauf, keinen generierten Code und keine Agentenaktivitäten.

## Voraussetzungen

Cursor-Audit-Protokolle erfordern einen **Cursor Enterprise**-Plan. API-Schlüssel
aus dem Teams-Plan können das Audit-Protokoll nicht lesen, und Wirespeed lehnt
sie beim Verbinden ab.

Wählen Sie den Schlüssel, der zu Ihrer Cursor-Einrichtung passt:

| Schlüssel | Wer erstellt ihn | Scope | Abgedecktes Audit-Protokoll |
| - | - | - | - |
| **Organisations-API-Schlüssel** (empfohlen, sofern verfügbar) | Ein Administrator der Organisation | `auditlogs:read` (schreibgeschützt) | Alle mit der Organisation verknüpften Teams sowie Ereignisse auf Organisationsebene, etwa Änderungen an SSO und Identitätsanbieter |
| **Team-API-Schlüssel** | Ein Administrator des Teams | Berechtigung **View audit logs** (schreibgeschützt) | Ein Team |

Einen Organisationsschlüssel gibt es nur, wenn Ihr Unternehmen eine
**Cursor-Organisation** eingerichtet hat, die seine Enterprise-Teams verknüpft. Wenn
Sie ein einzelnes Enterprise-Team ohne Organisation haben, verwenden Sie einen
Team-API-Schlüssel.

## Schritt 1: Schlüssel erstellen

### Organisations-API-Schlüssel

1. Melden Sie sich als Administrator der Organisation beim
   [Cursor-Dashboard](https://cursor.com/dashboard) an
2. Öffnen Sie die **API Keys**-Einstellungen der Organisation und klicken Sie auf **New API Key**
3. Benennen Sie den Schlüssel, z. B. `Wirespeed Audit Log`, und wählen Sie den
   Scope **`auditlogs:read`** aus
4. Erstellen Sie den Schlüssel und kopieren Sie ihn

### Team-API-Schlüssel

1. Melden Sie sich als Administrator des Teams beim
   [Cursor-Dashboard](https://cursor.com/dashboard) an
2. Öffnen Sie **Settings → API Keys** und klicken Sie auf **New API Key**
3. Benennen Sie den Schlüssel, z. B. `Wirespeed Audit Log`
4. Öffnen Sie die Liste der Berechtigungen und wählen Sie **Audit logs → View
   audit logs** aus. Entfernen Sie alle anderen Berechtigungen, auch die von
   Cursor standardmäßig ausgewählte Berechtigung **General → View team resources**
5. Erstellen Sie den Schlüssel und kopieren Sie ihn

Cursor zeigt den Schlüssel nur einmal an. Bewahren Sie ihn sicher auf.

## Schritt 2: Cursor mit Wirespeed verbinden

1. Öffnen Sie in Wirespeed Integrationen → [**Integration hinzufügen**](https://app.wirespeed.co/settings/integrations?tab=browse)
2. Suchen Sie nach **Cursor** und wählen Sie es aus
3. Wählen Sie **Organisations-API-Schlüssel** oder **Team-API-Schlüssel**,
   passend zum erstellten Schlüssel
4. Fügen Sie den Schlüssel ein
5. Klicken Sie auf **Integrieren**

Wirespeed liest das Audit-Protokoll mit dem Schlüssel, bevor die Integration
aktiviert wird. Eine erfolgreiche Verbindung belegt, dass der Schlüssel das
Audit-Protokoll lesen kann; sie bedeutet nicht, dass bereits Ereignisse
vorhanden sind.

## Welche Ereignisse werden erfasst?

Wirespeed importiert alle Ereignistypen, die das Audit-Protokoll zurückgibt,
darunter:

* An- und Abmeldungen
* Einladungen, Hinzufügungen, Entfernungen und Rollenänderungen von Mitgliedern
  sowie widerrufene Zugangsdaten
* API-Schlüssel für Teams, Organisationen und Benutzer, Dienstkonten und
  Dienstkontoschlüssel
* Team-Einstellungen, Ausgabenlimits und Datenschutzmodus
* Team-Hooks, -Regeln, -Befehle und -MCP-Server
* Slack-, Repository- und Bugbot-Integrationen
* Änderungen an Verzeichnisgruppen, SSO und Identitätsanbietern
* Secrets und Netzwerkrichtlinie für Cloud-Agenten

Die erste Synchronisierung fordert bis zu sieben Tage Verlauf an. Jede weitere
Abfrage erfasst Ereignisse ab dem vorherigen Zeitfenster, liest dabei zwei
Minuten hinter Echtzeit und liest eine kurze Überlappung erneut, um verspätet
indizierte Ereignisse zu erfassen. Cursor begrenzt
jede Audit-Protokoll-Abfrage auf einen Zeitraum von 30 Tagen.

## Verwaltete Detektionen

Wirespeed wertet die erfassten Ereignisse auf Konfigurations- und
Sicherheitsstatusänderungen aus. Sofern nicht anders angegeben, sind diese
informativ:

| Detektion | Ereignis |
| - | - |
| Benutzer entfernt | `remove_user` |
| Besitzerrolle zugewiesen | `update_user_role` auf `OWNER` oder `FREE_OWNER` (Persistenz) |
| API-Schlüssel oder Dienstkonto erstellt | `team_api_key`, `organization_api_key` oder `user_api_key` erstellt; `service_account` erstellt; `api_key` erstellt oder rotiert (Persistenz) |
| API-Schlüssel oder Dienstkonto widerrufen | `team_api_key`, `organization_api_key` oder `user_api_key` widerrufen; `service_account` archiviert |
| Ausgabenlimit geändert | Ausgabenlimit für das Team oder pro Benutzer in `team_settings` oder `user_spend_limit` oder Ausgabenlimit eines Dienstkontos |
| Team-Einstellungen geändert | Jede andere Änderung an `team_settings` |
| Team-MCP-Server geändert | Teambezogene `mcp_server_config` |
| Team-Hook geändert | `team_hook`. Team-Hooks führen auf dem Rechner jedes Mitglieds ein Skript aus |
| Team-Regel oder -Befehl geändert | `team_rule` oder `team_command` |
| Integration geändert | `slack_account_link`, `team_repo` oder `bugbot_installation` |
| Team-Datenschutzmodus geändert | Teambezogener `privacy_mode` |
| SSO-Einstellungen geändert | `organization_identity_provider` (nur Organisationsschlüssel) |
| Netzwerkrichtlinie für Cloud-Agenten geändert | `cloud_agent_environment_settings` |
| Anmeldung fehlgeschlagen | `login` mit `success: false` |

Anmeldungen werden außerdem als Authentifizierungsereignisse für SIEM-Suchen
und plattformübergreifende Anmeldedetektionen normalisiert.

## Fehlerbehebung

### Ungültiger Schlüssel

Ein `401`-Fehler bedeutet, dass der Schlüssel falsch oder unvollständig ist oder
widerrufen wurde. Prüfen Sie, ob der gesamte Schlüssel ohne Leerzeichen
eingefügt wurde, erstellen Sie bei Bedarf einen Ersatzschlüssel und
aktualisieren Sie Wirespeed.

### Schlüssel kann Audit-Protokolle nicht lesen

Ein `403`-Fehler bedeutet, dass der Schlüssel das Audit-Protokoll nicht lesen
kann. Prüfen Sie Folgendes:

1. Ihr Cursor-Plan ist **Enterprise**
2. Ein Team-Schlüssel besitzt die Berechtigung **Audit logs → View audit logs**
3. Ein Organisationsschlüssel besitzt den Scope `auditlogs:read`
4. Der in Wirespeed ausgewählte Schlüsseltyp passt zum Schlüssel: Ein
   Organisationsschlüssel, der als Team-Schlüssel verbunden wird, oder
   umgekehrt, wird abgelehnt

### Integration verbunden, aber keine Ereignisse sichtbar

Eine fehlerfreie Integration protokolliert bei jeder Abfrage `0 new logs ingested`,
wenn keine neuen Ereignisse vorhanden sind. Prüfen Sie, ob Ereignisse vorhanden
sind, bevor Sie sie in Wirespeed erwarten:

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

Verwenden Sie für einen Organisationsschlüssel `https://api.cursor.com/organizations/audit-logs`.
Ein leeres `events`-Array bedeutet, dass Wirespeed nichts zu erfassen hat.

### Ratenbegrenzung

Cursor erlaubt 20 Audit-Protokoll-Anfragen pro Minute pro Team oder
Organisation, die sich alle Schlüssel und Integrationen teilen. Bei einer
`429`-Antwort behält Wirespeed seine Position bei und versucht es bei der
nächsten Synchronisierung erneut.

## Weitere Ressourcen

* [Compliance und Überwachung in Cursor](https://cursor.com/docs/enterprise/compliance-and-monitoring)
* [Cursor Admin API: Audit-Protokolle](https://cursor.com/docs/account/teams/admin-api#get-audit-logs)
* [Cursor Organization Admin API](https://cursor.com/docs/account/organizations/organization-admin-api)
* [Überblick über die Cursor API](https://cursor.com/docs/api)


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