Licensed to be used in conjunction with basebox, only.
// admin
Konnektoren konfigurieren
Kurzbeschreibung
Einstellungen je Konnektor: Basis-URL, Zugangsdaten, Test der Verbindung, Gesundheitsanzeige, Freigabe je App. Für die Websuche zusätzlich: Anbieter und API-Schlüssel. Diese Seite ergänzt Konnektoren aktivieren um die Einzelheiten der Konfiguration – und zeigt, welche Einstellungen nicht bei Ihnen, sondern beim Platform Operator liegen.
Wofür nutze ich das
Ein aktivierter Konnektor ist erst nützlich, wenn er das richtige System erreicht, sich korrekt anmeldet und in den passenden Apps verfügbar ist. Hier bringen Sie ihn in diesen Zustand und prüfen ihn.
Wo finde ich die Einstellung
Administration → Konnektoren. Jeder Konnektor erscheint als Kachel mit Icon, Name, Beschreibung (etwa Zweck oder Basis-URL) und dem Schalter für die Organisation. Ein Klick auf die Kachel öffnet die Konfiguration.
Schritt für Schritt
Einen Konnektor einrichten:
- Öffnen Sie Administration → Konnektoren und wählen Sie den Konnektor.
- Füllen Sie die erforderlichen Felder: in der Regel die Basis-URL des Systems und – je nach Authentifizierungsmodell – ein gemeinsames Servicekonto oder ein API-Schlüssel auf Organisationsebene. Siehe Konnektor-Authentifizierung.
- Klicken Sie auf Verbindung testen. basebox zeigt, ob die Verbindung aktuell funktioniert.
- Stellen Sie den Schalter auf ein – der Konnektor ist damit organisationsweit freigegeben.
- Geben Sie ihn in den App-Einstellungen der Apps frei, in denen er nutzbar sein soll. Ein organisationsweit aktivierter Konnektor steht nicht automatisch in jeder App bereit.
Gesundheit im Blick behalten:
Die Kachel zeigt an, ob die Verbindung aktuell gesund ist. Schlägt der Test fehl, prüfen Sie Basis-URL, Erreichbarkeit aus der basebox-Umgebung (Firewall, DNS, TLS-Vertrauen) und die hinterlegten Zugangsdaten. Auf basebox Server ist dafür meist der Platform Operator zuständig.
Einen Konnektor abschalten:
Schalter auf aus – die Fähigkeit wird organisationsweit entzogen; laufende Chats können den Konnektor nicht mehr aufrufen.
Die Websuche konfigurieren
- Suchen Sie den Websuche-Konnektor (Standard: Staan Search (European) – der europäische Suchindex von Qwant und Ecosia; ein DuckDuckGo-basierter Konnektor ist als Alternative verfügbar).
- Schalten Sie ihn ein.
- Optional: Tragen Sie den API-Schlüssel Ihrer Organisation aus der Konsole des Anbieters ein. Bleibt das Feld leer, laufen Suchen über das gemeinsame basebox-Kontingent; für den Produktiveinsatz ist der eigene Schlüssel empfohlen. Ein abgelehnter Schlüssel erzeugt einen expliziten Fehler – es gibt keinen stillen Rückfall.
- Entscheiden Sie, in welchen Apps die Websuche verfügbar sein soll. Die Einführung in die Websuche-Sicherheit empfiehlt eine eigene App, deren einziger Konnektor die Websuche ist.
Nutzer schalten die Websuche anschließend je Chat über den Schalter „Web" ein; sie startet in jeder neuen Unterhaltung ausgeschaltet und fragt vor der ersten Suche nach Zustimmung. Firewall-Anforderungen (nur ausgehendes HTTPS zu den Hosts des gewählten Anbieters) und Anbieterdetails: Websuche.
Was beim Platform Operator liegt
Auf basebox Server werden die Konnektor-Dienste selbst als Workloads im Cluster bereitgestellt. Einige externe Endpunkte setzt der Platform Operator dabei per Helm, bevor Sie den Konnektor in der Oberfläche aktivieren:
| Konnektor | Vom Platform Operator per Helm gesetzt |
|---|---|
| IMAP-Host, Port, Verbindungstyp | |
| DokuWiki | XML-RPC-URL |
| Nextcloud | Basis-URL |
| Atlassian | Jira- und/oder Confluence-Basis-URL |
| Websuche | Ausgehender HTTPS-Zugang zum Anbieter (Egress) |
| Eigener MCP-Server | Image, Port, Umgebungsvariablen, maschinelle Zugangsdaten als Kubernetes-Secret |
Konnektoren, die so eingebunden wurden, erscheinen bei Ihnen unter Umständen als „Registered via CLI" und lassen sich wie alle anderen ein- und ausschalten. Details: MCP-Konnektoren mit Helm bereitstellen. In basebox Cloud übernimmt basebox diesen Teil.
Hinweise
Hinweis
- Zwei Ebenen, immer. Organisationsweiter Schalter und Freigabe je App. Fehlt eine, sehen Nutzer den Konnektor nicht.
- Zugangsdaten je Nutzer gehören nicht in die Konnektor-Konfiguration; Nutzer hinterlegen sie selbst, und Sie können sie nicht einsehen.
- Die eigene Website eines Konnektors öffnet sich aus der Kachel in einem neuen Fenster – praktisch, um Token-Anleitungen des Anbieters nachzuschlagen.
- Schreibende Werkzeuge sind je App standardmäßig aus.
- Änderungen wirken sofort und werden im Audit Log festgehalten.
Häufige Fragen
Der Verbindungstest schlägt fehl – woran liegt es meistens? An der Basis-URL (Tippfehler, fehlendes Protokoll), an einer Firewall zwischen basebox und dem System oder an einem TLS-Zertifikat einer privaten CA, dem die basebox-Umgebung nicht vertraut.
Kann ich denselben Konnektor zweimal mit unterschiedlichen URLs anlegen? Nicht in der Oberfläche. Auf basebox Server kann der Platform Operator einen zweiten Konnektor-Workload bereitstellen.
Wo sehen Nutzer, welche Konnektoren ihnen zur Verfügung stehen? Im Chat über das „+"-Symbol – dort erscheinen genau die Konnektoren, die für sie und die aktuelle App freigegeben sind.
Benötigen Sie Hilfe? Support kontaktieren