> For the complete documentation index, see [llms.txt](https://help.aphex.co/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aphex.co/docs/aphex-help-fr/authentification/configuration-du-sso-saml.md).
# Configuration du SSO SAML
Guide destiné aux administrateurs système pour configurer un SSO basé sur SAML et l’activer pour leurs équipes.
{% hint style="info" %}
**Qui peut utiliser cette fonctionnalité ?**\
\
Le SSO est disponible sur les offres Enterprise\
Vous devrez disposer d'un accès administrateur à la plateforme IdP de votre entreprise (Active Directory, Okta ou similaire)
{% endhint %}
Le Single Sign-On (SSO) permet aux utilisateurs de se connecter à de nombreuses applications ou sites web à l'aide d'un **fournisseur d'identité**. Le Security Assertion Markup Language (SAML) est une norme de sécurité pour la gestion de l'authentification et des accès.
Dans une configuration SAML SSO, le fournisseur d'identité gère les comptes utilisateurs et les identifiants de l'organisation. Le **fournisseur de services** (Aphex) est l'application ou le site web qui fournit des services à l'utilisateur ou à l'organisation.
Lorsque SAML SSO est utilisé, les membres sont forcés de se connecter à leur compte Aphex en utilisant le fournisseur d'identité de l'organisation.
Fonctionnement de SAML SSO :
1. Le membre tente de se connecter à Aphex avec une adresse e-mail sur un domaine SAML SSO enregistré
2. Aphex impose la connexion via SAML SSO
3. Aphex envoie une requête SAML au fournisseur d'identité
4. Le fournisseur d'identité vérifie les identifiants de ce membre
5. Le fournisseur d'identité envoie une réponse à Aphex pour vérifier l'identité du membre
6. Aphex accepte la réponse et connecte le membre à son compte Aphex
7. Si l'utilisateur est nouveau, il sera provisionné dans
**Remarque**: Aphex utilise **SAML 2.0** pour toutes les configurations SAML SSO. Cela inclut les configurations avec des fournisseurs d'identité pris en charge ainsi que toute configuration personnalisée.
{% hint style="info" %}
Comme la plupart des services logiciels, Aphex utilise « Email » comme identifiant unique d'un utilisateur.
{% endhint %}
## Configurer SAML SSO
Le processus de configuration de SAML dépendra de votre fournisseur d'identité spécifique. Nous avons décrit ci-dessous le processus général de mise en œuvre de SAML SSO.
SAML SSO s'applique uniquement aux utilisateurs provenant des domaines enregistrés de l'organisation. Les autres utilisateurs (provenant d'autres domaines) qui accèdent aux données de l'organisation dans Aphex peuvent continuer à se connecter via d'autres méthodes, telles que l'e-mail + mot de passe ou la connexion avec Microsoft.
### 1. Confirmer les domaines
Les domaines sont la façon dont nous identifions les entités sur Internet. Ils permettent à Aphex de savoir quelles méthodes d'authentification autoriser ou imposer aux utilisateurs.
Les organisations peuvent généralement avoir un seul domaine, toutefois, nous prenons en charge plusieurs domaines, y compris les sous-domaines.
Par exemple : ACME Corp a trois domaines enregistrés pour son organisation : `acme.org`, `acme-abc-jv.com`, et `acjv.com`.
Toute personne ayant une `acme.org`, `acme-abc-jv.com`, ou `acjv.com` adresse e-mail sera soumise aux règles SSO imposées.
{% hint style="info" %}
Si vous envisagez d'utiliser SAML SSO, vous devriez prendre en compte les sous-marques et les coentreprises que votre entreprise contrôle. Notez que les alias d'e-mail ne fonctionneront pas avec SAML SSO.
{% endhint %}
### 2. Demander l'activation du SSO sur vos domaines
Contactez votre Account Manager ou Customer Success Manager pour demander la configuration SAML SSO de vos domaines.
Une fois approuvé, vous recevrez l'accès à un SSO qui vous guidera dans la configuration.
### 3. Ajouter Aphex à votre fournisseur d'identité
Au sein du fournisseur d'identité de votre entreprise, créez ou enregistrez une nouvelle application d'entreprise pour Aphex. Lorsque vous configurez le SAML SSO pour l'application, vous devrez saisir les informations fournies à l'étape précédente.
Lorsque vous ajoutez Aphex à votre fournisseur d'identité, celui-ci vous fournira :
* Identifiant (par exemple : Identifiant Microsoft Entra ID)
* URL de connexion
* URL de déconnexion (facultative)
* Certificat (au format Base64, brut ou XML)
{% hint style="info" %}
Les clients Azure AD (Entra) peuvent choisir de simplement fournir leur **URL des métadonnées de fédération de l'application** à la place de ce qui précède.
{% endhint %}
Vous devrez les enregistrer et les renvoyer de manière sécurisée à votre Account Manager ou Customer Success Manager Aphex.
Certains services vous permettent de personnaliser le logo de votre application Enterprise. Si c'est le cas, vous pouvez utiliser ce logo ici.
### 4. Attribuer l'utilisateur ou le groupe sélectionné dans l'IdP
Maintenant que vous avez créé l'application d'entreprise, vous devez lui attribuer vos utilisateurs/groupes d'utilisateurs.
1. Sous la **Premiers pas** section, sélectionnez **Attribuer des utilisateurs et des groupes**.
2. Sélectionnez l’ **Ajouter un utilisateur/groupe** bouton.
3. Sous **Utilisateurs**, sélectionnez le **Aucun sélectionné** lien.
4. Dans le champ de recherche, saisissez l'utilisateur ou le groupe d'utilisateurs que vous souhaitez attribuer à l'application d'entreprise.
5. Cochez la case à côté de l'utilisateur ou du groupe que vous souhaitez attribuer.
6. Sélectionnez l’ **Sélectionner** bouton au bas de la page.
7. Sélectionnez l’ **Attribuer** bouton au bas de la page.
{% hint style="info" %}
**Important :** À moins que la synchronisation directe ne soit utilisée, la gestion des utilisateurs se fait généralement dans Aphex. Pour éviter les doublons d'efforts et le besoin d'ajouter ou de supprimer des utilisateurs à la fois dans Aphex et dans votre IdP, nous recommandons d'attribuer un groupe large ou de rendre l'application disponible à tout le monde.
Si Directory Sync est activée, l'IdP devient le gestionnaire principal des utilisateurs.
{% endhint %}
### 5. Configurer des revendications personnalisées
Aphex attendra trois propriétés spécifiques dans le cadre de la configuration SAML SSO. Vous pouvez les ajouter comme revendications personnalisées dans votre IdP ;
* firstName : Le prénom de l'utilisateur (par exemple, cela sera mappé sur `user.givenname` dans Microsoft Entra)
* lastName : Le nom de famille de l'utilisateur (par exemple, cela sera mappé sur `user.surname` dans Microsoft Entra)
* mail : L'adresse e-mail principale unique de l'utilisateur (par exemple, cela sera mappé sur `user.userprincipalname` dans Microsoft Entra)
### 6. Tester la connexion
Une fois configurée, la connexion peut être testée dans un environnement de développement avec votre Account Manager ou Customer Success Manager Aphex.
### 7. Demander le déploiement en production
Une fois testé, votre Account Manager ou Customer Success Manager Aphex peut déployer votre configuration SAML SSO.
La prochaine fois que des utilisateurs de vos domaines tenteront d'accéder à Aphex, ils devront se reconnecter et l'utilisation de SAML SSO sera imposée (ce qui signifie qu'ils ne pourront plus utiliser leurs méthodes d'authentification précédentes).
---
# 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://help.aphex.co/docs/aphex-help-fr/authentification/configuration-du-sso-saml.md?ask=&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.