Bring Your Own OAuth Client

Du kannst mehrere eigene OAuth-Clients für dieselbe Integration verwenden. Lege einen Client für deinen gesamten Workspace fest und weise weitere Clients bestimmten Nutzergruppen zu. So nutzen verschiedene Gruppen dieselbe Integration mit unterschiedlichen OAuth-Clients.

So funktioniert ein eigener OAuth-Client

Wenn du einen eigenen OAuth-Client konfigurierst, leitet Langdock neue Authentifizierungsabläufe über die OAuth-Anwendung, die dem jeweiligen Nutzer zugewiesen ist. Der Client für den gesamten Workspace gilt standardmäßig. Gruppen-Clients gelten für Mitglieder der zugewiesenen Gruppen. Das bedeutet:

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
Deine Nutzergruppen können sich über separate OAuth-Clients authentifizieren

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)

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)

In Langdock konfigurieren

Öffne Workspace Einstellungen → Integrationen, wähle die Integration aus und scrolle zu Bring your own OAuth Client.Klicke auf Weiteren OAuth-Client hinzufügen, wenn die Integration einen Langdock-Client enthält. Wenn die Integration deinen eigenen Client erfordert, klicke auf Konfiguriere deinen OAuth-Client, um diese Integration zu nutzen.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, Scopes von aktivierten Aktionen synchronisieren 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.Füge optional einen aussagekräftigen Client Name hinzu. Wähle unter Zugriff die Option Gesamter Workspace oder Gruppen. Trage deine Client ID und dein Client secret ein (und bei Microsoft-Integrationen zusätzlich die Tenant ID, falls abgefragt). Klicke auf Speichern und bestätige die Änderung.Wähle den gespeicherten Client aus der Client-Liste aus und bestätige den Wechsel, um ihn zu aktivieren.

Sobald der Client aktiv ist, verwenden neue Verbindungen von Nutzern mit Zugriff auf diesen Client ihn sofort und funktionieren nur, wenn die Zugangsdaten gültig sind. Bestehende Verbindungen bleiben mit dem Client verknüpft, mit dem sie erstellt wurden.

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

OAuth-Clients Nutzergruppen zuweisen

Verwende Gruppenzugriff, wenn verschiedene Teile deiner Organisation separate OAuth-Anwendungen für dieselbe Integration benötigen. Weise zum Beispiel einer Tochtergesellschaft mit eigenem Microsoft Entra Tenant einen Client zu oder verwende einen separaten Client, wenn eine Abteilung andere freigegebene Scopes benötigt. Der Client für deinen gesamten Workspace bleibt der Standard für alle Nutzer, die keinem Gruppen-Client zugewiesen sind.

Weiteren eigenen Client hinzufügen

Integrationseinstellungen für Outlook Email mit ausgewählter Option zum Hinzufügen eines weiteren OAuth-Clients

Klicke auf Weiteren OAuth-Client hinzufügen. Gib dem Client optional einen aussagekräftigen Namen, damit du ihn in der Client-Liste erkennst.

Client-Zugriff verwalten

Zugriffseinstellungen des OAuth-Clients mit ausgewählten Nutzergruppen

Wähle im Abschnitt Zugriff die Option Gruppen aus. Klicke dann auf Verwalten, um die Nutzergruppe auszuwählen, die diesen Client verwenden soll.

Zugangsdaten hinzufügen

Trage Client ID, Client secret und alle vom Anbieter benötigten Felder ein. Klicke auf Speichern und bestätige die Änderung. Wähle den gespeicherten Client aus der Client-Liste aus und bestätige den Wechsel, um ihn zu aktivieren.

Lass einen Client für den gesamten Workspace aktiv, wenn Nutzer ohne Gruppen-Client eine Verbindung herstellen müssen. Ein Nutzer kann nicht zu Gruppen gehören, denen zwei aktive OAuth-Clients für dieselbe Integration zugewiesen sind.

Interface der Integrationseinstellungen

Der Konfigurationsdialog enthält die folgenden Abschnitte:

Redirect URL
Scopes
Credentials

Ein schreibgeschütztes Feld, das die Redirect-URL anzeigt, die deine OAuth-Anwendung verwenden muss. Klicke auf die Kopierschaltfläche, um sie exakt zu übernehmen. Das URL-Format lautet:

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

Die Redirect-URL muss exakt übereinstimmen. Jede Abweichung führt zu redirect_uri_mismatch-Fehlern. Die genaue Domain hängt von deinem Langdock-Deployment ab – kopiere die Redirect-URL daher immer aus dem Dialog, anstatt sie manuell zusammenzubauen.

Zeigt die OAuth-Scopes an, die für die einwandfreie Funktion der Integration erforderlich sind. Jira benötigt beispielsweise Scopes wie read:jira-work, write:jira-work, read:jira-user, offline_access und manage:jira-configuration.

Kopieren: Kopiert alle Scopes in die Zwischenablage, sodass du sie in die Konfiguration deiner OAuth-Anwendung einfügen kannst.
Bearbeiten: Wechselt in den Bearbeitungsmodus, in dem du die Scopes in einem Textfeld anpassen kannst (nur für fortgeschrittene Anwendungsfälle).
Auf Standard-Scopes zurücksetzen: Stellt die ursprüngliche Scope-Liste wieder her, falls du sie verändert hast.

Für Integrationen mit Action-Level-Berechtigungen solltest du Scopes von aktivierten Aktionen synchronisieren aktiviert lassen, sofern du nicht bewusst eine feste Scope-Liste selbst verwalten möchtest. Das ist die empfohlene Standardeinstellung, weil Langdock die OAuth-Scopes mit aktivierten und geteilten Aktionen synchron halten kann.

Alle aufgeführten Scopes müssen in deiner OAuth-Anwendung aktiviert sein. Fehlende Scopes führen zu insufficient_scope-Fehlern, wenn Nutzer eine Verbindung herstellen möchten.

Eigene OAuth-Clients verwalten

Jede Karte zeigt den Client-Namen, die Zugriffsart, den Scope-Modus und den Aktivierungsstatus.

Wähle die Karte eines inaktiven Clients aus, um ihn zu aktivieren.
Wähle die Karte eines aktiven eigenen Clients aus, um ihn zu deaktivieren.
Klicke auf das Einstellungssymbol, um den Client zu bearbeiten.
Öffne die Client-Einstellungen und klicke auf OAuth-Client Konfiguration löschen, um den Client zu entfernen.
Wähle Langdock-Client, damit neue Verbindungen den verwalteten Client verwenden. Dadurch werden alle eigenen Clients deaktiviert.

Du kannst mehrere Gruppen-Clients aktiv lassen, wenn sich ihre Mitglieder nicht überschneiden. Für eine Integration kann nur ein Client für den gesamten Workspace aktiv sein.

Wenn du einen Client deaktivierst, verwenden neue Verbindungen ihn nicht mehr. Bestehende Verbindungen bleiben mit ihrem ausgewählten Client verknüpft. Wenn du einen Client löschst, können vorhandene Access Tokens bis zu einem Authentifizierungsfehler weiter funktionieren. Nutzer müssen sich dann mit einem geeigneten aktiven Client neu autorisieren.

Häufige Konfigurationsfehler

redirect_uri_mismatch

Ursache: Die Redirect-URL stimmt zwischen Langdock und deiner OAuth-Anwendung nicht exakt überein.Lösung:

Kopiere die Redirect-URL aus Langdock exakt
Achte auf abschließende Schrägstriche oder unterschiedliche Protokolle
Prüfe, ob du die richtige Umgebung konfigurierst

invalid_client

Ursache: Client-ID oder Client-Secret ist falsch.Lösung:

Überprüfe die Zugangsdaten aus deiner OAuth-Anwendung
Achte darauf, dass keine zusätzlichen Leerzeichen oder Zeichen enthalten sind
Stelle sicher, dass der Client in der Konsole deines Anbieters aktiviert ist

insufficient_scope

Ursache: Fehlende erforderliche Scopes in deiner OAuth-Anwendung.Lösung:

Füge alle in Langdock angezeigten Scopes zu deiner OAuth-Anwendung hinzu
Nutzer müssen sich nach dem Hinzufügen ggf. erneut verbinden
Verifiziere, dass die Namen der Scopes exakt übereinstimmen (Groß-/Kleinschreibung beachten)

Ein Gruppen-Client kann nicht aktiviert werden

Ursache: Mindestens ein Nutzer gehört zu einer Gruppe, die von einem anderen aktiven OAuth-Client abgedeckt wird.Lösung:

Prüfe die Gruppen, die beiden Clients zugewiesen sind
Entferne die sich überschneidende Gruppenzuweisung oder Mitgliedschaft
Aktiviere den Client erneut

Integrationen, die einen eigenen OAuth-Client erfordern

Einige unserer Integrationen können nur verwendet werden, wenn du einen eigenen OAuth-Client bereitstellst. Details zum Verbinden dieser Integrationen mit Langdock sind in diesem Abschnitt beschrieben.

ServiceNow

Anzeigen wie du einen ServiceNow-OAuth-Client konfigurierst

Um diese Integration für deinen Arbeitsbereich zu aktivieren, muss ein ServiceNow Systemadministrator einen OAuth-Client als Application Registry in ServiceNow erstellen und dieser Dokumentation folgen.
Erforderliche Input-Felder für die Authentifizierung

ServiceNow-Subdomain angeben

Wenn ein Nutzer eine Verbindung mit ServiceNow herstellen möchte, muss er die Subdomain deiner ServiceNow-Instanz angeben.

Anforderungen für die ServiceNow-Integration

Werden selbst gehostete oder cloudbasierte Konten unterstützt?

Derzeit werden nur cloudbasierte Konten unterstützt.

Ist ein bezahlter ServiceNow-Plan erforderlich?

Ein bezahltes ServiceNow-Konto ist erforderlich, um eine Application Registry zu erstellen. Mehr Informationen hier.

Sind besondere Berechtigungen oder Rollen erforderlich?

Ja. Für die Verbindung per OAuth sollte dein Systemadministrator die richtige Konfiguration innerhalb deiner Instanz einrichten, damit sich jeder Nutzer über eine OAuth-Verbindung verbinden kann. Beispielsweise benötigen alle Nutzer die Rolle oauth_user, um sich verbinden zu können. Mehr Informationen hier.

Gibt es Nutzungsbegrenzungen?

Ja. ServiceNow setzt Begrenzungen ein, um übermäßige API-Nutzung zu verhindern. Administratoren können Regeln konfigurieren, die die Anzahl eingehender REST-API-Anfragen pro Stunde beschränken. Mehr Informationen hier.

Snowflake

Die Konfiguration eines eigenen OAuth-Clients für Snowflake gibt dir Kontrolle über Authentifizierungsrichtlinien, Token-Gültigkeitszeiträume und IP-Allowlisting in deiner Snowflake-Umgebung.

Anzeigen wie du einen Snowflake-OAuth-Client konfigurierst

Erforderliche Informationen:

OAuth Redirect URL: Kopiere diese aus den Snowflake-Integrationseinstellungen in Langdock
Client-ID: Wird von Snowflake nach Erstellung der Security Integration generiert
Client-Secret: Wird von Snowflake nach Erstellung der Security Integration generiert
Authorization URL: Der Autorisierungs-Endpunkt deines Snowflake-Kontos

Die Redirect URL aus Langdock muss in Snowflake bereitgestellt werden, während Client-ID, Client-Secret und Authorization URL aus Snowflake in die Langdock-Integrationseinstellungen eingetragen werden müssen.

Wenn dein Snowflake-Konto Netzwerkrichtlinien oder IP-Allowlisting aktiviert hat, musst du möglicherweise die statische IP-Adresse von Langdock freigeben, um Verbindungen zu ermöglichen. Siehe Statische IP-Konfiguration für Details.

Einrichtungsanleitung

Integration in Langdock erstellen

Erstelle in deinem Langdock-Arbeitsbereich eine neue Snowflake-Integration und richte einen eigenen OAuth-Client ein.

Anzeigen wie du einen eigenen OAuth-Client in Langdock einrichtest

Navigiere zu Integrationen in Langdock
Klicke auf Add Integration und wähle Start from Scratch
Gib deinen bevorzugten Namen und eine Beschreibung für deine neue Snowflake-Integration ein
Klicke auf Create
Authentifizierungstyp: Wähle OAuth 2.0 aus dem Dropdown
Authentifizierungsfelder: Leer lassen
OAuth-Konfiguration: Speichere deine OAuth Redirect URL

Security Integration in Snowflake erstellen

Wähle in Snowflake deinen Arbeitsbereich und erstelle eine neue Security Integration.

Anzeigen wie du eine neue Security Integration in Snowflake erstellst

Erstelle eine neue .sql-Datei und füge folgende Abfrage ein:

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;

Ersetze <integration_name> durch einen aussagekräftigen Namen und <your_redirect_uri> durch die OAuth Redirect URL aus Schritt 1.
Führe die Abfrage aus, um deine neue Security Integration in Snowflake zu erstellen. Hinweis: Passe den Wert von OAUTH_REFRESH_TOKEN_VALIDITY entsprechend deiner Sicherheitsrichtlinien an.

Client-ID und Client-Secret abrufen

Anzeigen wie du die Client-ID und Client-Secret aus Snowflake abrufen kannst

Führe im selben Arbeitsbereich folgende Abfrage aus:

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

Ersetze <integration_name> durch den Namen, den du deiner Security Integration im vorherigen Schritt gegeben hast.
Speichere deine Client-ID und dein Client-Secret. Bewahre diese Zugangsdaten sicher auf, da sie Zugriff auf dein Snowflake-Konto ermöglichen.

Account-URL aus Snowflake abrufen

Anzeigen wie du deine Account-URL aus Snowflake abrufst

Klicke auf deinen Kontonamen in der unteren linken Ecke deiner Snowflake-Anwendung
Klicke im Bereich Account auf View Account Details
Kopiere deine Account-URL

Integrationseinstellungen in Langdock konfigurieren

Anzeigen wie du deinen Snowflake-OAuth-Client in Langdock konfigurierst

Füge deine Client-ID und dein Client-Secret aus Schritt 3 in die entsprechenden Eingabefelder deiner neuen Langdock-Integration ein
In den folgenden Abschnitten:

Authorization URL
Access Token URL
Refresh Token URL

Ersetze nur https://example.com durch deine Snowflake Account-URL aus Schritt 4.Beispiel:

https://example.com/oauth/authorize

Wird zu:

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

Klicke auf Save

Verbindung testen

Anzeigen wie du eine Verbindung zu deiner Snowflake-Integration hinzufügst

Klicke in deiner Snowflake-Integration auf Add Connection.

Du solltest zum Snowflake-Autorisierungsbildschirm weitergeleitet werden
Melde dich bei deinem Snowflake-Konto an

Du hast deine eigene OAuth Snowflake-Integration erfolgreich eingerichtet!

Workspace

Agenten verwalten

Workflows verwalten

Integrationen verwalten

Nutzung verwalten

Bring your own Keys (BYOK)

Governance

Compliance & Governance

KI-Einführung & Rollout

Sicherheit

Abrechnung

Bring Your Own OAuth Client

So funktioniert ein eigener OAuth-Client

OAuth-Clients Nutzergruppen zuweisen

Interface der Integrationseinstellungen

Eigene OAuth-Clients verwalten

Häufige Konfigurationsfehler

Integrationen, die einen eigenen OAuth-Client erfordern

ServiceNow

Anforderungen für die ServiceNow-Integration

Snowflake

Einrichtungsanleitung

​So funktioniert ein eigener OAuth-Client

​OAuth-Clients Nutzergruppen zuweisen

​Interface der Integrationseinstellungen

​Eigene OAuth-Clients verwalten

​Häufige Konfigurationsfehler

​Integrationen, die einen eigenen OAuth-Client erfordern

​ServiceNow

​Anforderungen für die ServiceNow-Integration

​Snowflake

​Einrichtungsanleitung

So funktioniert ein eigener OAuth-Client

OAuth-Clients Nutzergruppen zuweisen

Interface der Integrationseinstellungen

Eigene OAuth-Clients verwalten

Häufige Konfigurationsfehler

Integrationen, die einen eigenen OAuth-Client erfordern

ServiceNow

Anforderungen für die ServiceNow-Integration

Snowflake

Einrichtungsanleitung