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

# Ubiquiti UniFi Network

> UniFi-Network-Syslog weiterleiten (SIEM-CEF oder klassische Gateway-Protokollierung)

## Einrichtung

1. Folgen Sie der gemeinsamen Anleitung [Log-Forwarder](https://docs.wirespeed.co/de/integrations/log-forwarders.md), um **Ubiquiti UniFi Network** hinzuzufügen und die **Forwarder-Details** zu öffnen (oder fragen Sie im Chat nach `ip:port` des Listeners)
2. Richten Sie die UniFi-Protokollierung mit den unten beschriebenen Optionen auf die Wirespeed-IP und den Port aus den **Forwarder-Details** aus
3. Ereignisse sollten in Kürze unter **Ereignisse** erscheinen

> [!NOTE]
>
> Die unten genannten Navigations- und Feldbezeichnungen entsprechen UniFi OS 5.1.x und Network 10.6.x. UniFi bietet zwei Syslog-Seiten, die unterschiedliche Ereignisklassen senden.

> [!WARNING]
>
> Wenn Sie **dieselben** Protokollkategorien über beide Seiten an denselben Wirespeed-Listener senden, entstehen doppelte Ereignisse (insbesondere bei **Updates**). Sie können beide Seiten verwenden, wenn Sie UniFi-OS-Ereignisse **und** Gateway-/Sicherheitsprotokolle benötigen – aktivieren Sie überlappende Kategorien nur auf einer Seite. Wenn Duplikate auftreten, deaktivieren Sie das zusätzliche Syslog-Ziel.

### Option A – Integrations: System Logging / SIEM (CEF)

Verwenden Sie diesen Weg für Systemereignisse von UniFi OS im CEF-Format. Er umfasst keine Firewall- oder Sicherheitsdetektionen – diese finden Sie unter Option B.

1. Öffnen Sie in UniFi Network **Integrations** → **System Logging / SIEM**
2. Wählen Sie **SIEM Server**
3. Wählen Sie die Protokollkategorien – mindestens **System** (unter **UniFi OS**; ebenfalls verfügbar: **Updates**, **Admins**, **Backups**, **Users**)
4. Geben Sie die **IP Address** des Wirespeed-Listeners aus den **Forwarder-Details** ein
5. Geben Sie den **Port** des Wirespeed-Listeners ein
6. Klicken Sie auf **Save**

### Option B – CyberSecure: Traffic Logging (klassisches Gateway-Syslog)

Verwenden Sie diesen Weg für Gateway-Firewall, DHCP und **Security Detections**. Dieser Weg deckt Firewall-Richtlinien- und Sicherheitsprotokolle ab.

1. Öffnen Sie in UniFi Network **CyberSecure** → **Traffic Logging**
2. Wählen Sie unter **Activity Logging (Syslog)** die Option **SIEM Server**
3. Wählen Sie die Kategorien unter **Contents** – zum Beispiel **Gateway**, **Security Detections**, **Firewall Default Policy**, **Updates** und **Critical**
4. Lassen Sie **Debug Logs** deaktiviert, sofern Sie keine Fehlerbehebung durchführen
5. Geben Sie die **Server Address** des Wirespeed-Listeners aus den **Forwarder-Details** ein
6. Geben Sie den **Port** des Wirespeed-Listeners ein
7. Speichern Sie die Konfiguration

Wirespeed erkennt das Format pro Ereignis automatisch: **CEF**, wenn die Zeile `CEF:0|…` enthält, andernfalls **klassisches** UniFi-Syslog.

> [!NOTE]
>
> UniFi Access und UniFi Protect werden von dieser Integration nicht abgedeckt.


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