osFoundry / Platform
Konnektor-Konfigurationen
Maßgebliche Quelle für jede Verbindung – Scopes, Geheimnisse, OAuth-Konfiguration.
Was es ist
Konnektor-Konfigurationen sind der Teil von osFoundry Studio, der festlegt und speichert, wie sich dein Workspace mit allem außerhalb verbindet: mit den APIs, Tools und Diensten, die deine Agenten und Apps ansprechen. Jeder Konnektor hält das vollständige Bild einer Verbindung in einem einzigen maßgeblichen Datensatz fest: seine OAuth-Client-Konfiguration, die genauen Scopes, die diese Verbindung nutzen darf, die Endpunkte, mit denen sie spricht, sowie die Secrets oder Tokens, mit denen sie sich authentifiziert. Statt dieselbe Zugangsdaten hier in einen Chat, dort in einen Agenten und irgendwo in eine App zu kopieren, wird eine Konnektor-Konfiguration zu dem einen Ort, an dem diese Verbindung definiert ist, und alles im Workspace verweist darauf.
Weil osFoundry ein Bring-your-own-Key-, local-first-Desktop-Workspace ist, sind die Secrets in einer Konnektor-Konfiguration deine eigenen Schlüssel und Tokens, nichts über einen Reseller Gemietetes, und sie können auf deinem Gerät bleiben, statt auf dem Server eines anderen zu liegen. Wenn eine Verbindung OAuth braucht, werden in der Konnektor-Konfiguration die Client-Details und der Redirect eingerichtet und die erteilten Scopes festgehalten, sodass du genau siehst, welchen Zugriff eine Verbindung erhalten hat, statt zu raten. Muss ein Token rotiert oder ein Scope enger gefasst werden, änderst du es einmal in der Konnektor-Konfiguration, und jeder Chat, Agent und jede App, die diese Verbindung nutzt, übernimmt die Änderung.
Genau dieses Single-Source-Design ist der Kern. Verbindungen neigen dazu, auszufransen: verschiedene Schlüssel für denselben Dienst, vergessene Tokens, unklare Berechtigungen. Ein verstreutes Setup ist zugleich Wartungslast und Sicherheitsrisiko. Scopes, Secrets und OAuth-Konfiguration in einem einzigen Konnektor-Datensatz zusammenzuhalten bedeutet, dass du stets eine präzise Antwort auf die Frage hast, was mit welchem Zugriff und über welche Zugangsdaten verbunden ist, und genau darauf kommt es an, wenn du Zugriffe prüfst, einen Workspace an eine Kollegin übergibst oder in Eile etwas widerrufst.
Wichtige Funktionen
- Definiere jede externe Verbindung einmal als Konnektor-Konfiguration und verweise aus jedem Chat, Agenten oder jeder App im Workspace darauf
- Speichere die OAuth-Client-Konfiguration und halte die genauen Scopes fest, die einer Verbindung erteilt wurden
- Behalte API-Schlüssel, Tokens und Secrets local-first auf deinem Gerät im Bring-your-own-Key-Modell, ohne Reseller-Aufschlag
- Rotiere ein Token oder fasse einen Scope enger an einer Stelle, und jeder Nutzer dieser Verbindung übernimmt die Änderung
- Sieh auf einen Blick, was mit welchen Zugangsdaten verbunden ist und welchen Zugriff jede Verbindung tatsächlich hat
Anwendungsfälle
- Einzelentwickler: verbindet einen Agenten mit einer Drittanbieter-API über eine einzige Konnektor-Konfiguration mit den richtigen Scopes, statt den Schlüssel in jeden Prompt zu kopieren
- Datenschutzbewusste Teamleitung: hält alle Workspace-Secrets über Konnektor-Konfigurationen auf dem Gerät und prüft die erteilten OAuth-Scopes, bevor sie Zugriff teilt
- Automatisierungs-Verantwortlicher: rotiert ein ablaufendes Token in einer einzigen Konnektor-Konfiguration, und jede App und jeder Agent, der von dieser Verbindung abhängt, läuft weiter
Häufig gestellte Fragen
Wo werden die Secrets einer Konnektor-Konfiguration tatsächlich gespeichert?
osFoundry ist ein local-first Desktop-Workspace, daher können die Konnektor-Secrets, also deine eigenen API-Schlüssel und Tokens im Bring-your-own-Key-Modell, auf deinem Gerät bleiben statt auf einem gehosteten Server. Zwischen dir und dem Dienst, mit dem du dich verbindest, sitzt kein Reseller.
Was enthält eine Konnektor-Konfiguration außer dem Secret?
Eine Konnektor-Konfiguration ist der maßgebliche Datensatz für eine Verbindung: ihre OAuth-Client-Konfiguration, die konkreten erteilten Scopes, die Endpunkte, mit denen sie spricht, und die Zugangsdaten, mit denen sie sich authentifiziert. Sie zusammenzuhalten ist genau das, was dir zeigt, welchen Zugriff eine Verbindung hat.
Wenn ich eine Verbindung ändere, muss ich sie überall aktualisieren, wo sie genutzt wird?
Nein. Weil alles auf die eine Konnektor-Konfiguration verweist, fließt das Aktualisieren eines Tokens oder das Anpassen eines Scopes dort in jeden Chat, Agenten und jede App, die diese Verbindung nutzt. Diese eine Quelle der Wahrheit ist der Grund, warum es Konnektor-Konfigurationen gibt, statt Zugangsdaten pro Nutzung zu duplizieren.