> 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/adfs.md).

# ADFS

Dastra s'intègre avec Adfs, cette page vous explique les spécificités de la configuration du SSO avec AD FS

## Présentation d'ADFS

Les services de fédération Active Directory (généralement désignés sous l'acronyme ADFS) sont une solution d'authentification unique (SSO) conçue par Microsoft. Ces services, qui sont un composant des systèmes d'exploitation Windows Server, permettent aux utilisateurs de s'authentifier via Active Directory (AD) lorsqu'ils souhaitent accéder à une application qui ne peut pas utiliser l'authentification Windows intégrée (IWA).

## Configuration d'ADFS dans Dastra

**Étape 1 : créez un login 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**
* Dans le champ **Identity Provider's Entity id (issuer)**, renseignez l'URL suivante : `http://<adfs server url>/adfs/services/trust`
* Dans le champ **Fournisseur d'identité (Identity Provider) single sign on url**, renseignez : `https://<adfs server url>/adfs/ls`

**Étape 2 : récupérez le certificat ADFS**

* Allez dans le répertoire **Certificates** du serveur ADFS
* Récupérez le certificat .CER de votre serveur ADFS en utilisant le certificat **Token-Signing**.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2F8Qa6tJBB25f8bLISVFmz%2Fimage.png?alt=media&amp;token=c4b3a923-7683-4897-b0a2-df68b8714b84" alt="Le répertoire Certificates du serveur ADFS, avec le certificat Token-Signing"><figcaption></figcaption></figure>

* Cliquez sur **View Certificates**

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2FT20aFcM0ARAg9wOfIU9s%2Fimage.png?alt=media&amp;token=66bccf43-47fc-494f-ab52-0730bbb7c1d3" alt="L&#x27;assistant d&#x27;exportation du certificat"><figcaption></figcaption></figure>

Ouvrez le fichier CER avec un éditeur de texte et copiez le code du certificat X509. Collez-le dans le champ du certificat, entre `-----BEGIN CERTIFICATE-----` et `-----END CERTIFICATE-----`.

La configuration de votre login devrait 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-94fc328737686782725b9c0c9f64c61082bf4789%2Fsettings-sso-adfs-dastra-idp-configuration.png?alt=media" alt="Le formulaire du login SAML dans Dastra, rempli avec les valeurs d&#x27;ADFS"><figcaption></figcaption></figure>

**Étape 3 : conservez les valeurs suivantes.**

* **SP redirect URI** (format : `https://account.dastra.eu/xxxxx-xxxx-xxxx-xxxx/Acs`) : l'URL de retour de l'application, à laquelle le jeton SAML est envoyé. Les algorithmes SHA-256 et supérieurs sont pris en charge. Copiez-la en haut du formulaire SAML.
* **Identity Provider's Entity id (issuer)**, affiché en haut du même formulaire.

Ces deux valeurs servent à configurer le serveur ADFS pour qu'il accepte les requêtes SSO de Dastra.

## Configuration du client Dastra dans ADFS

Voici comment configurer le SSO Dastra avec ADFS SSO SAML2P.

**Étape 1 :** sur votre serveur ADFS, ouvrez **AD FS Management**.

**Étape 2 :** faites un clic droit sur **Relying Party Trusts** et sélectionnez **Add Relying Party Trust**. L'assistant d'ajout de relying party trust se lance.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2FvH0MW014KAG08CeH9ILy%2Fimage.png?alt=media&amp;token=dab6bf6e-bb56-4b5f-8307-639316298137" alt="Le menu Relying Party Trusts dans AD FS Management"><figcaption></figcaption></figure>

**Étape 3 :** sur l'écran **Select Data Source**, choisissez **Enter data about the relying party manually**.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2F48YwxRdI4XmJOjJWwzF1%2Fimage.png?alt=media&amp;token=514c15bf-765b-4322-ba40-0bb461e1795e" alt="L&#x27;écran Select Data Source de l&#x27;assistant"><figcaption></figcaption></figure>

**Étape 4 :** saisissez un **Display name**, par exemple « Dastra », puis cliquez sur **Next**.

**Étape 5 :** choisissez **AD FS profile** (SAML 2.0) et cliquez sur **Next**.

**Étape 6 :** sur l'écran **Configure Certificate**, cliquez sur **Next** sans choisir de certificat.

**Étape 7 :** sélectionnez **Enable support for the SAML 2.0 WebSSO protocol**.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2FQwaFdlinBoDcttlvH694%2Fimage.png?alt=media&amp;token=20d97ebd-31d2-4159-b4ae-fd0a2b031efa" alt="L&#x27;écran Configure URL de l&#x27;assistant"><figcaption></figcaption></figure>

Dans le champ **Relying party SAML 2.0 SSO service URL**, saisissez l'URL **SP redirect URI** affichée dans Dastra. Elle a la forme `https://account.dastra.eu/xxxx-xxxx-xxxx-xxxx/Acs`.

**Étape 8 :** dans la partie **Relying party trust identifier**, ajoutez deux valeurs : `account.dastra.eu` et `https://account.dastra.eu`.

**Étape 9 :** cliquez sur **Next** jusqu'à la fin de l'assistant.

**Étape 10 :** cochez la case **Open the Edit Claim Rules dialog** avant de cliquer sur **Close**. La fenêtre **Edit Claim Rules** s'affiche.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2FBVzaYpFbaNV7NDLnPqFK%2Fimage.png?alt=media&amp;token=59e21d95-b653-4180-a521-ded6d3f1af15" alt="La dernière étape de l&#x27;assistant avec l&#x27;option Edit Claim Rules"><figcaption></figcaption></figure>

**Étape 11 :** cliquez sur **Add Rule** et choisissez le modèle de règle **Send LDAP Attributes as Claims**.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2FaXI80e6Se7zvasSN1YRy%2Fimage.png?alt=media&amp;token=8f98a52f-1172-455e-8d77-ee7399dba3bd" alt="La liste des modèles de règles de claims"><figcaption></figcaption></figure>

**Étape 12 :** mappez les claims comme ci-dessous. Les noms des claims peuvent varier selon la configuration de votre serveur. Dastra a besoin de trois attributs : l'e-mail (obligatoire), le nom et le prénom de l'utilisateur.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2FFVLsMUhfCLdIbj1deRDx%2Fimage.png?alt=media&amp;token=9c23d843-dbb6-41ae-ab53-5ac90e607570" alt="Le mappage des attributs LDAP vers les claims sortants"><figcaption></figcaption></figure>

**Étape 13 :** cliquez sur **Finish**, puis de nouveau sur **Add Rule**. Cette fois, choisissez le modèle **Transform an Incoming Claim** et cliquez sur **Next**.

**Étape 14 :** configurez la règle suivante : **Email Address** => **Name ID** => **Email**.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2FfYslRjagktNP5mc7qA4W%2Fimage.png?alt=media&amp;token=f876fbd8-3e6d-4a25-943d-5be94748ac93" alt="La règle Transform an Incoming Claim configurée pour le Name ID"><figcaption></figcaption></figure>

Appliquez ensuite les changements en cliquant sur **Apply**.

**Étape 15 :** de retour dans la fenêtre **AD FS Management**, faites un clic droit sur le relying party de Dastra et choisissez **Properties**. Dans l'onglet **Advanced**, choisissez SHA-256 comme algorithme sécurisé.

**Étape 16 :** la configuration est terminée.

## Fin et tests

Une fois que tout est configuré des deux côtés, retournez dans Dastra et cliquez sur **Tester**, à droite de la connexion dans la liste des logins SSO.


---

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