> For the complete documentation index, see [llms.txt](https://docs.dispel.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dispel.com/documentation/documentation-de/absichern-and-steuern/identity-providers/microsoft-entra-id.md).

# Microsoft Entra ID

Verwenden Sie Microsoft Entra ID (früher Azure AD) als Ihren Identitätsanbieter, damit sich Benutzer mit ihren Microsoft-Anmeldedaten über OAuth (OIDC) oder SAML bei Dispel anmelden.

## Übersicht

Verbinden Sie Microsoft Entra ID — Microsofts Cloud-Identitätsplattform, früher bekannt als Azure AD — als Identitätsanbieter Ihrer Organisation. Sobald die Verbindung hergestellt ist, melden sich Ihre Benutzer mit ihren Microsoft-Anmeldedaten per Single Sign-on bei Dispel an. Sie können Entra über **OAuth (OIDC)** oder **SAML**.

Auf dieser Seite wird die Entra-spezifische Einrichtung behandelt. Das gemeinsame Verhalten, das für jeden Anbieter gilt — wie sich Benutzer anmelden, Gruppen zugeordnet werden, MFA und das Trennen der Verbindung — finden Sie unter [Identitätsanbieter](/documentation/documentation-de/absichern-and-steuern/identity-providers.md).

{% hint style="info" %}
**Wo Sie es finden.** Melden Sie sich als Organisationsadministrator an und öffnen Sie **Einstellungen → Integrationen** (oder die separate **Einstellungen → Authentifizierung** (Seite). Microsoft Entra ID erscheint in der **Identität & Authentifizierung (IdP / SSO)** Abschnitt. Klicken Sie auf **Verbinden** auf die Kachel, um zu beginnen.
{% endhint %}

## Bevor Sie beginnen

* Sie konfigurieren die IdP-Seite im **Microsoft Entra Admin Center** (oder im Azure-Portal), daher benötigen Sie dort administrativen Zugriff.
* Legen Sie ein Protokoll fest — **OAuth (OIDC)** oder **SAML**. Siehe [Protokoll auswählen](/documentation/documentation-de/absichern-and-steuern/identity-providers.md#choosing-a-protocol).
* Stellen Sie sicher, dass die Benutzer, die sich über Entra anmelden werden, bereits **zu Ihrer Organisation eingeladen sind** in Dispel. SSO authentifiziert Benutzer, erstellt aber keinen Zugriff von sich aus.

{% hint style="warning" %}
**Immer nur ein Anbieter gleichzeitig.** Wenn Ihre Organisation bereits mit einem anderen Identitätsanbieter verbunden ist, trennen Sie die Verbindung, bevor Sie Entra verbinden.
{% endhint %}

## Mit OAuth (OIDC) verbinden

#### In Microsoft Entra ID

1. Gehen Sie im Microsoft Entra Admin Center zu **App-Registrierungen → Neue Registrierung** und erstellen Sie eine App für Dispel.
2. Fügen Sie eine **Web** Umleitungs-URI Ihrer Dispel-Adresse, gefolgt von `/oauth/login-callback` — zum Beispiel `https://app.dispel.com/oauth/login-callback`. Bestätigen Sie die genaue Adresse für Ihre Umgebung bei Ihrem Dispel-Ansprechpartner, wenn Sie unsicher sind.
3. Unter **Zertifikate & Geheimnisse**erstellen Sie eine **Client Secret** und kopieren Sie ihren Wert.
4. Notieren Sie sich Ihre **Anwendungs-(Client-)ID** und den OAuth/OIDC-Endpunkt Ihres Mandanten.

#### In Dispel

1. Klicken Sie auf **Verbinden** auf der Microsoft Entra ID-Karte und **Wählen Sie Authentifizierungsprotokoll → OAuth**.
2. Füllen Sie die Felder aus:

| Feld                     | Wert aus Entra                                                                             |
| ------------------------ | ------------------------------------------------------------------------------------------ |
| **Client-URL**           | Der OAuth/OIDC-Endpunkt Ihres Mandanten (wo Tokens ausgegeben werden).                     |
| **Client-ID**            | Die **Anwendungs-(Client-)ID** aus Ihrer App-Registrierung.                                |
| **Client Secret**        | Der von Ihnen erstellte Client-Secret-Wert.                                                |
| **Organisationskennung** | Eine eindeutige Kennung, die Sie wählen; Benutzer geben sie auf dem Anmeldebildschirm ein. |

3. Klicken Sie auf **Einstellungen speichern**.

## Mit SAML verbinden

#### In Microsoft Entra ID

1. Gehen Sie im Microsoft Entra Admin Center zu **Unternehmensanwendungen → Neue Anwendung → Eigene Anwendung erstellen**, dann öffnen Sie **Einmalanmeldung → SAML**.
2. In **Grundlegende SAML-Konfiguration**fügen Sie die Werte ein, die Dispel oben in seinem SAML-Formular anzeigt:
   * **Kennung (Entity ID)** ← Dispels **Entity-ID des Service Providers (SP)**.
   * **Antwort-URL (Assertion Consumer Service URL)** ← Dispels **Assertion Consumer Service URL**.
3. Erfassen Sie aus der Entra-SAML-Einrichtung:
   * **Anmelde-URL** → Dispels **SSO-URL**.
   * **Microsoft Entra-Kennung** → Dispels **Entity-ID des Identitätsanbieters**.
   * Laden Sie das **Zertifikat (Base64)** → Dispels **Base64-Signaturzertifikat**.

#### In Dispel

1. Klicken Sie auf **Verbinden** auf der Microsoft Entra ID-Karte und **Wählen Sie Authentifizierungsprotokoll → SAML**.
2. Kopieren Sie die **Entity-ID des Service Providers (SP)** und **Assertion Consumer Service URL** oben im Formular angezeigt werden (verwenden Sie **ID kopieren** / **URL kopieren**) in Entra hoch, wie oben beschrieben.
3. Füllen Sie die Felder aus:

| Feld                                  | Wert aus Entra                                                                                        |
| ------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| **SSO-URL**                           | Das Entra **Anmelde-URL**.                                                                            |
| **Entity-ID des Identitätsanbieters** | Die **Microsoft Entra-Kennung**.                                                                      |
| **Base64-Signaturzertifikat**         | Das heruntergeladene Base64-Zertifikat. Fügen Sie es ein oder verwenden Sie **Zertifikat hochladen**. |
| **Organisationskennung**              | Eine eindeutige Kennung, die Sie wählen; Benutzer geben sie auf dem Anmeldebildschirm ein.            |

4. Klicken Sie auf **Einstellungen speichern**.
5. Klicken Sie auf **Verbindung testen**. Dispel leitet Sie zur Anmeldung zu Entra weiter und zeigt dann die E-Mail-Adresse und den Namen an, die es erhalten hat. Wenn der Test fehlschlägt, vergewissern Sie sich, dass die Werte zu Ihrer Entra-App passen und dass der Testbenutzer in Ihre Organisation eingeladen ist.

## Nach der Verbindung

* **Benutzer melden sich an** indem Sie Ihre Organisationskennung auf dem Dispel-Anmeldebildschirm eingeben und sich mit Microsoft authentifizieren. Siehe [Wie sich Benutzer anmelden](/documentation/documentation-de/absichern-and-steuern/identity-providers.md#how-users-sign-in).
* **Entra-Gruppen Dispel-Gruppen zuordnen** damit die Mitgliedschaft synchron bleibt — siehe [OIDC-Gruppenmapping](/documentation/documentation-de/integrieren-and-administrieren/integrations/oidc-group-mapping.md).
* **MFA** in Entra erzwungen wird, gilt während der Anmeldung; Dispels einmalige E-Mail-Codes gelten nicht für SSO-Benutzer. Siehe [SSO und Multi-Faktor-Authentifizierung](/documentation/documentation-de/absichern-and-steuern/identity-providers.md#sso-and-multi-factor-authentication).
* **Um Protokolle oder Anbieter zu wechseln**, trennen Sie zuerst die Verbindung. Siehe [Einen Anbieter wechseln oder die Verbindung trennen](/documentation/documentation-de/absichern-and-steuern/identity-providers.md#switching-or-disconnecting-a-provider).

## Häufig gestellte Fragen

<details>

<summary>Ist das dasselbe wie „Azure AD“?</summary>

Ja. Microsoft hat Azure Active Directory in Microsoft Entra ID umbenannt. Wenn Ihre Entra-Konsole an manchen Stellen weiterhin die Bezeichnung „Azure AD“ anzeigt, ist die Einrichtung dieselbe.

</details>

<details>

<summary>Welches Protokoll sollte ich mit Entra verwenden?</summary>

Beides funktioniert. Verwenden Sie das, was zu Ihrer Entra-App-Konfiguration passt — eine OIDC-App-Registrierung für OAuth oder eine Unternehmensanwendung mit SAML Single Sign-on für SAML.

</details>

<details>

<summary>Meine SAML-Testverbindung ist fehlgeschlagen. Was sollte ich prüfen?</summary>

Bestätigen Sie, dass die SSO-URL, die Entity ID und das Zertifikat genau zu Ihrer Entra-SAML-App passen, dass Sie Dispels SP-Entity-ID und ACS-URL in Entra unter Grundlegende SAML-Konfiguration eingefügt haben und dass der Testbenutzer in Entra vorhanden ist und in Ihre Dispel-Organisation eingeladen wurde.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.dispel.com/documentation/documentation-de/absichern-and-steuern/identity-providers/microsoft-entra-id.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.