Zum Inhalt springen

WireGuard: Firewall-Verbindung

Die Firewall-Verbindung ist der Weg für Firewalls mit WireGuard-Unterstützung: 9brains baut einen verschlüsselten WireGuard-Tunnel zu eurer Firewall auf. Was der On-Premise Connector kann und wie sich die beiden Verbindungswege unterscheiden, steht in der Übersicht.

  • Du bist Administrator im Workspace oder hast das Recht „On-Premise Connector verwalten“
  • Dein Workspace hat eine Business- oder Max-Lizenz
  • Eure Firewall unterstützt WireGuard (pfSense, OPNsense, Sophos, Fortinet, Unifi, MikroTik oder vergleichbar)
  • Ein UDP-Port auf der Firewall ist von außen erreichbar (Standard: 51820)

Kein WireGuard auf der Firewall? Nutze stattdessen die Connector-Software im Netzwerk. Dafür brauchst du weder WireGuard noch einen offenen Port.

Dein Firmennetzwerk 9brains Cloud
┌──────────────────────┐ ┌──────────────────────┐
│ │ WireGuard-Tunnel │ │
│ Datenbank ──────────│═══════════════════►│── Integration/Skill │
│ ERP-System ─────────│═══════════════════►│── Code-Ausführung │
│ Fileserver ─────────│═══════════════════►│── Datenindexierung │
│ │ (verschlüsselt) │ │
└──────────────────────┘ └──────────────────────┘
  1. Du konfigurierst einen WireGuard-Tunnel zwischen eurer Firewall und 9brains
  2. Du legst Services an, jeder Service zeigt auf ein internes System (z.B. Datenbank auf Port 5432)
  3. Du richtest eine Integration oder einen Skill ein, die den Service nutzt
  4. Die KI kann das System über den verschlüsselten Tunnel ansprechen

Wichtig: Die Verbindung ist nur ausgehend, 9brains verbindet sich zu euren Systemen. Euer Netzwerk kann keine Verbindungen zu uns initiieren.

  1. Gehe zu Einstellungen → On-Premise Connector
  2. Klicke auf „Tunnel anlegen”
  3. Fülle die Felder aus:
Feld Beschreibung
Name Ein aussagekräftiger Name (z.B. „Hauptstandort München”)
Endpoint Die öffentliche Adresse eurer Firewall mit WireGuard-Port (z.B. vpn.meinefirma.de:51820)
Public Key der Kunden-Firewall Der WireGuard Public Key eurer Firewall, findest du in der WireGuard-Konfiguration der Firewall
Source Peer IP Eine freie Adresse im Tunnel-Netz eurer Firewall, unter der 9brains dort auftritt (z.B. 10.0.0.2)
  1. Klicke auf „Tunnel erstellen”
  2. Es wird ein Public Key angezeigt, diesen musst du als Peer in eurer Firewall eintragen

Trage in der WireGuard-Konfiguration eurer Firewall einen neuen Peer ein:

Feld Wert
Public Key Der angezeigte Public Key aus 9brains (Kopieren-Button)
Allowed IPs Die Source Peer IP aus 9brains mit /32 (z.B. 10.0.0.2/32)
Endpoint Nicht nötig, 9brains initiiert die Verbindung

Hinweis: Die genaue Konfiguration variiert je nach Firewall-Hersteller. Schau in die Dokumentation deiner Firewall für die WireGuard-Peer-Konfiguration.

Ein Service beschreibt ein konkretes System, das über den Tunnel erreichbar ist.

  1. Öffne den Tunnel in der Detailansicht
  2. Klicke auf „Service hinzufügen”
  3. Fülle die Felder aus:
Feld Beschreibung
Name Anzeigename (z.B. „ERP-Datenbank”)
Protokoll Typ des Dienstes (PostgreSQL, HTTP, SMB, LDAP etc.)
Remote-Host Die interne IP oder der Hostname des Zielsystems (z.B. 192.168.10.5)
Remote-Port Der Port des Zielsystems, wird nach der Protokollwahl mit dem Standard belegt
Beschreibung Was enthält dieses System? Diese Information sieht die KI im Chat
  1. Klicke auf „Service hinzufügen”
  2. Der Service steht danach in der Liste des Tunnels. In Integrationen und Datenquellen wählst du ihn per Namen aus, Adresse und Port setzt 9brains selbst (siehe Dienst in Integration, Skill oder Datenquelle verwenden)

Tipp: Schreibe eine aussagekräftige Beschreibung. Die KI nutzt diese Information, um zu entscheiden, welches System für eine Frage relevant ist. Zum Beispiel: „Enthält Umsatz-, Kunden- und Artikeldaten seit 2019.“

  1. Klicke in der Tunnel-Detailansicht auf „Verbindung testen”
  2. Für jeden Service wird angezeigt:
    • Erreichbar: Verbindung erfolgreich, Latenz in Millisekunden
    • Nicht erreichbar: Verbindung fehlgeschlagen, mit dem Grund in Klartext und darunter der Meldung des Systems; mit „Details kopieren” übernimmst du beides samt Fehler-ID in eine Supportanfrage

Falls ein Service nicht erreichbar ist, prüfe:

  • Ist der WireGuard-Tunnel auf eurer Firewall aktiv?
  • Ist das Zielsystem eingeschaltet und erreichbar?
  • Sind die Allowed IPs auf der Firewall korrekt konfiguriert?
  • Erlaubt die Firewall Traffic vom WireGuard-Interface zum Zielsystem?
  • Verschlüsselung: Alle Daten werden über den WireGuard-Tunnel mit modernster Kryptografie verschlüsselt übertragen
  • Nur ausgehend: Die Verbindung kann nur von 9brains initiiert werden, euer Netzwerk ist nicht von außen erreichbar

Mandantentrennung und minimale Rechte gelten für beide Verbindungswege, sie stehen in der Übersicht.

Den Grund nennt 9brains beim Tunnel und in der Übersicht, etwa wenn die Firewall auf den WireGuard-Verbindungsaufbau nicht antwortet. Meist liegt es an einem dieser Punkte:

  • Firewall-Peer nicht konfiguriert: Trage den angezeigten Public Key als Peer in eurer Firewall ein
  • UDP-Port nicht erreichbar: Stelle sicher, dass der WireGuard-Port (z.B. 51820) von außen erreichbar ist
  • Falscher Public Key: Vergleiche den „Public Key der Kunden-Firewall“ in 9brains mit dem tatsächlichen Public Key eurer Firewall
  • Firewall-Regeln: Prüfe, ob Traffic vom WireGuard-Interface zum internen System erlaubt ist
  • Allowed IPs: Die Tunnel-IP von 9brains muss in den Allowed IPs des Peers auf eurer Firewall stehen
  • Zugriffsliste davor: Lässt ein vorgeschalteter Server (z.B. ein nginx) oder das Zielsystem nur bestimmte Absender-Adressen zu, muss unsere Adresse dort erlaubt sein. Du findest sie beim Tunnel unter Absender-Adresse für Firewall-Freigaben
  • Zielsystem: Das System muss eingeschaltet sein und auf dem angegebenen Port lauschen. Antwortet ein Service zweimal in Folge nicht, weist 9brains Verbindungen zu ihm ab, bis er wieder antwortet; das steht dann beim Service

Lizenz und Rechte, die du für den On-Premise Connector brauchst, stehen in der Übersicht.