Zum Hauptinhalt springen
Steuere, welche Integrationsaktionen in deinem Workspace verfügbar sind und welche OAuth-Scopes Langdock anfragen darf, wenn Nutzer eine Integration verbinden. Nutze diese Seite, wenn du Aktionszugriff prüfen, einen eigenen OAuth-Client vorbereiten oder verstehen möchtest, warum eine Aktion Scope fehlt anzeigt.

​
Wie Scopes Aktionen steuern

Jede Aktion braucht einen oder mehrere OAuth-Scopes in der verbundenen Integration. Eine Outlook Calendar Aktion braucht zum Beispiel Calendars.ReadWrite, bevor sie Kalendereinträge erstellen oder aktualisieren kann. Langdock strukturiert Aktionen nach den Scopes, die für ihre Ausführung erforderlich sind. Wenn du eine Aktion aktivierst oder deaktivierst, kann sich dadurch auch ändern, welche Scopes Langdock bei der verbundenen Integration anfragt. Der für eine neue Verbindung ausgewählte OAuth-Client bestimmt, wie die angefragten Scopes verwaltet werden. Die folgende Tabelle vergleicht, wie verschiedene OAuth-Clients die verfügbaren Scopes einer Aktion verwalten.

​
Neue Aktionen steuern

In deinen Integrations-Einstellungen findest du die Einstellung Neue Aktionen standardmäßig aktiviert. Sie steuert, was passiert, wenn Langdock eine Aktion zu einer bestehenden Integration hinzufügt.
Schalter Neue Aktionen standardmäßig aktiviert in den Workspace Integrationseinstellungen
Langdock prüft, ob der OAuth-Client für die neue Verbindung die benötigten Scopes der Aktion bereits abdeckt.
  • Aktionen mit abgedeckten Scopes werden automatisch aktiviert.
  • Aktionen mit fehlenden Scopes bleiben deaktiviert, bis du die Scopes hinzufügst oder synchronisierst.
Wenn Langdock eine neue Aktion deaktiviert hinzufügt, bekommt jeder aktive Workspace-Admin eine In-App-Benachrichtigung für diese Integration und eine E-Mail für den Workspace. Beide öffnen die Integrations-Einstellungen, damit du die Aktion aktivieren kannst. Eine Löschen-Aktion bleibt gesperrt, solange Löschen-Aktionen aktivieren aus ist.
In Dedicated Deployments wird die E-Mail nur gesendet, wenn das Deployment für den E-Mail-Versand konfiguriert ist. Die In-App-Benachrichtigung wird trotzdem erstellt.
Dieselbe Logik gilt, wenn Langdock einer bestehenden Aktion einen Scope hinzufügt. Ein neuer Scope erweitert nie automatisch, was Langdock beim verbundenen Dienst anfragen darf. Langdock schickt für diese Änderung keine In-App-Benachrichtigung und keine E-Mail.

​
Löschen-Aktionen aktivieren

In deinen Integrations-Einstellungen steuert Löschen-Aktionen aktivieren jede Aktion vom Typ Löschen. Der Schalter steht neben Neue Aktionen standardmäßig aktiviert und ist standardmäßig eingeschaltet.
Eingebaute Integrationen verwalten mit eingeschaltetem Schalter Löschen-Aktionen aktivieren
Jede Löschen-Aktion behält den Status, den du für sie gesetzt hast. Aktionen vom Typ Anzeigen und Ändern hängen nicht an diesem Schalter.
Eingebaute Integrationen verwalten mit ausgeschaltetem Schalter Löschen-Aktionen aktivieren
Aktionsliste: Anzeigen und Ändern bleiben an, Delete expense ist aus und gesperrt. Der Tooltip sagt, dass ein Workspace-Admin Löschen-Aktionen ausgeschaltet hat.
Schalte Löschen-Aktionen aktivieren wieder ein. Jede Löschen-Aktion kehrt dann zu der Einstellung zurück, die sie vorher hatte.

​
OAuth-Client-Modus wählen

Wenn du eine Integration nutzt, kannst du den Langdock Client verwenden oder Bring Your Own OAuth Client nutzen. Wähle in deinen Integrations-Einstellungen eine eingebaute Integration aus und scrolle zu Scopes und Aktionszugriff, um den OAuth-Client-Modus für diese Integration zu konfigurieren.
Nutze den Langdock Client, wenn Langdock OAuth-Scopes für dich verwalten soll. Das ist in Multi-Tenant Cloud der Standard für Integrationen, bei denen Langdock einen verwalteten OAuth-Client bereitstellt.Langdock fragt die Auth-Scopes an, die zur Identifikation des Nutzers nötig sind, zum Beispiel openid, email und offline_access. Dazu kommen die Scopes der Aktionen, die für alle aktiviert oder mit bestimmten Nutzern und Gruppen geteilt sind.Du musst die Scopes in diesem Modus nicht manuell verwalten. Langdock aktualisiert sie automatisch, wenn du Aktionen aktivierst, deaktivierst oder teilst.
Bereich Scopes und Aktionszugriff mit aktivem Langdock Client und Scopes mit Status-Badges

​
Scope-Status prüfen

Nutze Scope-Ansicht, um zu sehen, welche Scopes aktuell angefragt werden. Scopes mit grünem Haken werden angefragt. Scopes mit rotem X werden nicht angefragt.
Scope-Ansicht im Bereich Scopes und Aktionszugriff mit geöffneter Scope-Gruppe und den zugehörigen Aktionen
Nutze Aktion-Ansicht, um Aktionen einzeln zu verwalten. Diese Ansicht ist hilfreich, wenn du eine Aktion suchen, nach Status sortieren oder die Scopes einer bestimmten Aktion prüfen möchtest.
Aktion-Ansicht im Bereich Scopes und Aktionszugriff mit Aktionen, benötigten Scopes und Aktivierungs-Schaltern
Wenn eine Aktion einen Scope braucht, der aktuell nicht angefragt wird, fahre mit der Maus über Scope fehlt. Beim Langdock Client fügt Langdock den Scope hinzu, sobald du die Aktion aktivierst und die Änderung bestätigst.
Tooltip auf dem Badge Scope fehlt im Langdock Client Modus mit dem Hinweis, die Aktion zu aktivieren

​
Scope-Änderungen bestätigen

Wenn deine Änderung einen Scope hinzufügt oder entfernt, zeigt Langdock zuerst einen Bestätigungsdialog. Nach der Bestätigung müssen Nutzer ihre Verbindung aktualisieren, bevor der neu gewährte Scope verfügbar ist.
Bestätigungsdialog, der beim Aktivieren einer Aktion einen neuen OAuth-Scope ankündigt
Bestehende Verbindungen behalten ihre gewährten Scopes, bis Nutzer die Verbindung aktualisieren oder der Access Token abläuft.

​
Aktionszugriff verwalten

Jede Aktion kann für alle Nutzer verfügbar sein oder mit bestimmten Nutzern und Gruppen geteilt werden. Wie du steuerst, wer eine Integration und ihre Aktionen nutzen kann, erfährst du unter Aktionszugriff verwalten.

​
Was sich in diesem Modus ändert

​
Native Aktionen

Native Aktionen, die Kernfunktionen von Langdock steuern, bleiben aktiv. Du kannst sie nicht ausschalten. Diese nativen Aktionen unterstützen:
  • Dateianhänge aus Integrationen in Chat und Agents.
  • Folder Sync.
  • Company Knowledge.
  • Zugriffskontrollen für synchronisierte Anhänge aus Integrationen.
Native Aktionen, die in Formularen Namen statt roher IDs anzeigen, kannst du ausschalten. Solange die Aktion aktiv ist, zeigen Formulare Namen. Schaltest du sie aus, akzeptieren die Felder rohe IDs.
Aktion-Ansicht: List files in folder ist gesperrt und eingeschaltet, Resolve file ist eingeschaltet. Der Tooltip sagt, dass Formulare Namen statt roher IDs zeigen und dass die Scopes nicht mehr angefragt werden, wenn du die Aktion ausschaltest.
Aktion-Ansicht: List files in folder bleibt gesperrt, Resolve file ist aus und es erscheint kein Teilen-Button. Der Tooltip sagt, dass Felder rohe IDs akzeptieren und die Scopes nicht mehr angefragt werden.
Wenn du den Langdock Client oder einen eigenen OAuth-Client mit aktivierter Einstellung Scopes von aktivierten Aktionen synchronisieren verwendest, bleiben die Scopes der nativen Aktionen, die du nicht ausschalten kannst, in den angefragten Scopes. Schaltest du eine native Aktion aus, die Namen statt roher IDs anzeigt, fragt Langdock ihre Scopes nicht mehr an, wenn keine andere aktivierte oder geteilte Aktion sie noch braucht. Mit einem eigenen OAuth-Client, der feste Scopes verwendet, kannst du ein Setup konfigurieren, in dem Langdock die Scopes für native Aktionen nicht anfragt. Diese Schalter ändern eine feste Scope-Liste nicht.
Wenn du die Scopes für die oben genannten nativen Aktionen nicht anfragst, kann das diese Funktionen beeinträchtigen. Es kann auch die Nutzererfahrung außerhalb der direkten Nutzung dieser Integrationen in Chat, Agents oder Workflows beeinflussen.

​
Scope-Konfiguration exportieren

Klicke auf Scope Konfiguration exportieren, um eine CSV-Datei mit der aktuellen Aktions- und Scope-Konfiguration herunterzuladen.
Button Scope Konfiguration exportieren im Bereich Scopes und Aktionszugriff mit Tooltip zum Inhalt der CSV-Datei
Der Export enthält den Namen, die Beschreibung, die benötigten Scopes, den Aktivierungsstatus und die Freigabekonfiguration jeder Aktion. Nutze ihn, wenn du Integrationszugriff mit deinem Security-Team oder dem Admin deines OAuth-Clients prüfen möchtest.

​
FAQ

Die Aktion ist deaktiviert, wenn Neue Aktionen standardmäßig aktiviert ausgeschaltet ist, wenn der für neue Verbindungen ausgewählte OAuth-Client nicht alle Scopes anfragt, die die Aktion benötigt, oder wenn die Aktion vom Typ Löschen ist und Löschen-Aktionen aktivieren aus ist.Startet eine neue Aktion deaktiviert, weil Neue Aktionen standardmäßig aktiviert aus ist oder Scopes fehlen, bekommt jeder aktive Workspace-Admin eine In-App-Benachrichtigung und eine E-Mail. Wenn du Löschen-Aktionen aktivieren ausschaltest, schickt Langdock dafür keine Benachrichtigung.Du kannst die Aktion je nach OAuth-Setup einschalten, außer es ist eine Löschen-Aktion und Löschen-Aktionen aktivieren ist aus. Der Schalter dieser Aktion bleibt gesperrt, bis Löschen-Aktionen aktivieren an ist. Beim Einschalten einer anderen Aktion können zusätzliche Berechtigungen zu den angefragten Scopes hinzukommen. Wenn du feste Scopes verwendest, füge die fehlenden Scopes zuerst zu deinem OAuth-Client hinzu.Um zukünftige Aktionen automatisch zu aktivieren, wenn alle benötigten Scopes bereits Teil des OAuth-Clients sind, aktiviere Neue Aktionen standardmäßig aktiviert. Löschen-Aktionen folgen weiterhin Löschen-Aktionen aktivieren.
Der Schalter erscheint nur bei eigenen OAuth-Clients. Der Langdock Client synchronisiert Scopes immer mit aktivierten und geteilten Aktionen.
Bestehende Verbindungen behalten die Scopes, die beim Verbinden gewährt wurden. Nachdem du einen Scope hinzugefügt hast, müssen Nutzer ihre Verbindung aktualisieren, bevor der neue Scope gewährt wird.
Öffne das Einstellungssymbol auf der Karte des eigenen Clients, der für die betroffenen Nutzer gilt. Prüfe, ob der Scope dort und als API-Berechtigung in deiner Azure App Registration eingetragen ist. Wenn eine Admin-Freigabe erforderlich ist, prüfe auch diese Freigabe.
Ja. Deaktiviere Neue Aktionen standardmäßig aktiviert. Bestehende Aktionen behalten ihren Status. Neue Aktionen bleiben deaktiviert, bis du sie prüfst. Eine Löschen-Aktion folgt weiterhin Löschen-Aktionen aktivieren.
Ja. Ein Workspace kann einen Client für den gesamten Workspace, mehrere Clients mit Nutzerauswahl und Gruppen-Clients aktiv lassen, deren Mitglieder sich nicht überschneiden. Jeder Client hat eine eigene Scope-Liste und eine eigene Scope-Sync-Einstellung.
Mit dem Langdock Client oder einem eigenen OAuth-Client mit aktivierter Einstellung Scopes von aktivierten Aktionen synchronisieren entfernt Langdock einen Scope nur, wenn keine aktivierte oder geteilte Aktion ihn mehr braucht. Auth-Scopes wie offline_access und openid werden immer angefragt.Mit festen Scopes ändert Langdock angefragte Scopes nie automatisch.

​
Verwandte Seiten

Bring Your Own OAuth Client

Richte eine eigene OAuth-Anwendung für eine Integration ein.

Integrations-Einstellungen

Prüfe den Aktionszugriff in deinem Workspace.

Microsoft

Erteile tenantweite Admin-Freigabe für Microsoft-Integrationen.

Integrations-Leitfaden

Lerne, wie Integrationen in Langdock funktionieren.