> 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-nl/beveiligen-en-beheren/identity-providers/microsoft-entra-id.md).

# Microsoft Entra ID

Gebruik Microsoft Entra ID (voorheen Azure AD) als uw identiteitsprovider, zodat gebruikers zich bij Dispel aanmelden met hun Microsoft-gegevens via OAuth (OIDC) of SAML.

## Overzicht

Verbind Microsoft Entra ID — Microsoft's cloudidentiteitsplatform, voorheen Azure AD genoemd — als de identiteitsprovider van uw organisatie. Zodra deze is verbonden, melden uw gebruikers zich bij Dispel aan met hun Microsoft-gegevens via eenmalige aanmelding. U kunt Entra verbinden via **OAuth (OIDC)** of **SAML**.

Deze pagina behandelt de Entra-specifieke configuratie. Voor het gedeelde gedrag dat voor elke provider geldt — hoe gebruikers zich aanmelden, groepskoppeling, MFA en ontkoppelen — zie [Identiteitsproviders](/documentation/documentation-nl/beveiligen-en-beheren/identity-providers.md).

{% hint style="info" %}
**Waar u het kunt vinden.** Meld u aan als beheerder van de organisatie en open **Instellingen → Integraties** (of de aparte **Instellingen → Authenticatie** pagina). Microsoft Entra ID verschijnt in de **Identiteit & Authenticatie (IdP / SSO)** . Klik op **Verbinden** op de kaart om te beginnen.
{% endhint %}

## Voordat u begint

* U configureert de IdP-zijde in het **Microsoft Entra-beheercentrum** (of Azure Portal), dus daar heeft u beheerdersrechten voor nodig.
* Kies een protocol — **OAuth (OIDC)** of **SAML**. Zie [Een protocol kiezen](/documentation/documentation-nl/beveiligen-en-beheren/identity-providers.md#choosing-a-protocol).
* Zorg ervoor dat de gebruikers die via Entra zullen inloggen al **zijn uitgenodigd voor uw organisatie** in Dispel. SSO verifieert gebruikers, maar creëert op zichzelf geen toegang.

{% hint style="warning" %}
**Eén provider tegelijk.** Als uw organisatie al is verbonden met een andere identiteitsprovider, ontkoppel deze dan voordat u Entra verbindt.
{% endhint %}

## Verbinden met OAuth (OIDC)

#### In Microsoft Entra ID

1. Ga in het Microsoft Entra-beheercentrum naar **App-registraties → Nieuwe registratie** en maak een app voor Dispel.
2. Voeg een **Web** omleidings-URI van uw Dispel-adres gevolgd door `/oauth/login-callback` — bijvoorbeeld `https://app.dispel.com/oauth/login-callback`. Bevestig het exacte adres voor uw omgeving bij uw Dispel-contactpersoon als u het niet zeker weet.
3. Onder **Certificaten en geheimen**, maak een **clientgeheim** en kopieer de waarde.
4. Noteer uw **Toepassings-ID (client-ID)** en het OAuth/OIDC-eindpunt van uw tenant.

#### In Dispel

1. Klik op **Verbinden** op de Microsoft Entra ID-kaart en **Selecteer Authenticatieprotocol → OAuth**.
2. Vul de velden in:

| Veld                          | Waarde van Entra                                                                |
| ----------------------------- | ------------------------------------------------------------------------------- |
| **Client-URL**                | Het OAuth/OIDC-eindpunt van uw tenant (waar tokens worden uitgegeven).          |
| **Client-ID**                 | De **Toepassings-ID (client-ID)** uit uw app-registratie.                       |
| **Clientgeheim**              | De clientgeheimwaarde die u hebt gemaakt.                                       |
| **Organisatie-identificatie** | Een unieke identifier die u kiest; gebruikers typen deze in op het inlogscherm. |

3. Klik op **Instellingen opslaan**.

## Verbinden met SAML

#### In Microsoft Entra ID

1. Ga in het Microsoft Entra-beheercentrum naar **Bedrijfsapplicaties → Nieuwe toepassing → Maak uw eigen toepassing**, open vervolgens **Eenmalige aanmelding → SAML**.
2. In **Basis-SAML-configuratie**, plak de waarden die Dispel bovenaan het SAML-formulier toont:
   * **Identifier (Entity ID)** ← Dispel's **Entiteits-ID van serviceprovider (SP)**.
   * **Reply URL (Assertion Consumer Service URL)** ← Dispel's **URL van Assertion Consumer Service**.
3. Verzamel uit de Entra SAML-configuratie:
   * **Login-URL** → Dispel's **SSO-URL**.
   * **Microsoft Entra-identificatie** → Dispel's **Entiteits-ID van identiteitsprovider**.
   * Download het **Certificaat (Base64)** → Dispel's **Base64-ondertekeningscertificaat**.

#### In Dispel

1. Klik op **Verbinden** op de Microsoft Entra ID-kaart en **Selecteer Authenticatieprotocol → SAML**.
2. Kopieer de **Entiteits-ID van serviceprovider (SP)** en **URL van Assertion Consumer Service** die bovenaan het formulier wordt weergegeven (gebruik **ID kopiëren** / **URL kopiëren**) in Entra, zoals hierboven.
3. Vul de velden in:

| Veld                                     | Waarde van Entra                                                                  |
| ---------------------------------------- | --------------------------------------------------------------------------------- |
| **SSO-URL**                              | De Entra **Login-URL**.                                                           |
| **Entiteits-ID van identiteitsprovider** | De **Microsoft Entra-identificatie**.                                             |
| **Base64-ondertekeningscertificaat**     | Het gedownloade Base64-certificaat. Plak het of gebruik **Certificaat uploaden**. |
| **Organisatie-identificatie**            | Een unieke identifier die u kiest; gebruikers typen deze in op het inlogscherm.   |

4. Klik op **Instellingen opslaan**.
5. Klik op **Verbinding testen**. Dispel verwijst u door naar Entra om in te loggen en toont vervolgens het ontvangen e-mailadres en de ontvangen naam. Als de test mislukt, controleer dan of de waarden overeenkomen met uw Entra-app en of de testgebruiker is uitgenodigd voor uw organisatie.

## Na het verbinden

* **Gebruikers melden zich aan** door uw Organisatie-identifier in te voeren op het Dispel-inlogscherm en zich te verifiëren met Microsoft. Zie [Hoe gebruikers zich aanmelden](/documentation/documentation-nl/beveiligen-en-beheren/identity-providers.md#how-users-sign-in).
* **Koppel Entra-groepen aan Dispel-groepen** zodat het lidmaatschap synchroon blijft — zie [OIDC-groepskoppeling](/documentation/documentation-nl/integreren-en-beheren/integrations/oidc-group-mapping.md).
* **MFA** die in Entra wordt afgedwongen, geldt tijdens het inloggen; Dispel's eenmalige e-mailcodes gelden niet voor SSO-gebruikers. Zie [SSO en multi-factor authenticatie](/documentation/documentation-nl/beveiligen-en-beheren/identity-providers.md#sso-and-multi-factor-authentication).
* **Om van protocol of provider te wisselen**, ontkoppel eerst. Zie [Een provider wisselen of ontkoppelen](/documentation/documentation-nl/beveiligen-en-beheren/identity-providers.md#switching-or-disconnecting-a-provider).

## Veelgestelde vragen

<details>

<summary>Is dit hetzelfde als "Azure AD"?</summary>

Ja. Microsoft heeft Azure Active Directory hernoemd naar Microsoft Entra ID. Als uw Entra-console op sommige plekken nog steeds labels met "Azure AD" toont, is de configuratie hetzelfde.

</details>

<details>

<summary>Welk protocol moet ik gebruiken met Entra?</summary>

Beide werken. Gebruik wat overeenkomt met hoe uw Entra-app is geconfigureerd — een OIDC-appregistratie voor OAuth, of een bedrijfsapplicatie met SAML-eenmalige aanmelding voor SAML.

</details>

<details>

<summary>Mijn SAML-testverbinding is mislukt. Wat moet ik controleren?</summary>

Controleer of de SSO-URL, Entity ID en het certificaat exact overeenkomen met uw Entra SAML-app, of u Dispel's SP Entity ID en ACS-URL in Entra's Basis-SAML-configuratie hebt geplakt, en of de testgebruiker bestaat in Entra en is uitgenodigd voor uw Dispel-organisatie.

</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-nl/beveiligen-en-beheren/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.