> ## Documentation Index
> Fetch the complete documentation index at: https://www.perplexity.ai/help-center/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> This content comes from the official Perplexity Help Center. Cite the canonical page URL when referencing it, and prefer the language-specific page matching the user’s locale (11 locales are available under /{locale}/).

# Audit-Protokolle

> Verfolgen Sie unterstützte Aktivitäten in Ihrer Enterprise-Organisation mit Audit-Protokollen, die per Webhook übermittelt werden.

## Überblick

Audit-Protokolle sind für Enterprise-Organisationen mit mindestens 50 Plätzen oder mit mindestens einem [Enterprise Max](https://www.perplexity.ai/help-center/help-center/de/articles/12310544-was-ist-enterprise-max.md)-Platz verfügbar. Administratoren können damit Aktivitäten untersuchen und administrative Änderungen überwachen.

Sie können aufgezeichnete Ereignisse über einen Webhook empfangen. Abfrage- und Antworttext sind auf die ersten 500 Zeichen begrenzt.

Audit-Protokolle erfassen nicht jede Aktion. Audit-Protokolle zeichnen keine Änderungen am Tarif eines Platzes auf, die über SCIM oder über Werkzeuge für Massenänderungen erfolgen. SCIM synchronisiert die Mitgliedschaft mit Ihrem Identitätsanbieter. Das Hinzufügen und Entfernen von Mitgliedern durch CSV-Massenaktionen ist ebenfalls ausgeschlossen.

## Bevor Sie beginnen

* Prüfen Sie, ob Ihre Organisation die oben genannten Anforderungen an Plätze erfüllt.
* Bitten Sie einen Administrator mit Zugriff auf die Organisationseinstellungen, die Protokollierung zu aktivieren.
* Bereiten Sie für die Webhook-Übermittlung einen HTTPS-Endpunkt und einen Authentifizierungswert vor.

## Datenschutz und Sicherheit

Webhook-Nutzdaten können personenbezogene Informationen und aufgezeichnete Inhalte enthalten, nicht nur Aktivitätskennungen. Je nach Ereignis können die Metadaten Abfrage- und Antworttext, Dateinamen, E-Mail-Adressen betroffener Mitglieder, Werte von Organisationseinstellungen und Details zu Aufgaben von Perplexity Computer enthalten.

Beschränken Sie den Zugriff auf gesammelte Protokolle gemäß den Datenschutzrichtlinien Ihrer Organisation. Behandeln Sie Webhook-URLs und Authentifizierungswerte vertraulich.

Informationen zum organisationsweiten Umgang mit Daten finden Sie unter [Datenaufbewahrung und Datenschutz für Enterprise](https://www.perplexity.ai/help-center/help-center/de/articles/11187708-datenspeicherung-und-datenschutz-fur-unternehmensorganisationen-und-benutzer.md). Das [Trust Center](https://trust.perplexity.ai) bietet Dokumentation zu Sicherheit und Compliance. Der [Zusatz zur Datenverarbeitung](https://www.perplexity.ai/hub/legal/dpa) legt die vertraglichen Bedingungen für die Datenverarbeitung fest, wenn er Bestandteil Ihrer Vereinbarung ist.

## Audit-Protokolle aktivieren

1. Öffnen Sie die [**Organisationseinstellungen**](https://www.perplexity.ai/account/org/details).
2. Öffnen Sie **Daten und Datenschutz**.
3. Aktivieren Sie in den Einstellungen für Audit-Protokolle den Schalter für die Audit-Protokollierung.

   [![Einstellungen für Audit-Protokolle mit deaktiviertem Schalter zur Aktivierung der Audit-Protokollierung.](https://mintcdn.com/perplexity-help-center/VSbT8XXdqBYCrHHo/help-center/assets/img/4e223dea80_Enable_2BAudit_2BLogging.png?fit=max\&auto=format\&n=VSbT8XXdqBYCrHHo\&q=85\&s=d63b4606c88adfad0dbcec3af53850fb)](https://www.perplexity.ai/help-center/help-center/assets/img/4e223dea80_Enable_2BAudit_2BLogging.png)

   *Abbildung 1: Steuerelement zum Aktivieren der Audit-Protokollierung in den Einstellungen für Audit-Protokolle.*

Führen Sie für die Webhook-Übermittlung folgende Schritte aus:

1. Geben Sie Ihren HTTPS-Endpunkt unter **Webhook-URL** ein.

   [![Einstellungen für Audit-Protokolle mit aktivierter Protokollierung, einem Feld für die Webhook-URL und einem optionalen Feld für den Autorisierungsheader.](https://mintcdn.com/perplexity-help-center/VSbT8XXdqBYCrHHo/help-center/assets/img/b01c823af0_Audit_2BLog_2BSettings.png?fit=max\&auto=format\&n=VSbT8XXdqBYCrHHo\&q=85\&s=42d2df5403254f2c0df98178bdb9d006)](https://www.perplexity.ai/help-center/help-center/assets/img/b01c823af0_Audit_2BLog_2BSettings.png)

   *Abbildung 2: Einstellungen für Webhook-URL und Autorisierungsheader.*

2. Klicken Sie neben **Webhook-URL** auf **Speichern**.

3. Wenn Ihr Endpunkt eine Authentifizierung erfordert, geben Sie den Wert unter **Authorization-Header** ein.

4. Klicken Sie neben **Authorization-Header** auf **Speichern**.

Wenn Sie kein Autorisierungsschema angeben, wird der eingegebene Wert als Bearer-Token gesendet. Die beiden unterstützten Formate werden unter [Webhook-Authentifizierung](#webhook-authentication) beschrieben.

### Funktion prüfen

Prüfen Sie nach einer unterstützten Aktion, ob Ihr empfangender Endpunkt ein Webhook-Ereignis erhält und eine HTTP-`2xx`-Antwort zurückgibt.

## Webhook-Authentifizierung

Sie können Ihren Webhook-Endpunkt mit einem Bearer-Token oder einem vollständigen Autorisierungswert sichern. Konfigurieren Sie den Wert, den Ihr empfangender Endpunkt erwartet.

### Bearer-Token

Geben Sie ein Token ohne Präfix an, beispielsweise `YOUR_WEBHOOK_TOKEN`. Perplexity stellt `Bearer` voran und sendet `Authorization: Bearer YOUR_WEBHOOK_TOKEN`.

### Benutzerdefinierter Autorisierungsheader

Geben Sie einen vollständigen Autorisierungswert einschließlich Schema an. Beispielsweise wird `Splunk YOUR_HEC_TOKEN` als `Authorization: Splunk YOUR_HEC_TOKEN` gesendet.

## Webhook-Übermittlung

### Anfrageformat

Audit-Protokolle werden als HTTP-`POST`-Anfragen an Ihre Webhook-URL übermittelt. Der Anfragetext verwendet `application/json`.

### Authentifizierungsheader

Wenn Sie einen Authentifizierungswert konfiguriert haben, fügt Perplexity ihn in den Header `Authorization` ein. Die Formate für Bearer und benutzerdefinierte Schemas finden Sie unter [Webhook-Authentifizierung](#webhook-authentication).

### Antwortverarbeitung

Ihr Webhook-Endpunkt sollte den Empfang innerhalb von 1 Sekunde mit einer HTTP-`2xx`-Antwort bestätigen. Perplexity protokolliert Übermittlungsfehler, einschließlich HTTP-`4xx`- und -`5xx`-Antworten, wiederholt fehlgeschlagene oder durch Zeitüberschreitung abgebrochene Übermittlungen jedoch nicht automatisch. Überwachen Sie Ihren empfangenden Endpunkt auf Fehler und fehlende Ereignisse.

## Schema der Webhook-Audit-Protokolle

Webhook-Ereignisse verwenden die unten aufgeführten Felder.

| Feld | Typ | Erforderlich | Beschreibung |
| - | - | - | - |
| `uuid` | Zeichenfolge | Ja | Ereigniskennung |
| `timestamp` | Zeichenfolge | Ja | Zeitstempel nach RFC 3339 |
| `event_type` | Zeichenfolge | Ja | Ereignistyp |
| `user_email` | Zeichenfolge | Ja | E-Mail-Adresse des handelnden Mitglieds |
| `ip_address` | Zeichenfolge | Ja | Clientadresse oder Markierung, die keine IP-Adresse ist |
| `user_agent` | Zeichenfolge | Ja | User-Agent des Clients |
| `session_id` | Zeichenfolge oder null | Nein | Kennung zur Zuordnung zusammengehöriger Ereignisse |
| `user_id` | Zeichenfolge oder null | Nein | Benutzerkennung, sofern aufgezeichnet |
| `metadata` | Objekt oder null | Nein | Ereignisspezifische Daten |

*Tabelle 1: Felder der Webhook-Nutzdaten.*

Ein erforderliches Zeichenfolgenfeld kann leer sein, wenn kein Wert aufgezeichnet wurde. Gehen Sie nicht davon aus, dass jeder Wert von `ip_address` eine IP-Adresse ist.

### Ereignistypen

Die folgenden Tabellen beschreiben dokumentierte Webhook-Ereignistypen. Sie garantieren nicht, dass jede Aktion aufgezeichnet wird.

#### Benutzeraktivitätsereignisse

| Ereignistyp | Beschreibung |
| - | - |
| `login` | Erfolgreiche Anmeldung |
| `query` | Suchanfrage gesendet |
| `answer_generated` | Antwort zurückgegeben |
| `file_upload` | Datei in eine Abfrage oder ein Projekt hochgeladen |
| `file_download` | Datei aus einem Projekt heruntergeladen |
| `file_delete` | Datei aus einer Abfrage oder einem Projekt gelöscht |

*Tabelle 2: Benutzeraktivitätsereignisse.*

Abfrageereignisse können `metadata.attachments` mit `file_uuid` und `file_name` für jede angehängte Datei enthalten.

#### Thread-Ereignisse

| Ereignistyp | Beschreibung |
| - | - |
| `thread_forked` | Thread kopiert |
| `thread_exported` | Thread exportiert |
| `thread_shared` | Thread geteilt |
| `thread_deleted` | Thread gelöscht |

*Tabelle 3: Thread-Ereignisse.*

#### Mitgliedschaftsereignisse

| Ereignistyp | Beschreibung |
| - | - |
| `member_invited` | Mitglied eingeladen |
| `member_invite_rescinded` | Ausstehende Einladung zurückgezogen |
| `member_removed` | Mitglied entfernt |
| `member_role_changed` | Rolle eines Mitglieds geändert |

*Tabelle 4: Mitgliedschaftsereignisse.*

#### Organisationsereignisse

| Ereignistyp | Beschreibung |
| - | - |
| `organization_settings_update` | Organisationseinstellung geändert |

*Tabelle 5: Organisationsereignisse.*

#### Rollen- und Gruppenereignisse

| Ereignistyp | Beschreibung |
| - | - |
| `role_created` | Benutzerdefinierte Rolle erstellt |
| `role_updated` | Rollendetails oder Berechtigungen aktualisiert |
| `role_deleted` | Benutzerdefinierte Rolle gelöscht |
| `role_users_changed` | Benutzer zu einer Rolle hinzugefügt oder daraus entfernt |
| `role_groups_changed` | Gruppen zu einer Rolle hinzugefügt oder daraus entfernt |
| `group_created` | Benutzergruppe erstellt |
| `group_deleted` | Benutzergruppe gelöscht |
| `group_members_changed` | Gruppenmitgliedschaft geändert |

*Tabelle 6: Rollen- und Gruppenereignisse.*

Bei `role_users_changed` und `role_groups_changed` können die Metadaten für `action` den Wert `added` oder `removed` enthalten. Verwenden Sie dieses Feld, um die Richtung einer Mitgliedschaftsänderung zu unterscheiden.

#### Ereignisse des Comet-Agenten

| Ereignistyp | Beschreibung |
| - | - |
| `comet_agent_action` | Automatisierte Comet-Aktion |

*Tabelle 7: Ereignisse des Comet-Agenten.*

#### Konnektorereignisse

| Ereignistyp | Beschreibung |
| - | - |
| `connector_connected` | Drittanbieter-Konnektor verbunden |
| `connector_disconnected` | Drittanbieter-Konnektor getrennt |

*Tabelle 8: Konnektorereignisse.*

#### Computer-Ereignisse

| Ereignistyp | Beschreibung |
| - | - |
| `computer_task_started` | Computer-Aufgabe gestartet |
| `computer_agent_action` | Automatisierte Aktion während einer Aufgabe |
| `computer_task_completed` | Aufgabe erfolgreich abgeschlossen |
| `computer_task_error` | Aufgabe mit einem Fehler fehlgeschlagen |

*Tabelle 9: Computer-Ereignisse.*

### Beispiel für Webhook-Nutzdaten

Diese beispielhaften JSON-Nutzdaten stellen ein Abfrageereignis dar, das an einen generischen Webhook übermittelt wird.

```json theme={null}
{
  "uuid": "6ba7b810-9dad-41d1-80b4-00c04fd430c8",
  "timestamp": "2026-10-28T09:05:31+00:00",
  "event_type": "query",
  "user_email": "member@example.com",
  "ip_address": "203.0.113.45",
  "user_agent": "ExampleClient/1.0",
  "session_id": "query_abc123",
  "metadata": {
    "query_str": "What are the best practices for API security?"
  }
}
```

## Plattformspezifische Formatierung

### Slack-Webhooks

Bei einer Webhook-URL, die mit `https://hooks.slack.com` beginnt, verwendet Perplexity das Block-Kit-Format von Slack. Das Array `blocks` enthält Abschnitte für den Ereignistyp, Mitglieds- und Clientdetails sowie Ereignismetadaten, sofern vorhanden.

In den Ereignistypbezeichnungen werden Wortanfänge großgeschrieben und Unterstriche entfernt. Die Slack-Formatierung kürzt einzelne Metadatenwerte auf 500 Zeichen und den Metadatenabschnitt auf 2.500 Zeichen; lange Werte erhalten einen Kürzungshinweis.

### Splunk HTTP Event Collector

Wenn der Autorisierungswert mit `Splunk` beginnt, bettet Perplexity die Nutzdaten für den HTTP Event Collector (HEC) von Splunk in ein `event`-Objekt ein. Dieses Beispiel zeigt die Umhüllung:

```json theme={null}
{
  "event": {
    "uuid": "a1b2c3d4-e5f6-4789-abcd-ef1234567890",
    "timestamp": "2026-10-28T09:05:31+00:00",
    "event_type": "login",
    "user_email": "member@example.com",
    "ip_address": "203.0.113.45",
    "user_agent": "ExampleClient/1.0",
    "session_id": null,
    "metadata": {}
  }
}
```

### Generische Webhooks

Bei anderen Webhook-Zielen sendet Perplexity die standardmäßigen JSON-Nutzdaten ohne plattformspezifische Umhüllung. Das Format finden Sie unter [Beispiel für Webhook-Nutzdaten](#webhook-payload-example).

## Häufige Webhook-Szenarien

### Recherchesitzungen nachverfolgen

Verwenden Sie `session_id`, um eine Abfrage ihrer Antwort zuzuordnen.

**1. Abfrageereignis finden**

Lesen Sie `query_str` in den Metadaten des Ereignisses. Notieren Sie die zugehörige `session_id`, um zusammengehörige Ereignisse zu finden.

**2. Antwortereignis zuordnen**

Suchen Sie das Ereignis `answer_generated` mit derselben `session_id`. Sofern aufgezeichnet, enthält `answer` bis zu den ersten 500 Zeichen der Antwort; daneben ist das verwendete `model` angegeben.

### Dateizugriff überwachen

Verwenden Sie Dateikennungen, um Uploads und Downloads einander zuzuordnen. Die Metadaten von Webhook-Ereignissen können aufgezeichnete Datei- und Projektdetails enthalten.

**1. Datei-Upload finden**

Lesen Sie die `file_uuid` des Upload-Ereignisses. Notieren Sie die Kennung für den Vergleich mit nachfolgenden Ereignissen.

**2. Datei-Downloads zuordnen**

Suchen Sie Download-Ereignisse mit derselben `file_uuid`. Anhand der Felder für den Akteur und den Zeitstempel erkennen Sie, wer wann auf die Datei zugegriffen hat.

### Konfigurationsänderungen prüfen

Bei `organization_settings_update` gibt der `key` der Einstellung an, was geändert wurde. Webhook-Metadaten können `old_value` und `new_value` enthalten.

Filtern Sie gespeicherte Webhook-Daten in Ihrem eigenen Analysesystem nach `user_email`, um nachzuverfolgen, welche Administratoren Änderungen vorgenommen haben.

## Bewährte Verfahren

### Ihren Webhook-Endpunkt implementieren

* **Zeitnah antworten**: Bestätigen Sie den Empfang innerhalb von 1 Sekunde.
* **Asynchron verarbeiten**: Stellen Sie empfangene Ereignisse zur Verarbeitung in eine Warteschlange.
* **Nutzdaten validieren**: Prüfen Sie Struktur und Inhalt vor der Übernahme.
* **Endpunkt absichern**: Verwenden Sie HTTPS und validieren Sie den konfigurierten Authentifizierungswert.
* **Fehler überwachen**: Protokollieren Sie Fehler auf Empfängerseite und untersuchen Sie Übermittlungslücken.

### Gesammelte Protokolle speichern und analysieren

* **Aufbewahrungsrichtlinie festlegen**: Bewahren Sie gesammelte Protokolle so lange auf, wie Ihre Organisation es erfordert.
* **Relevante Felder indizieren**: Verwenden Sie Felder für Ereignistyp, Akteur, Zeitstempel und Sitzung zur Analyse.
* **Aktivitäten korrelieren**: Verknüpfen Sie zusammengehörige Ereignisse über `session_id`.
* **Muster überwachen**: Untersuchen Sie ungewöhnliche Zugriffe oder administrative Änderungen.
* **Sicherungskopien pflegen**: Bewahren Sie Kopien gemäß den Sicherheits- und Datenschutzrichtlinien Ihrer Organisation auf.

## Fehlerbehebung

| Symptom | Mögliche Ursache | Nächster Schritt |
| - | - | - |
| Keine Webhook-Ereignisse | Die Protokollierung oder Endpunktkonfiguration ist möglicherweise unvollständig | Prüfen Sie, ob die Protokollierung aktiviert und ein HTTPS-Endpunkt gespeichert ist |
| Der Endpunkt gibt HTTP `4xx` oder `5xx` zurück | Der empfangende Endpunkt hat die Anfrage abgelehnt oder einen Fehler festgestellt | Prüfen Sie die Protokolle des Empfängers und den konfigurierten Authentifizierungswert |
| Fehlende Ereignisse nach einem Übermittlungsfehler | Fehlgeschlagene Übermittlungen werden nicht automatisch wiederholt | Überwachen Sie Fehler beim Empfänger; verlassen Sie sich nicht auf eine automatische Wiederholung |

*Tabelle 10: Häufige Probleme bei der Webhook-Übermittlung.*

Wenn Sie den Support kontaktieren, geben Sie den genauen Fehler, den Zeitpunkt des betroffenen Ereignisses oder Übermittlungsfehlers, die Zeitzone und die bereits versuchten Schritte an. Lassen Sie Authentifizierungswerte, Token und vertrauliche Ereignisinhalte weg.

## Häufig gestellte Fragen

### Kann ich Audit-Protokolle mit weniger als 50 Plätzen verwenden?

Ja. Eine Organisation mit weniger als 50 Plätzen kann auf Audit-Protokolle zugreifen, wenn mindestens ein Platz den Tarif Enterprise Max verwendet. Die Voraussetzungen finden Sie unter [Was ist Enterprise Max?](https://www.perplexity.ai/help-center/help-center/de/articles/12310544-was-ist-enterprise-max.md).

### Was kann ich tun, wenn ich Audit-Protokolle versehentlich aktiviert habe und eine unerwartete Gebühr sehe?

Wenden Sie sich an Ihr Account-Team oder nutzen Sie [**Hilfe > Support kontaktieren**](https://www.perplexity.ai/?support=true#settings/account), um die Gebühr und einen möglichen Erstattungsanspruch prüfen zu lassen. Siehe [Rückerstattungen](https://www.perplexity.ai/help-center/help-center/de/articles/10354288-ruckerstattungen.md); das Deaktivieren von Audit-Protokollen ist keine Zusage für eine Stornierung der Abrechnung.

## Weiterführende Referenzen

* [Enterprise-Rollen und Berechtigungen](https://www.perplexity.ai/help-center/help-center/de/articles/11187754-unternehmensrollen-und-berechtigungen.md)
* [Was ist Enterprise Max?](https://www.perplexity.ai/help-center/help-center/de/articles/12310544-was-ist-enterprise-max.md)
* [Datenaufbewahrung und Datenschutz für Enterprise](https://www.perplexity.ai/help-center/help-center/de/articles/11187708-datenspeicherung-und-datenschutz-fur-unternehmensorganisationen-und-benutzer.md)
* [Datenaufbewahrung für Enterprise](https://www.perplexity.ai/help-center/help-center/de/articles/11652701-datenaufbewahrung-fur-enterprise.md)

## Benötigen Sie weitere Hilfe?

Wenden Sie sich an Ihr Account-Team oder [kontaktieren Sie uns über **Hilfe > Support kontaktieren**](https://www.perplexity.ai/?support=true#settings/account). Im [**Trust Center**](https://trust.perplexity.ai) finden Sie Dokumentation zu Sicherheit und Compliance.


## Related topics

- [Enterprise-Rollen und Berechtigungen](https://www.perplexity.ai/help-center/help-center/de/articles/11187754-unternehmensrollen-und-berechtigungen.md)
- [Rollenbasierte Zugriffskontrolle für Konnektoren](https://www.perplexity.ai/help-center/help-center/de/articles/2026100201-rollenbasierte-zugriffskontrolle-fur-konnektoren.md)
- [Erste Schritte mit der sicheren FedRAMP 20x-Konfiguration](https://www.perplexity.ai/help-center/help-center/de/articles/14714627-erste-schritte-mit-der-sicheren-fedramp-20x-konfiguration.md)
- [Enterprise-Admin-Hub](https://www.perplexity.ai/help-center/help-center/de/enterprise.md)