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-callbackerfolgt.
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: websocketzulassen. - 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.aiundsso-app.omnifact.aivon 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.aiundapi.omnifact.aivon der TLS-Inspection aus.
Antwort-Streaming und Pufferung
- Dienste wie Veröffentlichte Spaces und das AI Gateway streamen Daten von
connect.omnifact.aiper 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.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