Verbindungen (pro Benutzer OAuth2)
Verbindungen sind, wie ein einzelner Benutzer AiHummer Zugang zu einem Drittanbieterdienst in seinem eigenen Namen gewährt. Anstatt eines einzelnen gemeinsamen Dienstkontos verwendet jede Person ein Standardkonto OAuth2-Autorisierungscode-Flow, das resultierende Token wird im verschlüsselten Tresor versiegelt, und zur Ausführungszeit löst die Laufzeit das Token dieses Benutzers auf, wenn ein Werkzeug es benötigt.
Dies ist die „persönliche“ Hälfte des Zugangsdatenmodells von AiHummer. Für das Gesamtbild – wann ein geteiltes Zugangsdaten bevorzugt werden sollte und wie die Rückfallsoption funktioniert – siehe Persönliche vs. geteilte Anmeldeinformationen.
Der persönliche Ablauf unten bleibt der Standard. Nach Installation des signierten Core 1.4.15 können ein konfigurierter Kanal und native Werkzeuge eine ausdrücklich gebundene Verbindung wählen, mit eigenem connection-token-Schlüssel und dem Tresor als einzigem Token-Erneuerer. Dies teilt nicht sämtliche Benutzerberechtigungen und verlangt keine Verbindung durch jeden Mitarbeiter. Werkzeuge prüfen weiterhin die aktuellen Rechte des handelnden Benutzers. Siehe Bitrix24.
Was eine Verbindung ist
Eine Verbindung bindet drei Dinge zusammen: eine Anbieter (die OAuth2-App, die Sie autorisieren), eine Benutzer (die Person, die den Einwilligungsbildschirm ausgefüllt hat), und ein Tresoreingang (wo das ausgestellte Token gespeichert wird). Sobald es etabliert ist, kann jedes Tool, das im Auftrag dieses Benutzers handelt, das Token transparent verwenden, ohne dass es jemals im Modellkontext, in Protokollen oder in der Eingabeaufforderung erscheint.
Verbindungen werden über die Admin-Benutzeroberfläche verwaltet. Die Liste zeigt die verbundenen Anbieter jedes Benutzers, deren Status und wann sie zuletzt aktualisiert wurden.
Der Autorisierungscode-Flow
Eine Verbindung wird mit dem kanonischen Drei-Bein-OAuth2-Autorisierungscode-Grant erstellt:
- Der Nutzer startet eine Verbindung für einen Anbieter über die Admin-Benutzeroberfläche — ein
POST/GET /v1/admin/connections/oauth/startAnfrage. - AiHummer leitet den Browser zum Anbieter weiter Genehmigung Endpunkt mit den angeforderten Berechtigungen.
- Der Benutzer genehmigt den Zustimmungsbildschirm; der Anbieter leitet zurück mit einem
einmalig Autorisierungscode zu
/v1/admin/connections/oauth/callback. - Innerhalb des Callback-Handlers tauscht AiHummer diesen Code serverseitig gegen einen Zugangstoken (und, wenn der Anbieter dies unterstützt, ein Token aktualisieren) am Token-Endpunkt des Anbieters.
- Das Token wird in den Tresor geschrieben und die Verbindung wird als aktiv markiert.
Der Code-für-Token-Austausch findet serverseitig innerhalb des Callbacks statt, sodass das Client-Geheimnis und das ausgegebene Token die Gateway nie verlassen.
[!NOTE] Verwechseln Sie diesen Fluss nicht mit
POST /v1/oauth/token: das gehört AiHummer eigen OAuth2-Client-Credentials-Endpunkt — Dienstkonten registriert über/v1/admin/apikeys/register-clientihre austauschenclient_id/client_secretdort für eine kurze Zeitah-Token. Es hat nichts mit Dritten zu tun Verbindungen.
[!NOTE] Der Autorisierungscode-Flow beinhaltet immer einen echten Browser-Zustimmungsschritt. A Verbindung kann nicht nur mit einem API-Schlüssel ohne Benutzer im Vordergrund erstellt werden — der handelnde Benutzer muss die Berechtigungen einmal genehmigen.
Wo das Token lebt
Das ausgegebene Token wird im AiHummer gespeichert verschlüsselter Anmeldeinformationen-Safe, nicht in einfacher Konfiguration. Der Tresor verwendet Umschlagverschlüsselung (AES-256-GCM mit einem pro-Mandanten-Datenschlüssel unter einem Hauptschlüssel), und Geheimnisse werden niemals in den Modellkontext, Aufforderungen oder Protokolle kopiert. Eine widerrufene oder abgelaufene Verbindung hinterlässt einfach kein verwendbares Geheimnis.
oauth/start ─▶ consent ─▶ code ─▶ oauth/callback (exchange at the provider) ─▶ access/refresh token ─▶ vault (encrypted)
Vom handelnden Benutzer gelöst
Die bestimmende Eigenschaft einer Verbindung ist, dass sie ist vom handelnden Benutzer gelöst. Wenn ein Agent ein Werkzeug ausführt, das den Anbieter benötigt, sucht die Laufzeit die Verbindung des Benutzers, in deren Auftrag der Ablauf abläuft, und verwendet deren Token. Zwei Mitarbeiter, die mit demselben Agenten sprechen, handeln daher mit ihren eigenen Berechtigungen und sehen nur, was ihre eigene Genehmigung erlaubt.
Dies ist es, was Connections für persönliche, benutzerbezogene Integrationen geeignet macht: Der Zugang jeder Person ist isoliert, prüfbar und individuell widerrufbar.
Verfügbare Integrationen
Die folgenden Dienste unterstützen persönliche Verbindungen. OAuth setzt die Konfiguration des Anbieters auf diesem Server voraus.
| Gruppe | Dienstleistungen |
|---|---|
| Gmail, Google Kalender, Google Kontakte, Google Aufgaben, Google Drive, YouTube | |
| Microsoft | Outlook-Mail, Outlook-Kalender, OneDrive, Microsoft To Do |
| Produktivität | Todoist, Asana, Jira Cloud, ClickUp, GitLab, Linear, monday.com |
| Gesundheit & Lebensstil | Fitbit, Oura Ring, Strava, Spotify, Samsung SmartThings |
Bei einer verfügbaren OAuth-Verbindung durchlaufen Sie die Einwilligungsseite des Anbieters. Das ausgegebene Token wird in Ihrem Tresor gespeichert und beim Zugriff eines Werkzeugs auf diesen Dienst ausgewählt.
Persönliches Gmail bei nicht verfügbarem OAuth
Wenn Gmail OAuth nicht verfügbar ist, bitten Sie den Agenten um den Einrichtungslink für persönliches Gmail. Öffnen Sie ihn mit dem AiHummer-Konto, für das er erstellt wurde. Bei einer Kontenabweichung melden Sie sich mit dem passenden Konto an und öffnen den Link erneut. Das Formular speichert eine eigene private persönliche Verbindung neben dem Agentenpostfach.
Erstellen Sie in Ihren Google-Kontoeinstellungen ein App-Passwort. Das Konto muss diese Funktion unterstützen und die Bestätigung in zwei Schritten aktiviert haben. Geben Sie Gmail-Adresse und erzeugtes anwendungsspezifisches Passwort direkt im Formular ein. IMAP/SMTP wird automatisch eingestellt. App-Passwort-Einstellungen · Google-Kontohilfe.
Bitten Sie den Agenten anschließend, Ihr persönliches Gmail zu lesen. Das Werkzeug mail wählt es mit account=personal_gmail und das Agentenpostfach mit account=agent. Jeder Vorgang prüft aktuelle Zugriffsrechte und ausgewählte Zugangsdaten. Speichern bestätigt die Ablage. Erfolgreiches Lesen bestätigt den Zugriff. Senden erfordert Ihren Auftrag. Prüfen Sie bei unbestätigtem Versand vor einem weiteren Versuch den ursprünglichen Beleg.
Verwaltung von Verbindungen in der Admin-Benutzeroberfläche
Von der Admin-Oberfläche aus kann ein Operator:
- Sehen Sie, welche Anbieter jeder Benutzer verbunden hat und den Status jedes Tokens.
- Starten Sie eine neue Verbindung (Einleitung des Einwilligungsprozesses für einen ausgewählten Anbieter).
- Eine Verbindung widerrufen, die den Tresoreintrag entfernt und die Auflösung deaktiviert.
Verbindungen sind entweder persönlich (im Besitz eines bestimmten Benutzers, der sie trennen kann) oder mit dem Arbeitsbereich geteilt (markiert als “Workspace gemeinsam genutzt”; sie können nicht persönlich getrennt werden). Ein Anbieter kann halten mehrere Konten: die „+ Konto“-Schaltfläche fragt nach einer Bezeichnung und speichert eine weitere Anmeldeinformation desselben Anbieters — z. B. mehrere Google-Kalender oder Postfächer.
Da die zugrunde liegenden Zugangsdaten persönlich sind, ist eine Verbindung meist das richtige Werkzeug, wenn eine Aktion einer bestimmten Person zugeschrieben werden muss und durch deren Autorisierung beschränkt ist, anstatt durch ein arbeitsbereichsweites Konto.
Wohin als Nächstes
- Persönliche vs. geteilte Anmeldeinformationen — das Ganze Umfangsmodell und wann man welches wählen sollte.
- BYOK LLM-Anbieter — bring deine eigenen Modellschlüssel pro Mieter.
- Marktplatzübersicht & Stufen — wo OAuth-gestützte Integrationen passen.