Wazuh 5 und n8n: Findings per KI bewerten und das SOC per E-Mail alarmieren

Wazuh 5 meldet Sicherheitsereignisse nicht mehr über den Manager, sondern über den Indexer. Wer bisher Alarme per Webhook an n8n geschickt hat, muss deshalb umbauen. Dieser Beitrag zeigt Schritt für Schritt, wie Wazuh 5 neue Findings der Stufe high oder critical an n8n meldet, eine KI sie bewertet und ein SOC-Mitarbeiter eine kurze, verständliche E-Mail bekommt, und zwar nur eine pro Angriff, keine Flut.

Als Auslöser dient ein echter SSH-Brute-Force-Angriff in einem Testnetz. Am Ende steht ein lauffähiger Workflow mit sechs Nodes.

Hinweis: Wazuh 5 ist zum Zeitpunkt dieses Beitrags noch eine Vorabversion (Beta / Release Candidate). Menüpfade, Indexnamen und Feldnamen können sich bis zur finalen Version ändern. Setzen Sie den Aufbau zunächst in einer Testumgebung um und prüfen Sie die Details nach jedem Update erneut.

Ausgangssituation

In Wazuh 4 war die Anbindung einfach: Ein <integration>-Block in der ossec.conf des Managers rief für jeden Alarm ab einer bestimmten Stufe ein Skript auf, das den Alarm per Webhook an n8n schickte. In Wazuh 5 funktioniert das nicht mehr, weil sich die Architektur grundlegend geändert hat:

Wazuh 4Wazuh 5
Meldung nach außenDaemon wazuh-integratord im ManagerNotifications- und Alerting-Modul im Indexer
Konfiguration<integration> in /var/ossec/etc/ossec.confDashboard: Explore > Notifications und Explore > Alerting
Was gemeldet wirdjeder einzelne AlarmErgebnis eines geplanten Monitors (Abfrage auf den Index)
ErkennungWazuh-Regeln mit Level 0–15Sigma-Regeln, Ergebnis heißt Finding, Stufen informational bis critical
DatenformatWazuh-Alert-JSONWazuh Common Schema (WCS), angelehnt an ECS

Findings übernehmen in Wazuh 5 die Rolle der früheren Alerts. Sie liegen in den Indizes wazuh-findings-v5-*, die Stufe steht im Feld wazuh.rule.level.

Unser Testaufbau

RolleSystemIP-Adresse
Wazuh 5 (Manager, Indexer, Dashboard)All-in-One, Release Candidate192.168.171.37
Überwachter Server mit Wazuh-Agent und SuricataUbuntu Server192.168.171.33
„Angreifer“Linux-Rechner im selben Netz192.168.171.38
n8nSelf-hosted, Version 2.42, hinter Reverse-Proxyn8n.example.com
KI-ModellClaude Sonnet 5.5 über die Anthropic-API–
E-Mail-VersandGmail-Node in n8n–

Suricata erkennt auf dem Ubuntu-Server verdächtige Netzwerkmuster. Der Wazuh-Agent schickt diese Meldungen an Wazuh, das daraus Findings erzeugt.

Architektur

Architektur

Der Monitor schickt nur die Anzahl der neuen Findings an n8n. Die Findings selbst holt sich n8n anschließend aus dem Indexer, bündelt sie zu Angriffen und lässt pro Angriff genau eine E-Mail schreiben.

Schritt 1: Indexer für n8n erreichbar machen

n8n holt die Findings später selbst per REST-API aus dem Indexer (Port 9200). Dafür braucht es zwei Dinge: einen Indexer, der Verbindungen aus dem Netz annimmt, und einen Benutzer, der nur lesen darf.

1. HTTP-Port des Indexers öffnen

Bei einer All-in-One-Installation lauscht der Indexer nur auf 127.0.0.1. n8n bekommt dann „Connection refused“. Prüfen Sie das auf dem Wazuh-Server:

ss -tlnp | grep 9200
Bash

Steht dort 127.0.0.1:9200, ergänzen Sie in /etc/wazuh-indexer/opensearch.yml:

http.host: 0.0.0.0
TeX

Nehmen Sie bewusst http.host und nicht network.host. So bleibt die interne Cluster-Kommunikation lokal, und OpenSearch aktiviert keine zusätzlichen Startprüfungen, an denen der Neustart scheitern könnte.

sudo systemctl restart wazuh-indexer
Bash

Geben Sie Port 9200 in der Firewall anschließend nur für den n8n-Server frei, z. B. mit ufw allow from <IP-n8n> to any port 9200 proto tcp.

2. Lesebenutzer anlegen

n8n soll Findings lesen, aber nichts verändern können. Legen Sie im Dashboard unter Indexer management > Security an:

  1. eine Rolle n8n_findings_read mit der Index-Berechtigung read auf wazuh-findings-v5-*,
  2. einen internen Benutzer n8n mit starkem Passwort,
  3. die Zuordnung der Rolle zu diesem Benutzer.

Test vom n8n-Server aus:

curl -k -u n8n https://<WAZUH-INDEXER>:9200/wazuh-findings-v5-*/_count
Bash

Kommt eine Trefferzahl zurück, ist der Zugriff eingerichtet.

Schritt 2: Webhook-Channel in Wazuh 5 anlegen

Der Channel legt fest, wohin Wazuh meldet. Legen Sie zuerst in n8n einen neuen Workflow mit einem Webhook-Node an (Methode POST), aktivieren Sie den Workflow und kopieren Sie die Production URL.

Im Wazuh-Dashboard:

  1. Explore > Notifications > Channels > Create channel
  2. Name: z. B. n8n High Findings
  3. Channel type: Custom webhook
  4. URL: die Production URL aus n8n, z. B. https://n8n.example.com/webhook/<id>
  5. Methode: POST, Header: Content-Type: application/json
  6. Create
Channel erstellen

Den Request schickt der Indexer, nicht der Manager. Firewall-Regeln müssen also Verbindungen vom Indexer zu n8n erlauben.

Stolperfalle: „Send test message“ im Channel schlägt mit 500 – Unprocessable Entity fehl. Wazuh schickt dabei einen festen Klartext, n8n erwartet wegen des Headers aber JSON und lehnt ab. Der Channel ist trotzdem korrekt eingerichtet. Testen Sie stattdessen später aus dem Monitor heraus, dort wird Ihr JSON-Template gesendet.

Schritt 3: Monitor für High- und Critical-Findings

Der Monitor prüft alle 5 Minuten, ob es neue Findings der Stufe high oder critical gibt. Wenn ja, stößt er n8n an. Die Findings selbst schickt er nicht mit, die holt n8n im nächsten Schritt. So bleibt die Webhook-Nachricht klein und immer gültiges JSON.

  1. Explore > Alerting > Monitors > Create monitor
  2. Name: n8n - High Findings, Monitor type: Per query monitor, Defining method: Extraction query editor
  3. Schedule: By interval, alle 5 Minuten
  4. Index: wazuh-findings-v5-*
  5. Abfrage:
{
  "size": 0,
  "query": {
    "bool": {
      "filter": [
        { "terms": { "wazuh.rule.level": ["high", "critical"] } },
        { "range": { "@timestamp": {
            "gte": "{{period_end}}||-10m",
            "lte": "{{period_end}}",
            "format": "epoch_millis" } } }
      ]
    }
  }
}
YAML
Monitor einrichten
Query einrichten
  1. Add trigger: Name High Findings, Severity 1, Trigger condition:
ctx.results[0].hits.total.value > 0
TeX
  1. Add action: Channel n8n High Findings, Message:
{
  "monitor": "{{ctx.monitor.name}}",
  "count": {{ctx.results.0.hits.total.value}},
  "period_start": "{{ctx.periodStart}}",
  "period_end": "{{ctx.periodEnd}}"
}
YAML
Actions einrichten

Das Zeitfenster (10 Minuten) ist bewusst größer als das Intervall (5 Minuten). Detectors erzeugen Findings mit etwas Verzögerung, und ein Finding darf nicht zwischen zwei Läufen durchfallen. Doppelte Meldungen filtert später n8n.

Prüfen: Mit Run im Monitor-Editor sehen Sie die Trefferzahl (hits.total.value). Bleibt sie trotz vorhandener Findings bei 0, stimmt der Feldname nicht. Prüfen Sie ihn in Discover an einem echten Finding.

Schritt 4: Der n8n-Workflow

Der Workflow besteht aus sechs Nodes:

NodeTypAufgabe
WebhookWebhook (POST)nimmt den Aufruf des Wazuh-Monitors entgegen
HTTP RequestHTTP Requestholt die High- und Critical-Findings der letzten 15 Minuten aus dem Indexer
Findings aufteilenSplit Outmacht aus der Trefferliste einzelne Items
Duplikate entfernenCodebündelt Findings zu Angriffen und unterdrückt Wiederholungen
KI-BewertungBasic LLM Chain + Anthropic Chat Modelbewertet den Angriff und schreibt den Mailtext
Send a messageGmailverschickt die E-Mail an das SOC
n8n Workflow

HTTP Request

  • Methode POST, URL https://<WAZUH-INDEXER>:9200/wazuh-findings-v5-*/_search
  • Authentication: Generic Credential Type > Basic Auth mit dem Benutzer n8n aus Schritt 1
  • Option Ignore SSL Issues, falls der Indexer ein selbstsigniertes Zertifikat nutzt
  • Body (JSON):
{
  "size": 100,
  "sort": [{ "@timestamp": "asc" }],
  "query": {
    "bool": {
      "filter": [
        { "terms": { "wazuh.rule.level": ["high", "critical"] } },
        { "range": { "@timestamp": { "gte": "now-15m" } } }
      ]
    }
  }
}
YAML

Findings aufteilen

Split Out mit dem Feld hits.hits. Danach ist jedes Finding ein eigenes Item.

Duplikate entfernen

Ein längerer Angriff erzeugt viele fast gleiche Findings, und das 15-Minuten-Fenster liefert dieselben Findings mehrfach. Ohne Filter käme für jedes Finding eine E-Mail. Der Code-Node fasst deshalb alle Findings mit gleicher Quell-IP, Ziel-IP und Meldung zu einem Angriff zusammen und merkt sich, wann er ihn zuletzt gemeldet hat:

  • Neuer Angriff: sofort eine E-Mail mit der Anzahl der Findings.
  • Angriff läuft ohne Pause weiter: eine Erinnerung pro Stunde.
  • Nach 15 Minuten Ruhe beginnt der Angriff erneut: Er gilt als neuer Angriff, die E-Mail kommt sofort. Das ist wichtig, wenn ein Angreifer z. B. mit einer neuen Wortliste weitermacht.

Mode: Run Once for All Items

const PAUSE_MINUTEN = 15;        // so lange Ruhe = nächster Angriff gilt als neu
const ERINNERUNG_MINUTEN = 60;   // Erinnerung bei ununterbrochenem Angriff

const MIN = 60 * 1000;
const jetzt = Date.now();
const speicher = $getWorkflowStaticData('global');
speicher.angriffe = speicher.angriffe || {};

for (const [key, a] of Object.entries(speicher.angriffe)) {
  if (jetzt - a.zuletztGesehen > 24 * 60 * MIN) delete speicher.angriffe[key];
}

const gruppen = {};
$input.all().forEach((item, index) => {
  const s = item.json._source || {};
  const key = [s.source?.ip, s.destination?.ip, s.message].join('|');
  const t = Date.parse(s['@timestamp']) || jetzt;
  if (!gruppen[key]) {
    gruppen[key] = {
      json: { _id: item.json._id, _source: s, anzahl: 0, erstes: s['@timestamp'], letztes: s['@timestamp'] },
      pairedItem: { item: index }, tErstes: t, tLetztes: t
    };
  }
  const g = gruppen[key];
  g.json.anzahl += 1;
  if (t >= g.tLetztes) { g.tLetztes = t; g.json.letztes = s['@timestamp']; }
  if (t < g.tErstes) { g.tErstes = t; g.json.erstes = s['@timestamp']; }
});

const ergebnis = [];
for (const [key, g] of Object.entries(gruppen)) {
  const a = speicher.angriffe[key];
  const neuerAngriff = !a || g.tLetztes - a.zuletztGesehen > PAUSE_MINUTEN * MIN;
  const erinnerung = !!a && g.tLetztes > a.zuletztGesehen && jetzt - a.zuletztGemeldet > ERINNERUNG_MINUTEN * MIN;
  if (neuerAngriff || erinnerung) {
    speicher.angriffe[key] = { zuletztGesehen: g.tLetztes, zuletztGemeldet: jetzt };
    ergebnis.push({ json: g.json, pairedItem: g.pairedItem });
  } else {
    a.zuletztGesehen = Math.max(a.zuletztGesehen, g.tLetztes);
  }
}
return ergebnis;
JavaScript

Das Gedächtnis ($getWorkflowStaticData) speichert n8n nur bei echten Produktionsläufen. Manuelle Tests im Editor senden deshalb jedes Mal eine E-Mail.

KI-Bewertung

Ein Basic LLM Chain-Node mit angehängtem Anthropic Chat Model (Modell claude-sonnet-5-5, Temperatur 0,2, maximal 4096 Tokens). Der API-Schlüssel kommt aus der Claude Console; ein Claude.ai-Abo enthält keinen API-Zugang. Prompt:

Du bist erfahrener SOC-Analyst. Bewerte das folgende Wazuh-Finding und schreibe daraus eine kurze E-Mail an einen IT-Mitarbeiter.

Gliedere sie genau so:
Risiko: kritisch, hoch, mittel oder niedrig
Fehlalarm wahrscheinlich: ja oder nein
Was ist passiert: 2 bis 4 Sätze
Was jetzt zu tun ist: höchstens 5 kurze Punkte

Schreibe sachlich auf Deutsch, als reinen Text ohne Markdown, ohne Anrede und ohne Grußformel. Erfinde nichts, was nicht im Finding steht.

Dieses Muster trat {{ $json.anzahl }}-mal auf, vom {{ $json.erstes }} bis {{ $json.letztes }}.

Finding:
{{ JSON.stringify($json._source) }}
TeX

Claude schreibt den Mailtext direkt. Ein Structured Output Parser, der ein festes JSON-Format erzwingt, ist nicht nötig und war in unseren Tests die häufigste Fehlerquelle.

Send a message (Gmail)

  • To: die Adresse des SOC, z. B. soc@example.com
  • Email Type: Text
  • Subject: [Wazuh HIGH] {{ $('Duplikate entfernen').item.json._source.message }} – {{ $('Duplikate entfernen').item.json.anzahl }} Findings
  • Message:
{{ $json.text }}

---
Finding-ID: {{ $('Duplikate entfernen').item.json._id }}
TeX

Speichern und auf Publish klicken. Echte Aufrufe aus Wazuh laufen immer mit der veröffentlichten Version.

Schritt 5: Test mit einem Brute-Force-Angriff

Als Auslöser simulieren wir vom Rechner 192.168.171.38 aus einen SSH-Brute-Force-Angriff auf den Ubuntu-Server, z. B. mit Hydra und einer kleinen Passwortliste:

 cd /usr/share/metasploit-framework/data/wordlists  
 sudo hydra -I -V -L namelist.txt -P password.lst 192.168.171.33 ssh
Bash

Führen Sie solche Tests ausschließlich gegen eigene Systeme in einer Testumgebung durch.

Was in Wazuh passiert

Suricata erkennt die vielen kurzen SSH-Verbindungen mit der Signatur ET SCAN LibSSH Based Frequent SSH Connections Likely BruteForce Attack. Daraus entstehen Findings im Index wazuh-findings-v5-security. In Discover sieht ein Finding so aus:

FeldWert
@timestampOct 8, 2026 @ 12:49:14
_index.ds-wazuh-findings-v5-security-000001
messageAttempted Administrator Privilege Gain
event.categorynetwork, intrusion_detection
event.typeallowed
source.ip192.168.171.38
destination.ip / destination.port192.168.171.33 / 22
network.protocolssh
wazuh.agent.host.hostnameubuntuserver
event.originalOriginal-Eintrag aus Suricatas eve.json, inkl. Signatur-ID 2006546

In unserem Test entstanden zwei solche Findings innerhalb einer Minute.

Was in n8n passiert

  1. Beim nächsten Lauf findet der Monitor die Findings und ruft den Webhook auf. Im Indexer-Log (/var/log/wazuh-indexer/wazuh-cluster.log) steht dann sendMessage:statusCode=200, statusText={"message":"Workflow was started"}.
  2. n8n holt die Findings, bündelt beide zu einem Angriff und lässt Claude ihn bewerten.
  3. Es kommt eine E-Mail mit dem Betreff [Wazuh HIGH] Attempted Administrator Privilege Gain – 2 Findings.

Auszug aus der Bewertung von Claude in unserem Test:

Risiko: mittel

Fehlalarm wahrscheinlich: ja

Was ist passiert: Suricata hat auf dem Agenten UbuntuSvr eine Verbindung von 192.168.171.38 zu 192.168.171.33 auf Port 22 (SSH) erkannt und die Signatur "ET SCAN LibSSH Based Frequent SSH Connections Likely BruteForce Attack" ausgelöst. Es handelt sich um eine einzelne Verbindung mit 7 Paketen und 544 Bytes, die Aktion lautete "allowed". Die Wazuh-Regel ordnet das als Privilege-Escalation-Versuch ein, die Signatur selbst ist jedoch als "Informational" mit mittlerer Konfidenz eingestuft. […]

Die Einschätzung ist nüchtern: Die KI erkennt, dass Suricata hier nur Verbindungsmuster sieht und kein erfolgreicher Login belegt ist.

Kontrolle bei Problemen: Prüfen Sie die Kette von vorn nach hinten. Gibt es Findings in Discover? Hat der Monitor ausgelöst? Gibt es in n8n unter Executions einen Lauf, und welcher Node ist rot?

Stolpersteine aus der Praxis

Diese Fehler sind uns beim Aufbau begegnet:

SymptomUrsacheLösung
„Send test message“ im Channel: 500 – Unprocessable EntityTestnachricht ist Klartext, n8n erwartet JSONignorieren, aus dem Monitor testen
Monitor löst nicht aus, obwohl Findings da sindZeitfenster kürzer als das Intervall (z. B. 1 Minute bei 5 Minuten Intervall)Fenster mindestens doppelt so lang wie das Intervall wählen
Alerting-Seiten im Dashboard bleiben leer, Log zeigt dynamic getter [java.time.ZonedDateTime, millis] not foundAnzeigefehler der Alerting-Oberfläche in der Vorabversionbetrifft nur die Anzeige; Status über die Alerting-API oder n8n prüfen
n8n: „The service refused the connection“Indexer lauscht nur auf 127.0.0.1http.host: 0.0.0.0 setzen (Schritt 1)
n8n: Node lässt sich nicht bearbeitenAnsicht einer alten Ausführung oder fremdes Credential im Nodein den Editor wechseln bzw. Node mit eigenem Credential neu anlegen
„Model output doesn’t fit required format“Structured Output Parser zu strengParser weglassen, KI schreibt den Mailtext direkt
Viele E-Mails für einen Angriffjedes Finding und jeder Monitor-Lauf löst eine Mail ausCode-Node „Duplikate entfernen“
Test im Editor wartet endlos („Waiting for you to call the Test URL“)Wazuh ruft die Production-URL auf, nicht die Test-URLin Executions einen Lauf öffnen und Debug in editor nutzen

Grenzen und Ausblick

  • Vorabversion: Wazuh 5 ist noch nicht final. Indexnamen wie wazuh-findings-v5-*, Feldnamen wie wazuh.rule.level und die Menüs können sich ändern. Prüfen Sie Monitor und HTTP-Request nach jedem Update.
  • Erfolgreiche Logins werden nicht erkannt: In unserem Test löste ein erfolgreicher SSH-Login kein Finding aus. Suricata sieht nur verschlüsselte Verbindungen, nicht deren Ausgang. Wer wissen will, ob ein Brute-Force-Angriff Erfolg hatte, braucht eine eigene Regel auf die sshd-Logs des Zielsystems, z. B. auf „Accepted password“. Regeln in Wazuh 5 prüfen laut Dokumentation einzelne Ereignisse; eine Regel „Fehlversuche, danach Erfolg“ ist damit nicht direkt abbildbar.
  • Datenschutz: Die KI bekommt das vollständige Finding, einschließlich IP-Adressen, Hostnamen und gegebenenfalls Benutzernamen. Klären Sie, ob diese Daten an einen Cloud-Anbieter gehen dürfen, oder setzen Sie ein lokales Modell ein.
  • KI als Ersteinschätzung: Die Bewertung ersetzt keine Prüfung durch einen Analysten. Sie hilft, die Meldung schneller einzuordnen.
  • Kosten: Jeder gemeldete Angriff ist ein API-Aufruf. Durch die Bündelung bleiben es wenige; ein Ausgabenlimit in der Claude Console ist trotzdem sinnvoll.

Fazit

Der Umstieg von Wazuh 4 auf Wazuh 5 erfordert ein Umdenken: Statt dass der Manager jeden Alarm einzeln verschickt, fragt ein Monitor im Indexer regelmäßig nach Findings und stößt n8n an. Mit einem Lesebenutzer, einem Webhook-Channel, einem Monitor und sechs n8n-Nodes entsteht daraus eine schlanke Alarmierung: eine verständliche, KI-bewertete E-Mail pro Angriff statt einer Flut von Einzelmeldungen.

Quellen

Schreibe einen Kommentar