> For the complete documentation index, see [llms.txt](https://doc.dastra.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.dastra.eu/features/settings/sso/entra-id.md).

# Active Directory (Microsoft Entra ID)

Cette page vous explique comment mettre en place le SSO de Dastra avec Microsoft Entra ID (Active Directory) en utilisant le protocole SAML 2

## Configuration de l'application dans Microsoft Entra ID

* Rendez-vous dans le centre d'administration Microsoft Entra : <https://entra.microsoft.com>
* Dans la navigation à gauche, cliquez sur **Entra ID** > **Enterprise apps**
* Cliquez sur **New application**, puis sur **Create your own application**
* Renseignez le nom de l'application, par exemple « Dastra »
* Sélectionnez **Integrate any other application you don't find in the gallery (Non-gallery)**, puis créez l'application
* Dans la section **Manage**, cliquez sur **Single sign-on** et sélectionnez **SAML**
* Vous arrivez sur cette page :

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2FFSGpi9jjGguXSr61RDRF%2Fimage.png?alt=media&amp;token=6d4d027f-ab3c-4268-aaa3-a1db364f57f1" alt="La page de configuration SAML d&#x27;une application d&#x27;entreprise Microsoft Entra ID"><figcaption></figcaption></figure>

## Configuration du client SSO dans Dastra

### Étape 1 : créez un login SSO SAML dans Dastra

* Allez sur la [page de configuration du SSO de Dastra](https://app.dastra.eu/general-settings/sso) (**Configuration de l'organisation** > **Single sign on**)
* Cliquez sur **Ajouter un login SSO**
* Sélectionnez **SAML2** dans **Choisir le protocole SSO**, puis **Configuration manuelle**
* Saisissez un intitulé de connexion dans **Intitulé de la connexion SSO**, par exemple « Active Directory »

### Étape 2 : configurez le login SSO dans Microsoft Entra ID

* Retournez sur la page de configuration SAML de Microsoft Entra ID
* Cliquez sur **Edit** dans la section **Basic SAML Configuration**
* Saisissez les informations de connexion, affichées en haut du formulaire SAML de Dastra : **Identifier (Entity ID)** et **Reply URL (Assertion Consumer Service URL)** :

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2FbVyuEoCUpfyrfAdxuISv%2Fimage.png?alt=media&amp;token=e7900e67-51f8-49f9-8372-63a8441a8973" alt="La section Basic SAML Configuration avec l&#x27;identifiant et l&#x27;URL de réponse"><figcaption></figcaption></figure>

* Cliquez sur **Save**
* Allez directement à la section **SAML Certificates** pour **télécharger le certificat au format Base64** :

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2FZMEjWbuA8jP3tQtmYp3z%2Fimage.png?alt=media&amp;token=7fe4011b-4fbd-47d8-a1e5-35a9d6058f05" alt="La section SAML Certificates avec le lien de téléchargement du certificat Base64"><figcaption></figcaption></figure>

* Ouvrez le fichier CER avec un éditeur de texte (par exemple le Bloc-notes) et copiez le contenu (Ctrl + C) :

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2F24cdbaEougfoUsYyLhqB%2Fimage.png?alt=media&amp;token=0d76b479-ca42-47b6-b95b-6cd834b204ce" alt="Le contenu du certificat ouvert dans un éditeur de texte"><figcaption></figcaption></figure>

### Étape 3 : ajoutez le certificat au client Dastra

* Retournez dans l'écran de création de la connexion SAML dans Dastra
* Collez le texte du certificat (Ctrl + V) dans le champ **Identity Provider Certificate (RAW)**

### Étape 4 : configurez les URL du fournisseur d'identité dans Dastra

* Dans la section **Set up** de l'application Entra ID, copiez les trois valeurs **Login URL**, **Microsoft Entra Identifier** et **Logout URL** :

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2FleQQ7Y3hv7uaLOtxgLex%2Fimage.png?alt=media&amp;token=f5f72c7a-8a95-4684-8703-6f03cabb4209" alt="La section Set up de l&#x27;application avec les trois URL à copier"><figcaption></figcaption></figure>

* Collez-les dans Dastra en respectant la correspondance suivante :
  * **Login URL** : **Fournisseur d'identité (Identity Provider) single sign on url**
  * **Microsoft Entra Identifier** : **Identity Provider's Entity id (issuer)**
  * **Logout URL** : **Identity Provider Signout url**
* Le formulaire de configuration du SSO dans Dastra doit ressembler à ceci :

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-b601c2bdaccb1a2b64044747d40d0b3dfc5b473c%2Fsettings-sso-entra-dastra-idp-configuration.png?alt=media" alt="Le formulaire SAML de Dastra rempli avec les valeurs de Microsoft Entra ID"><figcaption></figcaption></figure>

* Vous pouvez activer l'option **Utilisateur créé si l'utilisateur n'a jamais été invité dans Dastra**, dans la section **Création automatique des utilisateurs**. Dans ce cas, les comptes de votre annuaire qui n'existent pas encore dans Dastra sont créés au moment de la première connexion :

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-916dbd09f7a2ec53896ab4a83549b621e4c83042%2Fsettings-sso-entra-auto-create-user-option.png?alt=media" alt="L&#x27;option de création automatique des utilisateurs dans le formulaire SSO"><figcaption></figcaption></figure>

* Enregistrez vos changements dans Dastra

{% hint style="info" %}
Avant de lancer le test de la connexion, assurez-vous qu'un utilisateur est bien assigné à la nouvelle application.
{% endhint %}

### Testez votre connexion SSO

Dans Microsoft Entra ID, cliquez sur le bouton **Test** de la section **Test single sign-on** de l'application. Si tout fonctionne, vous êtes redirigé vers Dastra.

{% hint style="info" %}
Si vous n'avez pas activé la création automatique des utilisateurs, l'accès est refusé côté Dastra tant que le compte local n'a pas été créé par une invitation.
{% endhint %}

### Pour aller plus loin

{% content-ref url="/pages/Ip6LewoJ21VMQw3GfxVR" %}
[Problèmes connus](https://doc.dastra.eu/features/settings/sso/known-problems.md)
{% endcontent-ref %}

{% content-ref url="/pages/-MRt3ADwKUCOCNSXGmt9" %}
[SAML 2](https://doc.dastra.eu/features/settings/sso/saml.md)
{% endcontent-ref %}


---

# 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://doc.dastra.eu/features/settings/sso/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.
