Netzwerkzugriff
Diese Seite beschreibt, welche Netzwerkverbindungen das AI Kit braucht – was eingeht, was ausgeht und wie Sie eine On-Premise-Installation in Ihrem Netzwerk aufbauen.
Eingehende Verbindungen (was das AI Kit erreicht)
Ein einziger HTTP/HTTPS-Port. Standardmäßig lauscht die Anwendung auf Port 3000. Hinter einem Reverse Proxy stellen Sie den Clients üblicherweise 443 bereit und lassen den Proxy an den Port des AI Kit weiterleiten.
Wofür eingehende Verbindungen genutzt werden:
| Zweck | Quelle |
|---|---|
| Weboberfläche | Browser der Benutzer in Ihren Workspaces. |
| Webhook-Trigger | Externe Systeme, die …/webhook/{workspace}/{workflow}/{key} aufrufen. |
| OAuth-Callbacks | Der Browser des Benutzers, der nach der Autorisierung des AI Kit von einem Drittanbieter (Google, Microsoft) zurückgeleitet wird. |
| Single Sign-On | Der Browser des Benutzers, der von Ihrem Anmeldeanbieter zu /login/callback zurückkehrt – siehe Single Sign-On und zweiter Faktor. |
Das ist die vollständige Liste. Weitere Ports müssen von außen nicht erreichbar sein.
Ausgehende Verbindungen (was das AI Kit aufruft)
Der Großteil der Netzwerkaktivität ist ausgehend. Je nachdem, was Ihre Workspaces tun, verbindet sich das AI Kit unter Umständen mit:
| Ziel | Zweck | Benötigt für |
|---|---|---|
api.openai.com | Chat / Embeddings von OpenAI | Anbieter OpenAI |
api.anthropic.com | Chat von Anthropic | Anbieter Anthropic |
api.mistral.ai | Chat / Embeddings von Mistral | Anbieter Mistral |
| Ihr Ollama-Host | Selbst betriebene Modelle | Ollama-Modelle |
| Ihr SMTP-Server | Ausgehende Mails (Integration „E-Mail senden“) | Workflows, die Mails versenden |
| Ihr IMAP-Server | Eingehende Mails (Trigger „E-Mail eingegangen“) | Workflows, die Postfächer überwachen |
| Ihre Datenbanken | Integrationen „Datenbankabfrage“ / „Datenbank-Überwachung“ | Datenbank-Workflows |
| Beliebige URLs | Integration „HTTP-Anfrage ausführen“ | HTTP-Workflows |
accounts.google.com, oauth2.googleapis.com | OAuth + Google Kalender | Google-Integrationen |
www.googleapis.com | APIs von Google Kalender / Drive | Google-Integrationen |
| Ihr MinIO-Endpunkt | Trigger „Cloud-Speicher-Überwachung“ | MinIO-Workflows |
Ihr Anmeldeanbieter (zum Beispiel login.microsoftonline.com, accounts.google.com, oauth2.googleapis.com, www.googleapis.com) | Single Sign-On: Discovery-Dokument, Signaturschlüssel, Einlösen des Codes | Single Sign-On |
| Update-/Telemetrie-Endpunkte | Optionale Versionsprüfung und (falls aktiviert) Metriken | immer aktiv, sofern nicht abgeschaltet |
Die Plattform sendet keine Workspace-Inhalte „nach Hause“. Telemetrie beschränkt sich, sofern aktiviert, auf anonyme Angaben zu Version und Betriebszeit. Schalten Sie sie per Konfiguration ab, wenn Ihre Umgebung keinerlei ausgehenden Datenverkehr zulässt, der nicht unbedingt für die Funktion nötig ist.
Ein typischer On-Premise-Aufbau
Die wichtigsten Entscheidungen:
- TLS am Proxy, nicht im AI Kit. So nutzen Sie Let's Encrypt oder die Zertifizierungsstelle Ihres Unternehmens, ohne das AI Kit anzufassen.
- Das AI Kit lauscht nur im internen Netz. Von außen spricht ausschließlich der Proxy mit ihm.
- Strenge Regeln für ausgehenden Verkehr, wenn Ihre Umgebung das verlangt. Erlauben Sie nur die Domains der Anbieter, die Sie tatsächlich nutzen.
Installationen ohne Netzverbindung (Air-Gap)
Manche Organisationen dürfen keinerlei ausgehenden Verkehr zulassen. Das AI Kit unterstützt das, allerdings mit Einschränkungen:
- Externe KI-Anbieter scheiden aus. Nutzen Sie stattdessen selbst betriebenes Ollama – siehe Modelle → Ollama (selbst betrieben).
- E-Mail-Integrationen brauchen entweder einen internen SMTP-/IMAP-Server oder eine Weiterleitung über eine Einweg-DMZ.
- OAuth-basierte Integrationen (Google Kalender) funktionieren ohne Netzverbindung nicht, weil der Browser des Benutzers Google erreichen muss. Nehmen Sie diese Einschränkung in Kauf oder führen Sie den OAuth-Ablauf über einen streng kontrollierten Proxy.
- Single Sign-On braucht einen Anmeldeanbieter, den Server und Browser erreichen – ein Anbieter im eigenen Netz (zum Beispiel Keycloak oder ADFS) funktioniert ohne Internetzugang.
- Telemetrie muss ausdrücklich abgeschaltet werden.
Unter diesen Bedingungen läuft das AI Kit vollständig innerhalb Ihres Netzwerks.
Sicherheit von Webhooks
Der Webhook-Endpunkt ist die am stärksten exponierte Angriffsfläche. Zwei praktische Leitlinien:
- Verwenden Sie einen langen, zufälligen gemeinsamen Schlüssel für jeden Webhook. Behandeln Sie die URL wie ein Zugangsdatum.
- Schränken Sie die Quell-IPs am Proxy ein, wenn der Aufrufer ein bekannter Dienst ist. Die meisten CRM- und Ticketsysteme veröffentlichen ihre IP-Bereiche.
Das AI Kit prüft den Schlüssel bei jedem Aufruf. Stimmt er nicht, antwortet es mit HTTP 401; solche Aufrufe werden nicht als Workflow-Läufe protokolliert.
TLS und Zertifikatspflege
- Verwenden Sie ein gültiges Zertifikat. Selbstsignierte Zertifikate funktionieren technisch, sorgen aber für Verwirrung, wenn Dritte Webhooks an Sie senden.
- Erneuern Sie Zertifikate, bevor sie ablaufen. Eine Überwachung des Zertifikatsablaufs macht sich bezahlt, sobald sie Sie zum ersten Mal warnt.
- HSTS am Proxy. Haben Sie sich für HTTPS entschieden, verhindern Sie versehentliche Herabstufungen.
Häufige Fragen
Unterstützt das AI Kit IP-basierte Zugriffskontrolle? Von Haus aus nur eingeschränkt. Nutzen Sie für IP-basierte Regeln den Proxy oder eine Firewall.
Kann das AI Kit hinter einem HTTP-Proxy des Unternehmens laufen?
Ja. Setzen Sie beim Start des Containers die üblichen Umgebungsvariablen HTTP_PROXY / HTTPS_PROXY.
Braucht das AI Kit ausgehende Ports außer HTTP? SMTP (meist 587) und IMAP (meist 993) für die Mail-Integrationen. Datenbank-Integrationen brauchen die jeweiligen Datenbank-Ports (3306 für MySQL, 5432 für Postgres, …). Alles andere läuft über HTTPS.
Empfehlungen
- ✅ Betreiben Sie das AI Kit hinter einem Reverse Proxy mit TLS. Immer.
- ✅ Erlauben Sie ausgehenden Verkehr nur über eine Freigabeliste, wenn Ihre Umgebung streng ist. Sperren Sie standardmäßig alles und erlauben Sie nur die Ziele, die Sie tatsächlich nutzen.
- ✅ Verwenden Sie einen eigenen Hostnamen für das AI Kit (z. B.
aikit.example.com). Das erleichtert Überwachung und Firewall-Regeln. - ✅ Überwachen Sie die Protokolle des Proxys ebenso wie die des AI Kit. Viele Probleme zeigen sich dort zuerst.
- ⚠️ Webhook-URLs enthalten den gemeinsamen Schlüssel. Behandeln Sie sie als geheime URLs – sie sind etwa so schutzbedürftig wie Passwörter.
- ❌ Machen Sie Port 3000 nicht direkt aus dem Internet erreichbar. Stellen Sie immer einen Proxy davor.
- ❌ Schalten Sie die Zertifikatsprüfung im AI Kit nicht ab. Falsch konfigurierte Zertifikate sollen deutlich sichtbar fehlschlagen.
Nächste Schritte
- Lokale Ressourcen – welche Daten auf dem Datenvolume liegen.
- Best Practices → Protokollierung und Compliance – was protokolliert wird.