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.
Voraussetzungen
Abschnitt betitelt „Voraussetzungen“- 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.
So funktioniert es
Abschnitt betitelt „So funktioniert es“Dein Firmennetzwerk 9brains Cloud┌──────────────────────┐ ┌──────────────────────┐│ │ WireGuard-Tunnel │ ││ Datenbank ──────────│═══════════════════►│── Integration/Skill ││ ERP-System ─────────│═══════════════════►│── Code-Ausführung ││ Fileserver ─────────│═══════════════════►│── Datenindexierung ││ │ (verschlüsselt) │ │└──────────────────────┘ └──────────────────────┘- Du konfigurierst einen WireGuard-Tunnel zwischen eurer Firewall und 9brains
- Du legst Services an, jeder Service zeigt auf ein internes System (z.B. Datenbank auf Port 5432)
- Du richtest eine Integration oder einen Skill ein, die den Service nutzt
- 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.
Tunnel anlegen
Abschnitt betitelt „Tunnel anlegen“- Gehe zu Einstellungen → On-Premise Connector
- Klicke auf „Tunnel anlegen”
- 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) |
- Klicke auf „Tunnel erstellen”
- Es wird ein Public Key angezeigt, diesen musst du als Peer in eurer Firewall eintragen
Firewall konfigurieren
Abschnitt betitelt „Firewall konfigurieren“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.
Services hinzufügen
Abschnitt betitelt „Services hinzufügen“Ein Service beschreibt ein konkretes System, das über den Tunnel erreichbar ist.
- Öffne den Tunnel in der Detailansicht
- Klicke auf „Service hinzufügen”
- 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 |
- Klicke auf „Service hinzufügen”
- 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.“
Verbindung testen
Abschnitt betitelt „Verbindung testen“- Klicke in der Tunnel-Detailansicht auf „Verbindung testen”
- 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?
Sicherheit
Abschnitt betitelt „Sicherheit“- 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.
Häufige Probleme
Abschnitt betitelt „Häufige Probleme“Tunnel zeigt „Fehler” statt „Verbunden”
Abschnitt betitelt „Tunnel zeigt „Fehler” statt „Verbunden”“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
Service nicht erreichbar trotz aktivem Tunnel
Abschnitt betitelt „Service nicht erreichbar trotz aktivem Tunnel“- 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
Feature nicht sichtbar
Abschnitt betitelt „Feature nicht sichtbar“Lizenz und Rechte, die du für den On-Premise Connector brauchst, stehen in der Übersicht.