OAuth-Konto verbinden¶
Mit OAuth gibst du Nuvoca Zugriff auf ein externes Konto, etwa einen Kalender. Richte die Verbindung unter Einstellungen → Zugangsdaten ein. Du brauchst eine beim Anbieter registrierte Anwendung und die erforderlichen Berechtigungen, dort meist Scopes genannt.
Anmeldeverfahren auswählen¶
| Grant | Geeignet, wenn | Einrichtung |
|---|---|---|
| Client Credentials | Der Anbieter diesen Grant ausdrücklich für Serverzugriff unterstützt | Client-ID, Secret, Token-URL und Scopes |
| Authorization Code + PKCE | Ein Nutzer Kontozugriff freigeben muss | Autorisierungs-URL, Token-URL, Client-ID, erforderliches Secret, Scopes und exakte Redirect-URI |
Kopiere die angezeigte Redirect-URI aus Nuvoca und hinterlege sie unverändert beim Anbieter. Gib auch bei PKCE ein Client-Secret an, wenn der Anbieter es verlangt.
Autorisieren und testen¶
- Erstelle die Konfiguration mit den Anbieterwerten und dem Header-Präfix, gewöhnlich
Bearer. - Speichere bei PKCE und öffne PKCE-Autorisierung im Konfigurationsmenü.
- Schließe Anmeldung und Zustimmung beim Anbieter ab.
- Führe den Zugangsdaten-Test aus. PKCE benötigt dafür einen gespeicherten Refresh-Token.
- Wähle die Zugangsdaten in deiner Integration und teste den tatsächlichen Ressourcen-Endpunkt.
Wenn die Anmeldung klappt, aber die eigentliche Abfrage abgelehnt wird, prüfe die Scopes und Kontoberechtigungen beim Anbieter.
Beispiel: Google Calendar¶
Aktiviere Calendar API, registriere eine Webanwendung und nutze Nuvocas exakte Redirect-URI. Wähle für lesenden Kalenderzugriff einen passenden Scope wie https://www.googleapis.com/auth/calendar.readonly. Googles Token-Endpunkt ist https://oauth2.googleapis.com/token. Fordere Offline-Zugriff an, wenn Refresh-Tokens benötigt werden. Beachte Googles OAuth-Anleitung für Webserver zu Registrierung, Zustimmung und Anbieteranforderungen.
Verbindung pflegen¶
| Aktion | Wirkung |
|---|---|
| Test | Versucht Token-Bezug oder -Erneuerung. |
| Token invalidieren | Leert den zwischengespeicherten Zugriffstoken, damit eine spätere Anfrage einen neuen bezieht. |
| Zugangsdaten widerrufen | Entfernt Nuvocas gespeicherte Autorisierung. PKCE muss erneut autorisiert werden. |
| Bearbeiten | Konfiguration ändern und betroffene Integrationen erneut testen. |
| Löschen | Erfordert das Auflösen angezeigter Verwendungen vor der Löschung. |
Prüfe vor dem Entfernen Verwendungen in Tools, MCP-Verbindungen und Verarbeitung. Das Entfernen in Nuvoca ist vom Widerruf der Berechtigung in den Kontoeinstellungen des Anbieters zu unterscheiden.
Häufige Fehler¶
Bei einem Redirect-Fehler müssen die URI in Nuvoca und die beim Anbieter hinterlegte URI übereinstimmen. Fehlt die Berechtigung zur Token-Erneuerung, melde das Konto mit den erforderlichen Anbietereinstellungen erneut an. Prüfe bei einem Grant-Fehler das gewählte Anmeldeverfahren. Für APIs mit festem Schlüssel verwende API-Schlüssel.