Eigene OAuth-Clients konfigurieren

Documentation Index

Fetch the complete documentation index at: https://docs.langdock.com/llms.txt

Use this file to discover all available pages before exploring further.

​

So funktioniert ein eigener OAuth-Client

• Dein Branding (eigener Name und eigenes Logo) erscheint auf den Zustimmungsseiten
• Deine Tenant-Richtlinien steuern den Nutzerzugriff und die Anforderungen an die Admin-Zustimmung
• Deine Rate-Limits gelten für API-Aufrufe, die von deinen Nutzern ausgeführt werden

1

OAuth-App beim Anbieter erstellen

Registriere eine neue OAuth-Anwendung im Entwicklerportal deines Anbieters (z. B. Google Cloud Console, Microsoft Azure).Erforderliche Konfiguration:

• Kopiere die exakte Redirect-URL aus den Integrationseinstellungen von Langdock
• Wähle alle benötigten Scopes aus, die in Langdock für diese Integration angezeigt werden
• Konfiguriere ggf. tenant-spezifische Einstellungen (Admin-Zustimmung, Freigabelisten)

2

Zugangsdaten sammeln

Notiere dir Folgendes aus deiner OAuth-Anwendung:

• Client-ID (immer erforderlich)
• Client-Secret (erforderlich für die meisten Integrationen)
• Tenant-ID (optional, wird nur bei Microsoft-Integrationen angezeigt)

3

In Langdock konfigurieren

Navigiere zu Workspace Einstellungen → Integrationen und scrolle zum Abschnitt Bring your own OAuth Client. Du siehst eine Liste der OAuth-Integrationen mit dem jeweils aktuellen Client-Status.Wähle je nach aktuellem Status der Integration eine der folgenden Optionen:

• Wenn für die Integration ein Langdock-Client verfügbar ist, öffne das Dropdown und wähle Eigener Client, um den Konfigurationsdialog zu öffnen.
• Wenn kein Langdock-Client existiert und auch noch kein eigener Client konfiguriert ist, klicke auf Konfigurieren.
• Wenn kein Langdock-Client existiert und dein eigener Client bereits konfiguriert ist, siehst du Eigener Client zusammen mit einer Bearbeiten-Schaltfläche. Klicke auf Bearbeiten, um deine Konfiguration anzupassen.

Kopiere im Konfigurationsdialog die Redirect URL in deine OAuth-Anwendung und prüfe den Abschnitt Scopes. Stelle sicher, dass alle aufgeführten Scopes in deiner OAuth-Anwendung aktiviert sind – fehlende Scopes führen zu einem Fehler wegen unzureichender Berechtigungen. Über die Kopieren-Schaltfläche kannst du alle Scopes auf einmal kopieren.Trage anschließend deine Client-ID und dein Client-Secret ein (und bei Microsoft-Integrationen zusätzlich die Tenant-ID, falls abgefragt) und klicke auf Speichern.

Neue Verbindungen verwenden ab sofort deinen OAuth-Client und funktionieren nur, wenn die Zugangsdaten gültig sind. Bestehende Verbindungen funktionieren weiter, bis ihre Access Tokens ablaufen.

4

Authentifizierung testen

Lass einen Nutzer sein Konto verbinden und prüfe:

• Auf der Zustimmungsseite wird dein Client angezeigt
• Die benötigten Scopes werden erteilt
• Der Datenzugriff über die Actions funktioniert wie erwartet

​

Interface der Integrationseinstellungen

https://app.langdock.com/api/integrations/{integration-id}/callback

​

Zurück zum Langdock-Client wechseln

1. Öffne das Dropdown neben der Integration und wähle Langdock-Client aus.
2. Bestätige den Wechsel im Dialog.

​

Häufige Konfigurationsfehler

​

Integrationen, die einen eigenen OAuth-Client erfordern

​

ServiceNow

​

Snowflake

CREATE SECURITY INTEGRATION <integration_name>
  TYPE = OAUTH
  ENABLED = TRUE
  OAUTH_CLIENT = CUSTOM
  OAUTH_CLIENT_TYPE = CONFIDENTIAL
  OAUTH_REDIRECT_URI = '<your_redirect_uri>'
  OAUTH_ISSUE_REFRESH_TOKENS = TRUE
  OAUTH_REFRESH_TOKEN_VALIDITY = 86400;

SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('<integration_name>');

https://example.com/oauth/authorize

https://<deine-snowflake-account-url>/oauth/authorize