> For the complete documentation index, see [llms.txt](https://doc.dastra.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.dastra.eu/de/features/settings/siem.md).

# SIEM-Streaming

Übertragen Sie die Sicherheits-Auditereignisse Ihres Kontos in Echtzeit an Ihr SIEM

## Überblick

Das SIEM-Streaming überträgt **die Sicherheits-Auditereignisse Ihres Dastra-Kontos in Echtzeit an Ihr SIEM**: Anmeldungen, Berechtigungsänderungen, API-Schlüssel, MFA- und SSO-Änderungen, Löschungen von Nutzern und Mandanten usw. Alle Auditereignisse des Kontos werden übertragen, damit Ihr Sicherheitsteam den vollständigen Verlauf in dem Tool hat, das es bereits überwacht (Splunk, Sentinel, Sumo Logic, QRadar …).

Unabhängig vom Streaming können die Auditprotokolle auch **manuell in SIEM-Formaten exportiert** werden: siehe [Manueller Export](#manueller-export-aus-den-auditprotokollen) weiter unten.

## Voraussetzungen

* Der **Enterprise-Tarif** (Funktion „“).
* Sie müssen **Eigentümer** des Kontos sein: Die Konfiguration befindet sich im **Sicherheitscenter**, unten auf der Seite **Sicherheit** (Abschnitt **SIEM-Ereignis-Streaming**). Die Karte **SIEM-Streaming** im Integrationskatalog öffnet ebenfalls diesen Abschnitt.
* Auf SIEM-Seite: ein über HTTPS erreichbarer HTTP-Event-Collector-Endpunkt (z. B. ein Splunk-HEC-Endpunkt) sowie dessen Token oder API-Schlüssel.

<figure><img src="https://1094947073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgG4SiA7dB1sjSI91cItk%2Fuploads%2Fgit-blob-1a12457c3e5918e7b24c191902eca604db4ec018%2Fsiem-menu.png?alt=media" alt="Der Abschnitt SIEM-Ereignis-Streaming unten auf der Seite Sicherheit"><figcaption><p>Der Abschnitt SIEM-Ereignis-Streaming unter Sicherheitscenter > Sicherheit</p></figcaption></figure>

## Konfiguration

Aktivieren Sie **Echtzeit-Streaming aktivieren**: Das Formular erscheint. Füllen Sie es aus und klicken Sie auf **Speichern**:

* **Endpunkt des Datenerfassers** (Pflichtfeld): die HTTP(S)-URL Ihres SIEM-Collectors, z. B. `https://collector.example.com/services/collector/event` für Splunk HEC.
* **Authentifizierung**: wie das Token mit jedem Ereignis gesendet wird:
  * **Bearer**: `Authorization: Bearer <Token>` (Standard),
  * **API-Schlüssel**: `Authorization: ApiKey <Token>`,
  * **Autorisierung mit benutzerdefiniertem Schema**: `Authorization: <Schema> <Token>`, wobei Sie das Wort des **Berechtigungsschemas** angeben (z. B. `Splunk` für einen Splunk-HEC-Input, `Api-Token` für Dynatrace),
  * **Personalisierte Kopfzeile**: Das Token wird in dem Header gesendet, den Sie unter **Name der Überschrift** angeben (z. B. `X-API-Key`),
  * **Keine**: kein Authentifizierungs-Header (z. B. wenn das Token Teil der URL ist).
* **API-Token / API-Schlüssel**: das Token des Collectors. Es wird verschlüsselt gespeichert und nie wieder angezeigt; lassen Sie das Feld später leer, um das aktuelle beizubehalten.
* **Personalisierbare Kopfzeile (optional)**: zusätzliche HTTP-Header, die mit jedem Ereignis gesendet werden, als Schlüssel/Wert-Paare.
* **Format der Ereignisse**:
  * **Splunk HEC (JSON)**: das native Format des Splunk HTTP Event Collector. Zwei weitere optionale Felder erscheinen: **Quellentyp (optional)** (Standard `dastra:audit`) und **Inhaltsverzeichnis (optional)** (der Index).
  * **Dynatrace (Log Monitoring v2)**: das native Format der Dynatrace-Log-Ingest-API.
  * **CEF (Common Event Format)**: für ArcSight, Sumo Logic und die meisten SIEM, die CEF verarbeiten.
  * **Syslog (RFC 5424)**: strukturierte Syslog-Zeilen.
* **Niedriger Schweregrad**: die niedrigste Stufe, die noch übertragen wird: **Alle Veranstaltungen**, **Hinweise und mehr**, **Warnungen und mehr (Sicherheitsereignisse)** oder **Fehler und mehr**. Die Standardstufe, die auch die empfohlene ist, lautet **Warnungen und mehr**: Sie behalten die sicherheitsrelevanten Signale (fehlgeschlagene Anmeldungen, Änderungen an Berechtigungen, SSO/MFA, API-Schlüsseln, Löschungen …), ohne Ihr SIEM mit alltäglicher Aktivität zu überfluten. Wählen Sie *Alle Veranstaltungen* nur, wenn Ihr SIEM den vollständigen Auditverlauf verarbeiten soll.
* **Überprüfen Sie das TLS-Zertifikat**: Lassen Sie die Option aktiviert; deaktivieren Sie sie nur für einen selbstsignierten Entwicklungs-Collector.

Ist bereits eine Konfiguration vorhanden, aktiviert oder deaktiviert derselbe Schalter das Streaming sofort. **Deinstallieren** löscht die Konfiguration.

{% hint style="info" %}
**Gängige Beispiele.** Splunk HEC: Endpunkt `https://<Host>:8088/services/collector/event`, Format *Splunk HEC (JSON)*, Authentifizierung *Bearer* (oder *Autorisierung mit benutzerdefiniertem Schema* + `Splunk` für klassische HEC-Inputs). Dynatrace: Endpunkt `https://<Umgebung>.live.dynatrace.com/api/v2/logs/ingest`, Format *Dynatrace (Log Monitoring v2)*, Authentifizierung *Autorisierung mit benutzerdefiniertem Schema* + `Api-Token`.
{% endhint %}

<figure><img src="https://1094947073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgG4SiA7dB1sjSI91cItk%2Fuploads%2Fgit-blob-58aaff9826552cb9cc7c065ecf298f1c55eafbab%2Fsiem-form.png?alt=media" alt="Das Konfigurationsformular für das SIEM-Streaming"><figcaption><p>Konfiguration des SIEM-Streamings</p></figcaption></figure>

## Verbindung testen

**Verbindung testen** sendet ein synthetisches Testereignis mit den Werten des Formulars an Ihren Collector und zeigt das Ergebnis an („Testereignis erfolgreich abgeschlossen“ oder den vom Collector zurückgegebenen HTTP-Fehler). Nutzen Sie die Funktion nach jeder Änderung: Der Test erfordert nicht, dass das Streaming aktiviert ist.

{% hint style="info" %}
Das Streaming gilt für das gesamte Konto (alle Mandanten). Es gibt eine SIEM-Konfiguration pro Konto.
{% endhint %}

## Inhalt der Ereignisse

Jedes Auditereignis wird einzeln und fortlaufend mit folgendem Inhalt zugestellt:

| Feld                                                    | Inhalt                                                            |
| ------------------------------------------------------- | ----------------------------------------------------------------- |
| `id`                                                    | Eindeutige Kennung des Auditereignisses                           |
| `time` / `timestamp`                                    | Zeitpunkt des Ereignisses (UTC)                                   |
| `action`                                                | Ereignistyp, z. B. `UserLogin`, `PermissionChange`, `ApiKeyAdded` |
| `message`                                               | Lesbare Beschreibung                                              |
| `objectType` / `objectId`                               | Betroffener Datensatz, falls vorhanden                            |
| `severity`                                              | Schweregrad nach Syslog-Art (siehe unten)                         |
| `outcome`                                               | `success` oder `failure`                                          |
| `actorId` / `actorName` / `actorEmail`                  | Wer die Aktion durchgeführt hat                                   |
| `tenantId` / `workspaceId` / `workspaceName` / `areaId` | Wo sie stattgefunden hat                                          |
| `url`                                                   | Direktlink zum Datensatz in Dastra                                |

Sicherheitsrelevante Ereignisse werden unabhängig von ihrer Anzeigepriorität in Dastra im Schweregrad angehoben: Wiederholte fehlgeschlagene Anmeldungen werden als **Error** gesendet (mit `outcome: failure`); Berechtigungsänderungen, das Erstellen/Löschen von API-Schlüsseln, MFA- und SSO-Änderungen, Sperrungen und Löschungen von Nutzern sowie Löschungen von Mandanten werden als **Warning** gesendet. Auf diesem Schweregrad beruht auch die Einstellung **Niedriger Schweregrad**: *Warnungen und mehr* (die empfohlene Einstellung) beschränkt den Datenstrom auf diese Sicherheitsereignisse.

{% hint style="info" %}
Die Ereignisse enthalten Namen und E-Mail-Adresse des Urhebers der Aktion, also Informationen, die bereits im Dastra-Auditprotokoll angezeigt werden. Es werden keine Dateninhalte (personenbezogene Daten von Betroffenen, Dokumentinhalte …) übertragen.
{% endhint %}

## Manueller Export aus den Auditprotokollen

Sie können den Sicherheits-Auditverlauf bei Bedarf in denselben Formaten exportieren, ohne das Streaming zu konfigurieren:

1. Öffnen Sie **Sicherheitscenter > Sicherheitsprotokolle**.
2. Stellen Sie die Filter (Zeitraum, Mandant …) nach Bedarf ein.
3. Öffnen Sie das Menü **Exportieren (SIEM)** neben der üblichen Export-Schaltfläche und wählen Sie **CEF (Common Event Format)**, **Syslog (RFC 5424)** oder **Splunk HEC (JSON)**.

Die Datei (`dastra-security-logs-<Datum>`) enthält die passenden Auditereignisse, bis zu 100.000, und kann direkt in Ihr SIEM eingelesen werden.

Dasselbe Menü bietet außerdem **Einrichten des Echtzeit-Streamings**, eine Verknüpfung zur oben beschriebenen Streaming-Konfiguration.

<figure><img src="https://1094947073-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgG4SiA7dB1sjSI91cItk%2Fuploads%2Fgit-blob-915e4c46540dc378918b52fa31d307710109d8ff%2Faudit-logs-export-siem.png?alt=media" alt="Das Menü Exportieren (SIEM) der Seite Sicherheitsprotokolle"><figcaption><p>Einmaliger SIEM-Export aus den Sicherheitsprotokollen</p></figcaption></figure>

## Fehlerbehebung

* **Test fehlgeschlagen: HTTP 401/403**: Prüfen Sie Token und Authentifizierungsschema, die Ihr Collector erwartet (Splunk HEC erwartet das Token so, wie es im HEC-Input konfiguriert ist; manche Collector erwarten einen benutzerdefinierten Header).
* **Test fehlgeschlagen: Zertifikatsfehler**: Ihr Collector verwendet ein Zertifikat, das Dastra nicht prüfen kann. Korrigieren Sie die Zertifikatskette; deaktivieren Sie **Überprüfen Sie das TLS-Zertifikat** nur für einen Entwicklungs-Collector.
* **Es kommen keine Ereignisse an**: Prüfen Sie, ob **Echtzeit-Streaming aktivieren** eingeschaltet ist, und sehen Sie in den Ingest-Protokollen Ihres Collectors nach. Mit **Verbindung testen** trennen Sie Konnektivität und Konfiguration.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://doc.dastra.eu/de/features/settings/siem.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
