> ## 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.

# Bring Your Own OAuth Client

> Richte eigene OAuth-Anwendungen für Integrationen ein, weise Clients deinem Workspace oder Nutzergruppen zu und steuere Scopes, Tenant-Richtlinien und Branding.

<Info>
  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.
</Info>

## 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

<Steps>
  <Step title="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)
  </Step>

  <Step title="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)
  </Step>

  <Step title="In Langdock konfigurieren">
    Öffne [**Workspace Einstellungen → Integrationen**](https://app.langdock.com/settings/workspace/products/integrations), 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](/de/admin/manage-integrations/manage-action-level-scopes).

    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). Wenn die Integration zusätzliche Verbindungsfelder zeigt, setze sie unter **OAuth-Verbindungsdetails**. Klicke danach 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.

    <Warning>
      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.
    </Warning>
  </Step>

  <Step title="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
  </Step>
</Steps>

## 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.

<Steps>
  <Step title="Weiteren eigenen Client hinzufügen">
    <Frame>
      <img src="https://mintcdn.com/langdock-34/yXe3zblEcJbCwgSJ/de/images/multiple_oauth_clients1.png?fit=max&auto=format&n=yXe3zblEcJbCwgSJ&q=85&s=e9bf6624b69021c4cf477d00f8a0fd2a" alt="Integrationseinstellungen für Outlook Email mit ausgewählter Option zum Hinzufügen eines weiteren OAuth-Clients" style={{borderRadius: '6px'}} width="1862" height="1112" data-path="de/images/multiple_oauth_clients1.png" />
    </Frame>

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

  <Step title="Client-Zugriff verwalten">
    <Frame>
      <img src="https://mintcdn.com/langdock-34/yXe3zblEcJbCwgSJ/de/images/multiple_oauth_clients2.png?fit=max&auto=format&n=yXe3zblEcJbCwgSJ&q=85&s=8e90aad90c6ce8aa7dbad881f5f07b01" alt="Zugriffseinstellungen des OAuth-Clients mit ausgewählten Nutzergruppen" style={{borderRadius: '6px'}} width="1860" height="986" data-path="de/images/multiple_oauth_clients2.png" />
    </Frame>

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

  <Step title="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.
  </Step>
</Steps>

<Warning>
  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.
</Warning>

## Interface der Integrationseinstellungen

Der Konfigurationsdialog enthält die folgenden Abschnitte:

<Tabs>
  <Tab title="Redirect URL">
    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
    ```

    <Warning>
      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.
    </Warning>
  </Tab>

  <Tab title="Scopes">
    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.

    <Warning>
      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.
    </Warning>
  </Tab>

  <Tab title="Credentials">
    Gib die Zugangsdaten deiner OAuth-Anwendung ein:

    * **Client Name** (optional): Ein aussagekräftiger Name, mit dem du den Client in Langdock erkennst
    * **Client ID** (erforderlich): Öffentliche Kennung deiner Anwendung
    * **Client secret** (erforderlich für die meisten Integrationen): Privater Schlüssel deiner Anwendung, verschlüsselt gespeichert
    * **Tenant ID** (nur bei Microsoft-Integrationen, optional): Die Kennung deines Azure-AD-Tenants
    * **OAuth-Verbindungsdetails** (wenn angezeigt): zusätzliche Felder für diesen Client, jeweils mit **Optional** gekennzeichnet
  </Tab>
</Tabs>

<h2 id="additional-parameters">
  OAuth-Verbindungsdetails
</h2>

Manche Integrationen fragen zusätzliche Verbindungsfelder ab, zum Beispiel eine Instanz-URL, eine Subdomain oder eine Store Domain. Speichere diese Werte als Workspace-Standard, damit Mitglieder die Abfrage beim Verbinden überspringen.

* Auf der Karte **Langdock-Client** klickst du auf **Konfigurieren**, wenn diese Felder erscheinen. In Dedicated Deployments heißt die Karte **Globaler Client**.
* Bei einem eigenen Client erscheinen dieselben Felder im Konfigurationsdialog und gelten nur für diesen Client. Ein Standard vom Langdock-Client gilt nicht für eine Verbindung über einen eigenen Client.
* Lass ein Feld leer, wenn Mitglieder den Wert beim Verbinden eingeben sollen. Trage einen Wert ein, um den Standard zu setzen, zum Beispiel `https://acme.service-now.com`. Jedes Feld ist mit **Optional** gekennzeichnet.

<Frame>
  <img src="https://mintcdn.com/langdock-34/KsBXt70lg_eJcgg4/de/images/oauth_connection_details_1.png?fit=max&auto=format&n=KsBXt70lg_eJcgg4&q=85&s=b11146f15f6f499f8e2086aed9ed75a0" alt="Beispiel ServiceNow: Langdock-Client-Karte mit Konfigurieren und der Option, einen weiteren OAuth-Client hinzuzufügen" style={{borderRadius: '6px'}} width="1840" height="510" data-path="de/images/oauth_connection_details_1.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/langdock-34/KsBXt70lg_eJcgg4/de/images/oauth_connection_details_2.png?fit=max&auto=format&n=KsBXt70lg_eJcgg4&q=85&s=18d4eb1f2f2ad31ece8fd981383ee905" alt="Konfigurieren-Dialog mit dem Workspace-Standard https://acme.service-now.com im optionalen Feld ServiceNow URL or Subdomain" style={{borderRadius: '6px'}} width="1840" height="1112" data-path="de/images/oauth_connection_details_2.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/langdock-34/KsBXt70lg_eJcgg4/de/images/oauth_connection_details_3.png?fit=max&auto=format&n=KsBXt70lg_eJcgg4&q=85&s=281c3bdda31dcfb97d566673bace6132" alt="Dialog zum Hinzufügen eines eigenen OAuth-Clients für ServiceNow, mit denselben optionalen OAuth-Verbindungsdetails" style={{borderRadius: '6px'}} width="1840" height="1900" data-path="de/images/oauth_connection_details_3.png" />
</Frame>

Wenn jedes zusätzliche Feld bereits einen gespeicherten Wert hat, gehen Mitglieder direkt zur Anmeldung. Ist ein Feld leer, geben sie es weiterhin ein. Workspace-Admins, die diesen Dialog sehen, bekommen ein Banner mit einem Link zurück zu den Integrationseinstellungen.

<Frame>
  <img src="https://mintcdn.com/langdock-34/KsBXt70lg_eJcgg4/de/images/oauth_connection_details_4.png?fit=max&auto=format&n=KsBXt70lg_eJcgg4&q=85&s=5aa7607539270420499e6b47dc67b521" alt="Dialog zum Einrichten der ServiceNow-Verbindung mit leerem Zusatzfeld und Admin-Banner zur Einstellungsseite" style={{borderRadius: '6px'}} width="1840" height="1136" data-path="de/images/oauth_connection_details_4.png" />
</Frame>

Der Dialogtitel, die Feldbezeichnung und der Platzhalter bleiben auf Englisch. Das Banner und die Schaltfläche **Weiter zu ServiceNow** folgen der App-Sprache.

Die Microsoft-**Tenant ID** bleibt ein separates Feld unter **Credentials**. Bestehende Verbindungen behalten ihre gespeicherten Werte. Neue Verbindungen und die erneute Autorisierung nutzen die aktuellen Standards.

## 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.

<Warning>
  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.
</Warning>

## Häufige Konfigurationsfehler

<AccordionGroup>
  <Accordion title="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
  </Accordion>

  <Accordion title="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
  </Accordion>

  <Accordion title="consent_required">
    **Ursache**: Admin-Zustimmung erforderlich, aber nicht erteilt.

    **Lösung**:

    * Erteile die Admin-Zustimmung in deinen Tenant-Einstellungen
    * Aktiviere ggf. die Zustimmung durch Nutzer, falls dies für deine Organisation passend ist
    * Prüfe die Anforderungen an Tenant-Freigabelisten
  </Accordion>

  <Accordion title="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)
  </Accordion>

  <Accordion title="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
  </Accordion>
</AccordionGroup>

***

## 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.

### UiPath

UiPath hat keinen von Langdock verwalteten OAuth-Client. Externe Applications werden pro Automation-Cloud-Organisation registriert. Deshalb muss ein UiPath-Admin in deiner Organisation eine Confidential Application anlegen, bevor User Orchestrator verbinden können.

<Expandable title="wie du einen UiPath-OAuth-Client konfigurierst" collapsible>
  **In UiPath**

  1. Öffne unter der Organisation **Admin → External applications → OAuth apps**.
  2. Klicke auf **Add application** und wähle **Confidential application**.
  3. Unter **Orchestrator** vergebe die in Langdock angezeigten Scopes nur unter **User Scope(s)**. Lass **Application Scope(s)** leer.
  4. Füge die Langdock-**Redirect URL** ein und speichere.
  5. Kopiere **Application ID** und **app secret**.

  **In Langdock**

  1. Öffne **UiPath** unter [Workspace Einstellungen → Integrationen](https://app.langdock.com/settings/workspace/products/integrations).
  2. Klicke auf **Konfiguriere deinen OAuth-Client, um diese Integration zu nutzen.**
  3. Füge Application ID und App Secret ein, speichere, und aktiviere den Client.

  **Erforderliche Input-Felder für die Authentifizierung**

  * **UiPath Cloud URL** (Organisation und Tenant)

  Speichere die **UiPath Cloud URL** als Workspace-Standard unter **OAuth-Verbindungsdetails**, zum Beispiel `https://cloud.uipath.com/acme/DefaultTenant/orchestrator_/`. Wenn du das Feld leer lässt, fügt das verbindende Mitglied eine solche URL ein oder gibt `org` / `org/tenant` ein. Langdock führt einen user-delegated OAuth-Flow mit den Orchestrator-Rechten dieses Users aus.

  **Vollständige Guides**

  * [UiPath Setup-Guide](/de/admin/manage-integrations/integration-setup-guides/uipath) (Langdock-Anleitung)
  * [UiPath OAuth-Apps-Überblick](https://docs.uipath.com/automation-cloud/automation-cloud/latest/admin-guide/authorizing-external-applications) (Confidential Apps und User Scopes)

  ### Anforderungen für die UiPath-Integration

  <AccordionGroup>
    <Accordion title="Werden selbst gehostete oder cloudbasierte Konten unterstützt?">
      Nur UiPath Automation Cloud. Automation Suite und andere Self-Hosted-Hosts werden nicht unterstützt.
    </Accordion>

    <Accordion title="Warum gibt es keinen von Langdock verwalteten OAuth-Client?">
      Externe OAuth-Apps werden pro UiPath-Organisation registriert. Ein Client aus einer Organisation deckt nicht alle Langdock-Kunden ab. Jede Organisation legt deshalb ihre eigene Confidential Application an.
    </Accordion>

    <Accordion title="Sind besondere Berechtigungen oder Rollen erforderlich?">
      Ja.

      * Ein UiPath-Admin legt die External Application an.
      * Scopes liegen unter **User Scope(s)** für Orchestrator, nicht unter Application Scope(s).
      * Verbindende User brauchen Orchestrator-Zugriff auf die Folders und Processes, die sie in Langdock nutzen.
    </Accordion>

    <Accordion title="Was ist mit UiPath Automation Hub?">
      Separate Integration. Sie nutzt ein Open-API-Token (API Key), nicht diesen OAuth-Client.

      Token-Setup und Least-Privilege-Hinweise stehen im [UiPath Setup-Guide](/de/admin/manage-integrations/integration-setup-guides/uipath#uipath-automation-hub).
    </Accordion>
  </AccordionGroup>
</Expandable>

### ServiceNow

<Expandable title="wie du einen ServiceNow-OAuth-Client konfigurierst" collapsible>
  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](https://www.servicenow.com/docs/r/xanadu/security-management/security-incident-response/configure-application-registry-splunk.html?contentId=CHQRQznfzOrL_mxxa8MoCA) folgen.

  \
  **Erforderliche Input-Felder für die Authentifizierung**

  * ServiceNow-Subdomain angeben

  Speichere die ServiceNow-Subdomain als Workspace-Standard unter **OAuth-Verbindungsdetails**. Wenn du das Feld leer lässt, geben Mitglieder sie beim Verbinden ein.

  ### Anforderungen für die ServiceNow-Integration

  <AccordionGroup>
    <Accordion title="Werden selbst gehostete oder cloudbasierte Konten unterstützt?">
      Derzeit werden nur cloudbasierte Konten unterstützt.
    </Accordion>

    <Accordion title="Ist ein bezahlter ServiceNow-Plan erforderlich?">
      Ein bezahltes ServiceNow-Konto ist erforderlich, um eine Application Registry zu erstellen. Mehr Informationen [hier](https://www.servicenow.com/lpgp/pricing.html?campid=107977\&cid=p:all:dg:b:prsp:exa:Google_CoreBrand_Top_Restructure:latam:mx\&ds_c=GOOG_LATAM_MX_ES_DEMANDGEN_ALBU_PRSP_Brand_EXA_Top-RES\&cmcid=71700000102193357\&ds_ag=Servicenow+Pricing_EXA_EN\&cmpid=58700008155106586\&ds_kids=p74103339564).
    </Accordion>

    <Accordion title="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](https://www.servicenow.com/docs/bundle/zurich-platform-security/page/integrate/identity/task/view-permissions-for-a-group.html).
    </Accordion>

    <Accordion title="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](https://www.servicenow.com/docs/bundle/zurich-api-reference/page/integrate/inbound-rest/concept/inbound-REST-API-rate-limiting.html).
    </Accordion>
  </AccordionGroup>
</Expandable>

### Shopify Admin

Shopify Admin hat keine von Langdock verwaltete OAuth App. Ein Workspace Admin erstellt eine App im Shopify Dev Dashboard und trägt Client ID und Client Secret in Langdock ein. Connections nutzen [Berechtigungen auf Anwendungsebene](/de/using-langdock/integrations/connections#benutzerdefinierte-scopes-und-berechtigungen-auf-anwendungsebene): Langdock handelt mit den Admin API Scopes der App, nicht mit der persönlichen Shopify Rolle der Person, die installiert hat.

<Expandable title="wie du einen Shopify Admin OAuth Client konfigurierst" collapsible>
  Die vollständige Anleitung steht im [Shopify Admin Einrichtungsguide](/de/admin/manage-integrations/integration-setup-guides/shopify).

  **Erforderliche Input-Felder für die Authentifizierung**

  * Store Domain (eine Custom Domain, eine `*.myshopify.com` Domain oder der Store Handle)

  Speichere die Store Domain als Workspace-Standard unter **OAuth-Verbindungsdetails**, zum Beispiel `acme-store.myshopify.com`. Wenn du das Feld leer lässt, geben Mitglieder sie beim Verbinden ein.

  **Aus Langdock in die Shopify App kopieren**

  * Redirect URL aus dem Shopify Admin OAuth Client Dialog
  * Die dort angezeigten Admin API Scopes (oder die vollständige Liste im Einrichtungsguide)

  **Aus Shopify nach Langdock kopieren**

  * Client ID
  * Client secret
</Expandable>

### 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.

<Expandable title="wie du einen Snowflake-OAuth-Client konfigurierst" collapsible>
  **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.

  <Note>
    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](/de/admin/security/static-ip-configuration) für Details.
  </Note>

  ### Einrichtungsanleitung

  <Steps>
    <Step title="Integration in Langdock erstellen">
      Erstelle in deinem Langdock-Arbeitsbereich eine neue Snowflake-Integration und richte einen eigenen OAuth-Client ein.

      <Expandable title="wie du einen eigenen OAuth-Client in Langdock einrichtest" collapsible>
        1. Navigiere zu Integrationen in Langdock
        2. Klicke auf **Add Integration** und wähle **Start from Scratch**
        3. Gib deinen bevorzugten Namen und eine Beschreibung für deine neue Snowflake-Integration ein
        4. Klicke auf **Create**
        5. Authentifizierungstyp: Wähle **OAuth 2.0** aus dem Dropdown
        6. Authentifizierungsfelder: Leer lassen
        7. OAuth-Konfiguration: Speichere deine **OAuth Redirect URL**
      </Expandable>
    </Step>

    <Step title="Security Integration in Snowflake erstellen">
      Wähle in Snowflake deinen Arbeitsbereich und erstelle eine neue Security Integration.

      <Expandable title="wie du eine neue Security Integration in Snowflake erstellst" collapsible>
        1. Erstelle eine neue `.sql`-Datei und füge folgende Abfrage ein:

        ```sql theme={null}
        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;
        ```

        2. Ersetze `<integration_name>` durch einen aussagekräftigen Namen und `<your_redirect_uri>` durch die **OAuth Redirect URL** aus Schritt 1.
        3. 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.
      </Expandable>
    </Step>

    <Step title="Client-ID und Client-Secret abrufen">
      <Expandable title="wie du die Client-ID und Client-Secret aus Snowflake abrufen kannst" collapsible>
        1. Führe im selben Arbeitsbereich folgende Abfrage aus:

        ```sql theme={null}
        SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('<integration_name>');
        ```

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

    <Step title="Account-URL aus Snowflake abrufen">
      <Expandable title="wie du deine Account-URL aus Snowflake abrufst" collapsible>
        1. Klicke auf deinen Kontonamen in der unteren linken Ecke deiner Snowflake-Anwendung
        2. Klicke im Bereich **Account** auf **View Account Details**
        3. Kopiere deine **Account-URL**
      </Expandable>
    </Step>

    <Step title="Integrationseinstellungen in Langdock konfigurieren">
      <Expandable title="wie du deinen Snowflake-OAuth-Client in Langdock konfigurierst" collapsible>
        1. Füge deine **Client-ID** und dein **Client-Secret** aus Schritt 3 in die entsprechenden Eingabefelder deiner neuen Langdock-Integration ein
        2. 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
        ```

        3. Lass **Scopes** leer.
        4. Klicke auf **Save**

        <Note>
          Snowflake OAuth arbeitet mit Rollen, nicht mit Scopes. Lass **Scopes** leer, damit jeder verbindende User seine Standardrolle in Snowflake erhält. Trägst du eine Session-Rolle wie `session:role:SYSADMIN` ein, authentifiziert sich jeder User gegen diese Rolle. Wer sie in Snowflake nicht hat, kann keine Verbindung herstellen.
        </Note>
      </Expandable>
    </Step>

    <Step title="Verbindung testen">
      <Expandable title="wie du eine Verbindung zu deiner Snowflake-Integration hinzufügst" collapsible>
        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!
      </Expandable>
    </Step>
  </Steps>
</Expandable>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.