Das Verwalten von Auth-Verbindungen erfordert die Owner- oder Admin-Rolle.
So funktioniert es
Jede Verbindung koppelt eine Authentifizierungsmethode mit einem Wert, der als Geheimnis gespeichert ist — so wird die sensible Anmeldeinformation nie in deiner Tool-Konfiguration offengelegt. homie unterstützt:- Bearer Token — sendet einen
Authorization: Bearer-Header mit deinem Token. - Basic Auth — sendet einen Benutzernamen und ein Passwort.
- Header — sendet einen eigenen Header mit deinem Wert.
- OAuth2 (Client Credentials) — holt kurzlebige Access Tokens automatisch vom Token-Endpoint des Dienstes und erneuert sie, bevor sie ablaufen.
OAuth2 (Client Credentials)
Manche Dienste — zum Beispiel Shopware — vergeben Access Tokens, die nach wenigen Minuten ablaufen. Mit einer OAuth2-Verbindung verwaltest du diese Tokens nicht selbst: Hinterlege einmalig Token-URL, Client-ID und Client-Secret, und homie holt im Hintergrund automatisch ein frisches Access Token, sobald eines benötigt wird.- Token-URL — der Token-Endpoint des Dienstes (zum Beispiel
https://dein-shop.example/api/oauth/token). - Client-ID — die öffentliche Kennung deiner API-Zugangsdaten.
- Client-Secret — wird als verschlüsseltes Geheimnis gespeichert.
- Scope (optional) — nur nötig, wenn der Dienst bestimmte Berechtigungen erwartet.
Verbindung hinzufügen
1
Anmeldedaten als Geheimnis speichern
Füge zuerst den API-Key, Token oder das Passwort als Geheimnis hinzu, damit der Wert verschlüsselt bleibt.
2
Auth-Verbindungen öffnen
Öffne Einstellungen → Auth-Verbindungen und wähle Auth-Verbindung hinzufügen.
3
Verbindungstyp wählen
Wähle, wie sich der externe Dienst authentifiziert — Bearer Token, Basic Auth, ein eigener Header oder OAuth2 (Client Credentials) — und referenziere das Geheimnis, das den Wert enthält.
4
In einem HTTP-Tool verwenden
Referenziere die Verbindung beim Konfigurieren eines HTTP-Tools, damit das Tool den externen Dienst in deinem Namen aufrufen kann.

Verbindungen verwalten
Prüfe deine Verbindungen, aktualisiere die Anmeldedaten, die eine Verbindung nutzt, oder entferne eine Verbindung, die du nicht mehr brauchst. Das Entfernen einer Verbindung verhindert, dass ein davon abhängiges HTTP-Tool sich authentifiziert.Nächste Schritte
HTTP-Tools
Erstelle Tools, die deine externen Dienste aufrufen.
Geheimnisse
Speichere die verschlüsselten Anmeldedaten, die deine Verbindungen nutzen.