Zum Hauptinhalt springen
Unternehmens-Firewalls, Secure Web Gateways und Forward-Proxys schützen Firmennetzwerke durch das Filtern ausgehenden Datenverkehrs. Damit Ihr Team reibungslos auf die Webanwendung zugreifen, Chat-Antworten in Echtzeit empfangen und Dokumente hochladen kann, müssen Ihre Netzwerksysteme Verbindungen zu den Cloud-Diensten von Omnifact zulassen.
Geltungsbereich: Diese Anleitung gilt für Omnifact Cloud. Sie gilt nicht für On-Premise-Installationen oder Bereitstellungen mit eigenen Domains.

Erforderliche Hostnames und Ports

Am einfachsten und wartungsärmsten ist die Freigabe von ausgehendem Datenverkehr zu *.omnifact.ai und omnifact.ai über TCP-Port 443 (HTTPS). Unterstützt Ihre Firewall keine Wildcard-Regeln, schalten Sie explizit die folgenden Hostnames frei:
Externe Identitäts- & OAuth-Anbieter:
  • Bei Nutzung von Single Sign-On (SSO) muss auch der ausgehende Zugriff auf Ihren Identitätsanbieter (z. B. Microsoft Entra ID, Okta oder Google Workspace) erlaubt sein.
  • Bei Nutzung OAuth-basierter MCP-Integrationen (wie HubSpot, Atlassian, Slack oder GitHub) muss der Browser der Mitarbeitenden außerdem den jeweiligen OAuth-Autorisierungsserver des Drittanbieters erreichen können, bevor die Rückleitung an https://chat.omnifact.ai/oauth/mcp-callback erfolgt.

Typische Proxy- und Firewall-Hürden lösen

WebSocket-Verbindungen

Chat-Antworten und Live-Statusaktualisierungen laufen über persistente WebSocket-Verbindungen (socket.io) zu api.omnifact.ai:
  • Ihr Proxy bzw. Ihre Firewall muss den HTTP-Header Upgrade: websocket zulassen.
  • Werden WebSockets blockiert oder verfälscht, lädt zwar die Oberfläche, Antworten erscheinen jedoch verzögert oder brechen ab.

TLS/SSL-Inspection

Deep-Packet-Inspection (SSL-Aufbruch) kann verschlüsselte Handshakes stören:
  • Nehmen Sie sso-auth.omnifact.ai und sso-app.omnifact.ai von der TLS-Inspection aus, da neu signierte Zertifikate SAML-Handshakes häufig unterbrechen.
  • Treten weiterhin Streaming-Abbrüche oder Upload-Fehler auf, nehmen Sie zusätzlich chat.omnifact.ai und api.omnifact.ai von der TLS-Inspection aus.

Antwort-Streaming und Pufferung

  • Dienste wie Veröffentlichte Spaces und das AI Gateway streamen Daten von connect.omnifact.ai per Server-Sent Events (HTTP Chunked Transfer Encoding).
  • Deaktivieren Sie Antwort-Pufferung auf dem Proxy und beenden Sie langlebige Verbindungen nicht vorzeitig.
Reine Server-zu-Server-Integrationen benötigen lediglich Zugriff auf connect.omnifact.ai. Für die interaktive API-Referenz unter connect.omnifact.ai/docs im Browser muss zusätzlich cdn.jsdelivr.net erreichbar sein.

Hinweis zu IP-Adressen

Omnifact vergibt keine statischen IP-Adressen für Cloud-Dienste, da sämtlicher eingehender Datenverkehr über das globale Edge-Netzwerk von Cloudflare geroutet wird. Nutzen Sie nach Möglichkeit stets Hostname-Freigaben; falls Ihre Sicherheitsrichtlinie zwingend IP-Bereiche verlangt, finden Sie die offiziellen Bereiche unter cloudflare.com/ips.
Cloudflare-IP-Bereiche werden weltweit von zahlreichen Diensten geteilt. Hostname-basierte Regeln sind daher deutlich präziser und sicherer.

Verbindung testen

1

In der Web-App anmelden

Öffnen Sie https://chat.omnifact.ai und melden Sie sich regulär oder per SSO an.
2

Testnachricht senden

Starten Sie einen neuen Chat und prüfen Sie, ob die Antwort flüssig Wort für Wort gestreamt wird.
3

Testdatei anhängen

Hängen Sie ein kleines Dokument an und vergewissern Sie sich, dass Upload und Auswertung reibungslos funktionieren.

Support kontaktieren

Treten weiterhin Verbindungsprobleme auf, schreiben Sie an support@omnifact.ai mit:
  • Datum, Uhrzeit und Zeitzone des Vorfalls
  • Betroffenem Hostnamen bzw. aufgerufener URL
  • Fehlercode oder Sperrmeldung Ihres Browsers, Proxys oder Gateways