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

# SAML 2

Détails de la configuration de SAML 2

La configuration du SSO avec SAML 2 se fait en trois étapes :

* configuration du fournisseur d'authentification (**Identity Provider - IdP**) : Active Directory, Google Workspace, etc. ;
* configuration du fournisseur de service (**Service Provider - SP**) : Dastra ;
* test de l'authentification.

Dans le cas spécifique **des serveurs ADFS**, consultez notre documentation spécifique :

{% content-ref url="/pages/p4ZZlOqiPVImPkH57QKS" %}
[ADFS](https://doc.dastra.eu/features/settings/sso/adfs.md)
{% endcontent-ref %}

## 1. Configuration du fournisseur d'authentification

Vous devez mettre en place une configuration SAML dans votre fournisseur d'authentification.

* Pour AD FS : voir la page [ADFS](https://doc.dastra.eu/features/settings/sso/adfs.md).
* Pour Microsoft Entra ID (anciennement Azure AD) : voir la page [Active Directory (Microsoft Entra ID)](https://doc.dastra.eu/features/settings/sso/entra-id.md) et la [documentation de Microsoft](https://learn.microsoft.com/fr-fr/entra/identity/enterprise-apps/add-application-portal-setup-sso).
* Pour Google : <https://support.google.com/a/answer/6087519?hl=fr>

Pour faire le rapprochement entre les comptes locaux (ceux hébergés dans Dastra), vous avez besoin de fournir une propriété contenant l'e-mail de l'utilisateur (par défaut, Dastra va chercher la propriété nommée <http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress>). Vous pouvez changer ce nom dans le champ **Le nom du claim contenant l'adresse email**.

Voici les informations dont vous avez besoin pour renseigner le fournisseur de service :

* **Identity Provider's Entity id** (issuer) ;
* **Single sign on url** ;
* **le certificat au format RAW** (encodé en base64).

Pour configurer votre fournisseur d'authentification, vous avez besoin des informations suivantes, affichées en haut du formulaire SAML de Dastra :

* **Issuer** : par défaut `https://www.dastra.eu` ;
* **SP Redirect URI** (ACS) : `https://account.dastra.eu/{identifiant de la connexion}/Acs`. Cette URL est propre à chaque connexion : copiez-la en haut du formulaire SAML lors de l'ajout du login SSO dans Dastra (étape 2), puis enregistrez ce login ;
* **SP start url (Sign on URL)**, si votre fournisseur demande une URL de connexion pour l'application ;
* **SAML Logout url (facultatif)**, si votre fournisseur gère la déconnexion.

## 2. Configuration du fournisseur de service

Dans Dastra, ouvrez [la page d'administration du SSO](https://app.dastra.eu/general-settings/sso) (**Configuration de l'organisation** > **Single sign on**, réservée aux propriétaires de l'organisation) et cliquez sur **Ajouter un login SSO**. Choisissez le protocole **SAML2**.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-9f0b0d5a9f4dca0e4d25881de28162a2914a750c%2Fsettings-sso-liste-logins.png?alt=media" alt="La page Single sign on avec la liste des logins SSO et le bouton Ajouter un login SSO"><figcaption></figcaption></figure>

Choisissez ensuite comment fournir la configuration de votre fournisseur d'identité :

* **Téléversez votre manifeste de configuration SAML (.xml)** : importez le fichier de métadonnées (manifeste XML) fourni par votre fournisseur. Dastra remplit les champs du formulaire à partir de ce fichier. Cliquez sur le bouton de retour pour changer de méthode.
* **Configuration manuelle** : renseignez les champs vous-même.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-9f2f0f67d8bffcf8db8e4c5bc45f87659ecbdf81%2Fsettings-sso-saml-upload-manifest.png?alt=media" alt="Choix entre l&#x27;import du manifeste SAML et la configuration manuelle"><figcaption></figcaption></figure>

En configuration manuelle, renseignez les champs du formulaire à l'aide des informations de votre fournisseur d'authentification :

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-bd4d8b0fca8698aac2fc208e9ce2449562b86547%2Fsettings-sso-saml-config-form.png?alt=media" alt="Formulaire de configuration manuelle d&#x27;un login SSO SAML dans Dastra"><figcaption></figcaption></figure>

{% hint style="danger" %}
Vous pouvez forcer tous les utilisateurs de l'organisation à utiliser un SSO particulier (option **Forcer pour tous les utilisateurs**). Soyez prudent : si le SSO dysfonctionne, vous ne pourrez plus accéder à votre compte en tant qu'administrateur. Gardez un compte local de secours, ou exemptez des utilisateurs avec le champ **Utilisateurs spécifiques exemptés de SSO (par exemple, les administrateurs de sécurité)** (voir [Single Sign On (SSO)](https://doc.dastra.eu/features/settings/sso.md)). Il est préférable de gérer le SSO par utilisateur.
{% endhint %}

{% hint style="warning" %}
**Cas particulier des utilisateurs externes**\
Seuls les comptes internes à un abonnement sont soumis au SSO. Les comptes d'utilisateurs externes (qui ont un autre abonnement supplémentaire) ne sont pas soumis au SSO.
{% endhint %}

## 3. Tester le SSO

Une fois la configuration terminée, testez l'authentification en cliquant sur **Tester**, à droite de la connexion dans la liste. Si vous rencontrez un problème, ouvrez un ticket depuis la [page du support](https://app.dastra.eu/general-settings/support).

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-ed9c8607d915104e771f74f0816f41a710ef89cd%2Fsettings-sso-saml-provider-card.png?alt=media" alt="Une connexion SSO SAML dans la liste, avec son statut et le bouton Tester"><figcaption></figcaption></figure>


---

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