Bring Your Own OAuth Client

​

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.Für Integrationen mit Action-Level-Berechtigungen empfehlen wir, Sync scopes with enabled actions standardmäßig aktiviert zu lassen. Langdock fragt dann die Auth-Scopes sowie die Scopes an, die für aktivierte oder geteilte Aktionen erforderlich sind. So bleiben die angefragten Scopes auf die Aktionen abgestimmt, die dein Workspace nutzen kann. Mehr dazu unter Action-Level-Scopes verwalten.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