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

# Microsoft Entra ID Einrichtung

> Stelle Nutzer von Entra ID zu Langdock mittels SCIM bereit.

## Überblick

Diese Anleitung führt dich durch die Konfiguration von SCIM Benutzerbereitstellung mit Microsoft Entra ID. Du verbindest deine bestehende Unternehmensanwendung mit dem SCIM-Endpunkt von Langdock und konfigurierst die automatische Benutzersynchronisierung.

Nach Abschluss werden Benutzeränderungen in Entra ID automatisch mit Langdock synchronisiert.

## Setup Checkliste

Stelle sicher, dass du diese Schritte aus der [Setup Checkliste](/de/admin/security/scim/scim#setup-checkliste) abgeschlossen hast:

<Warning>
  * SAML bereits für deinen Langdock Workspace konfiguriert
  * Eine bestehende Unternehmensanwendung für SAML eingerichtet (siehe [Microsoft Entra ID SAML Einrichtung](/de/admin/security/saml/entra))
  * Ein Entra ID-Konto mit den Rechten zur Verwaltung von Unternehmensanwendungen
</Warning>

## Verbindung konfigurieren

1. Navigiere zu der Unternehmensanwendung, die du für die SAML-Verbindung in deinem Azure Portal eingerichtet hast (wie beschrieben in [https://docs.langdock.com/settings/security/entra](https://docs.langdock.com/settings/security/entra)).

Klicke auf "Erste Schritte" unter "Nutzerkonten bereitstellen".

![Klicke auf „Erste Schritte" unter „Nutzerkonten bereitstellen" in der Enterprise-Anwendung](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2025-01-07/43ed9f77-4315-4b81-ac02-54c9361f7675/ascreenshot.jpeg?tl_px=329,308\&br_px=3082,1847\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=1\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=767,277)

2. Klicke auf "Deine Anwendung verbinden"

![Klicke auf „Deine Anwendung verbinden"](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2025-01-07/a6e2763c-7b0a-4675-8a26-4e6048be0027/ascreenshot.jpeg?tl_px=329,78\&br_px=3082,1617\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=1\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=690,277)

3. Gehe zu deinen [Langdock Sicherheitseinstellungen](https://app.langdock.com/settings/workspace/security) und kopiere den Wert "SCIM Base URL".

![Kopiere den Wert „SCIM Base URL" in den Langdock Sicherheitseinstellungen](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2025-01-07/5551672c-295c-4506-b0aa-685b0f5c964b/ascreenshot.jpeg?tl_px=0,0\&br_px=3082,1984\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=1\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=841,469)

4. Zurück in deinem Azure Portal, gib die SCIM Base URL in das Feld "Tenant URL" ein und (!) hänge `?aadOptscim062020` am Ende der URL an, um [bekannte Probleme in Microsofts Implementierung des SCIM-Protokolls zu beheben](https://learn.microsoft.com/en-us/entra/identity/app-provisioning/application-provisioning-config-problem-scim-compatibility#flags-to-alter-the-scim-behavior).

Deine endgültige "Tenant URL" wird so aussehen: `https://app.langdock.com/api/scim/v2?aadOptscim062020`

![Füge die SCIM Base URL in das Feld „Tenant URL" im Bereich „Admin credentials" ein](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2025-01-07/a8a6001d-fdcf-4667-a639-e875f2b83913/user_cropped_screenshot.jpeg?tl_px=0,0\&br_px=2752,1538\&force_format=jpeg\&q=100\&width=1120.0)

5. Kopiere den Wert "SCIM Bearer Token (API Key)" aus deinen [Langdock Sicherheitseinstellungen](https://app.langdock.com/settings/workspace/security)...

![Kopiere den „SCIM Bearer Token (API Key)"](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2025-01-07/22d0ed87-f405-44f2-a0fa-16698a32d4e2/ascreenshot.jpeg?tl_px=329,445\&br_px=3082,1984\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=1\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=792,425)

6. ...und füge ihn in das Feld "Secret token" in deinem Azure Portal ein.

![Füge ihn in das Feld „Secret token" in deinem Azure Portal ein](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2025-01-07/a381901c-5352-4a98-be0b-6e2b8b3a9d01/user_cropped_screenshot.jpeg?tl_px=0,0\&br_px=2752,1538\&force_format=jpeg\&q=100\&width=1120.0)

7. Schalte "SCIM User Sync Active" ein, um SCIM für deinen Workspace in deinen [Langdock Sicherheitseinstellungen](https://app.langdock.com/settings/workspace/security) zu aktivieren. Dies ist erforderlich, um die Verbindung zu testen.

![Schalte „SCIM User Sync Active" ein](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2025-01-07/165236b4-5ee9-4414-a7fd-9ed1e0b7bf10/user_cropped_screenshot.jpeg?tl_px=329,445\&br_px=3082,1984\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=1\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=832,278)

8. Zurück in deinem Azure Portal klicke auf "Verbindung testen" und du solltest eine Meldung sehen, die bestätigt, dass die Verbindung zwischen Entra ID und Langdock funktioniert.

![Klicke auf „Verbindung testen", um das Pop-up zur Bestätigung der Verbindungserstellung zu sehen](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2025-01-07/601c0f9a-8572-456e-945e-e9289e76f050/user_cropped_screenshot.jpeg?tl_px=0,0\&br_px=3082,1984\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=1\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=106,393)

9. Klicke auf "Erstellen", um die Konfiguration abzuschließen

![Klicke auf „Erstellen", um die Konfiguration abzuschließen](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2025-01-07/376e5d71-1095-418e-90d1-651d7922aa73/ascreenshot.jpeg?tl_px=0,674\&br_px=2343,1984\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=1\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=41,537)

#### Optional: Target Object Actions konfigurieren

Du kannst steuern, welche SCIM-Vorgänge Entra ID in deinem Langdock Workspace ausführt, indem du die **Target Object Actions** im Attributmapping aktivierst oder deaktivierst. Jede Aktion steuert eine andere Art von Bereitstellungsanfrage:

| Aktion     | Funktion                                                                                                                                                                                                                                                                           |
| ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Create** | Neue Nutzer werden in Langdock angelegt, sobald sie der Unternehmensanwendung in Entra ID zugewiesen werden.                                                                                                                                                                       |
| **Update** | Änderungen an Name oder E-Mail eines Nutzers in Entra ID werden nach Langdock synchronisiert. Auch Deaktivierungen sind Updates: Wird ein Nutzer von der Anwendung entfernt, für die Anmeldung gesperrt oder in Entra ID vorläufig gelöscht, entfernt ihn ein Update aus Langdock. |
| **Delete** | Nutzer werden aus Langdock entfernt, sobald sie in Entra ID endgültig gelöscht werden. Entra ID löscht Nutzer 30 Tage nach dem vorläufigen Löschen endgültig oder sofort, wenn sie aus dem Papierkorb entfernt werden.                                                             |

Du kannst diese Aktionen kombinieren, um sie an dein Bereitstellungsmodell anzupassen. Wenn du zum Beispiel nur **Delete** aktivierst:

* Neue Nutzer werden nicht in Langdock angelegt und müssen auf anderem Weg hinzugefügt werden
* Änderungen an Name oder E-Mail werden nicht nach Langdock synchronisiert
* Nicht mehr zugewiesene oder deaktivierte Nutzer bleiben in Langdock, bis Entra ID sie endgültig löscht

Um diese Einstellungen zu ändern, gehe zu "Verwalten" > "Bereitstellung" > "Zuordnungen", wähle das Nutzermapping aus und passe die **Target Object Actions** Checkboxen an.

#### Optional: Gruppensynchronisierung deaktivieren

10. (Optional) Um deine Bereitstellungseinstellungen anzupassen, gehe zu "Verwalten" > "Bereitstellung". Dies könnte nötig sein, wenn du nur Nutzer (aber keine Gruppen) synchronisieren möchtest oder wenn du eine oder mehrere Arten von Objektaktionen (Erstellen, Aktualisieren oder Löschen) deaktivieren möchtest.

Z.B. um die Synchronisierung von Gruppen zu deaktivieren, klicke auf "Zuordnungen" und folge den optionalen Schritten unten

![Passe deine Bereitstellungseinstellungen an](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2025-01-07/880de0b1-52a7-4a7c-9b52-22c33cb11e79/ascreenshot.jpeg?tl_px=0,86\&br_px=2752,1625\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=1\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=219,276)

11. (Optional: Deaktivieren der Gruppensynchronisierung) Klicke auf "Microsoft Entra ID-Gruppen bereitstellen"

![Klicke auf „Microsoft Entra ID-Gruppen bereitstellen"](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2025-01-07/fa5d42cc-55c8-4016-bbc3-b06a6548be4e/ascreenshot.jpeg?tl_px=0,368\&br_px=2752,1907\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=1\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=391,276)

12. (Optional: Deaktivieren der Gruppensynchronisierung) Klicke auf "Nein"

![Klicke auf „Nein"](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2025-01-07/ed81a32e-4ac5-49e1-8d1e-c835361e4d2f/ascreenshot.jpeg?tl_px=0,0\&br_px=2752,1538\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=1\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=58,187)

13. (Optional: Deaktivieren der Gruppensynchronisierung) Klicke auf "Speichern" und dann auf "Ja", um Änderungen zu bestätigen

![Klicke auf „Speichern" und dann auf „Ja", um Änderungen zu bestätigen](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2025-01-07/df1b894a-1c60-4dd7-9542-4e209491ad67/ascreenshot.jpeg?tl_px=0,0\&br_px=2752,1538\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=1\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=22,191)

#### Bereitstellung aktivieren

14. Empfohlen: Öffne "Einstellungen", klicke auf "E-Mail-Benachrichtigung senden, wenn ein Fehler auftritt" und gib deine E-Mail-Adresse ein

![Öffne „Einstellungen" > Klicke auf „E-Mail-Benachrichtigung senden, wenn ein Fehler auftritt"](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2025-01-07/96f58742-33f2-47c3-b52d-4499dde61627/user_cropped_screenshot.jpeg?tl_px=0,234\&br_px=2752,1773\&force_format=jpeg\&q=100\&width=1120.0)

15. Klicke auf "Ein", um den Bereitstellungsstatus zu aktivieren

![Klicke auf „Ein", um den Bereitstellungsstatus zu aktivieren](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2025-01-07/a10b7176-be24-4419-a3a1-38e3603f0cab/ascreenshot.jpeg?tl_px=0,222\&br_px=2752,1761\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=1\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=234,518)

16. Klicke auf "Speichern", um deine Änderungen abzuschließen

![Klicke auf „Speichern", um deine Änderungen abzuschließen](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2025-01-07/463051dc-93d3-4758-a502-0ce6e5aab4e2/ascreenshot.jpeg?tl_px=0,0\&br_px=2752,1538\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=1\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=223,95)

#### Überprüfe deine Einrichtung

17. Um zu überprüfen, ob die Bereitstellung wie erwartet funktioniert, gehe zu "Überwachen" > "Bereitstellungsprotokolle" und prüfe, ob deine Nutzer erfolgreich Langdock zugeordnet wurden.

Falls du keine Protokolle siehst, warte bitte und prüfe in ein paar Minuten erneut. Es kann etwas dauern, bis die erste Synchronisierung ausgelöst wird.

Wenn deine Einrichtung erfolgreich war, wirst du "Erfolg"-Werte in der Statusspalte sehen.

![Gehe zu „Überwachen" > „Bereitstellungsprotokolle", um zu sehen, ob die Einrichtung erfolgreich war](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2025-01-07/a6d3b3a4-4800-4e04-9fc4-81c3b865c38a/user_cropped_screenshot.jpeg?tl_px=0,0\&br_px=3082,1984\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=1\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=2,343)

18. Du solltest auch die neu synchronisierten Nutzer in deinen [Langdock Mitgliedereinstellungen](https://app.langdock.com/settings/workspace/user-management/members) sehen.

![Du solltest die synchronisierten Nutzer in Langdock sehen](https://ajeuwbhvhr.cloudimg.io/colony-recorder.s3.amazonaws.com/files/2025-01-07/52afa39c-1d68-405c-9c14-5d31309785ce/user_cropped_screenshot.jpeg?tl_px=0,0\&br_px=3082,1720\&force_format=jpeg\&q=100\&width=1120.0)

## E-Mail-Adressen aktualisieren (Domain-Änderungen)

Wenn deine Organisation E-Mail-Domains wechselt (z.B. von `@alte-firma.de` zu `@neue-firma.de`), kann SCIM automatisch die E-Mail-Adressen der Nutzer in Langdock aktualisieren, wenn du sie in Entra ID änderst. Allerdings **muss die neue Domain in Langdock konfiguriert werden, bevor die E-Mail-Änderung erfolgt**.

<Warning>
  Wenn du Nutzer-E-Mails in Entra auf eine Domain änderst, die nicht in Langdock hinzugefügt und verifiziert ist, wird die SCIM-Synchronisierung für diese Nutzer fehlschlagen.
</Warning>

### Voraussetzungen

Bevor du E-Mail-Adressen in Entra ID aktualisierst:

1. Die **neue E-Mail-Domain muss hinzugefügt** werden zu den erlaubten Domains in deinen [Langdock Sicherheitseinstellungen](https://app.langdock.com/settings/workspace/security)
2. Die **neue Domain muss verifiziert** werden (Domain-Verifizierung bestätigt, dass du die Domain besitzt)

### Prozess

<Steps>
  <Step title="Neue Domain zum Langdock Workspace hinzufügen">
    Gehe zu deinen [Langdock Sicherheitseinstellungen](https://app.langdock.com/settings/workspace/security) und füge die neue Domain (z.B. `neue-firma.de`) zur Liste der erlaubten Domains hinzu.
  </Step>

  <Step title="Neue Domain verifizieren">
    Füge die neue Domain zu den erlaubten Domains in deinem Workspace hinzu und verifiziere sie dann, indem du den Langdock Support kontaktierst.
  </Step>

  <Step title="Nutzer-E-Mails in Entra ID aktualisieren">
    Sobald die Domain in Langdock hinzugefügt und verifiziert ist, kannst du die E-Mail-Adressen der Nutzer in Microsoft Entra ID aktualisieren. Die SCIM-Bereitstellung synchronisiert diese Änderungen automatisch nach Langdock.
  </Step>

  <Step title="Synchronisierung überprüfen">
    Prüfe die Bereitstellungsprotokolle in Entra ID (Überwachen > Bereitstellungsprotokolle), um zu bestätigen, dass die E-Mail-Aktualisierungen erfolgreich waren. Du kannst auch in deinen [Langdock Mitgliedereinstellungen](https://app.langdock.com/settings/workspace/user-management/members) überprüfen, ob die Nutzer-E-Mails aktualisiert wurden.
  </Step>
</Steps>

<Info>
  Bestehende Nutzerdaten (Chat-Verlauf, Agenten, etc.) bleiben bei der Aktualisierung von E-Mail-Adressen über SCIM erhalten. Die Nutzer werden über ihre SCIM-ID identifiziert, nicht über ihre E-Mail-Adresse.
</Info>