> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/run-the-platform/fr/authentification/azure-auth.md).

# Utilisation d’Entra ID (Azure AD) pour l’authentification

Guide pas à pas pour configurer Microsoft Entra ID (Azure AD) comme source d’autorisation OAuth2 dans VergeOS, y compris l’enregistrement de l’application, l’intégration des groupes et le provisionnement des utilisateurs.

VergeOS peut être configuré pour permettre aux utilisateurs de s'authentifier à l'aide de leurs identifiants Azure d'entreprise. Cette page vous guidera tout au long du processus de configuration.

## Configurer une source d'autorisation Entra ID

1. Dans les services Azure : enregistrez une application web mono-locataire, en définissant le ***URI de redirection*** sur l'URL du système VergeOS et en créant un nouveau secret client. **Azure Active Directory > Inscriptions d'applications > Nouvelle inscription** ![azurereg1.png](https://2455533257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpODKGSQETqL1gSqyxIq3%2Fuploads%2Fgit-blob-bb5217dce60d2b5fbc13525b6c4d55fde916fd24%2Fazurereg1.png?alt=media)

   ![azurereg2.png](https://2455533257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpODKGSQETqL1gSqyxIq3%2Fuploads%2Fgit-blob-b0d802ab9f75bd8da9c880b685efdbf1c08482cb%2Fazurereg2.png?alt=media)
2. Créer un nouveau secret client. **Inscriptions d'applications > Informations d'identification du client > Ajouter un certificat ou un secret. Cliquez sur +Nouveau secret client.**

   * Saisissez une **description et une date d'expiration** pour le nouveau secret client.
   * **Obtenez les éléments suivants depuis Azure** à utiliser dans la configuration de la source d'autorisation dans VergeOS :
     * **ID de locataire** - **astuce :&#x20;*****Tous les services > Azure Active Directory > Aperçu.*****&#x20;L'ID de locataire est indiqué sous Informations de base.**
     * **ID client** - **astuce :&#x20;*****Inscriptions d'applications Azure > Élément configuré > Informations d'identification du client***
     * **Secret client** - **astuce :&#x20;*****Inscriptions d'applications Azure > Élément configuré > Informations d'identification du client*****&#x20;Utilisez le champ « VALUE ».**

   ![azureclientsecretadd.png](https://2455533257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpODKGSQETqL1gSqyxIq3%2Fuploads%2Fgit-blob-c610e7f4a2b6df1024f288adee4abc9a8b7e2645%2Fazureclientsecretadd.png?alt=media) ![azureclientsecret2.png](https://2455533257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpODKGSQETqL1gSqyxIq3%2Fuploads%2Fgit-blob-0984cccf8b287e22110087cb9a1a6dd3480b234b%2Fazureclientsecret2.png?alt=media)
3. Cliquez sur **Système** dans le menu supérieur.
4. Sélectionnez **Sources d'authentification**.
5. Cliquez sur **Nouveau** dans le menu de gauche.
6. Saisissez une ***Nom*** pour la source (par exemple « Azure »). Ce nom apparaîtra sur le bouton de connexion de la page de connexion VergeOS. ![azureauthform.png](https://2455533257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpODKGSQETqL1gSqyxIq3%2Fuploads%2Fgit-blob-e9db0034056da44a679926f7e04c71f9a7a4ecfa%2Fazureauthform.png?alt=media)
7. Dans le ***Pilote*** champ (liste déroulante), sélectionnez **Azure AD**.
8. Saisissez le ***ID de locataire*** obtenu à l'étape précédente.
9. Le ***URI de redirection*** doit être l'URL de votre système VergeOS (par ex. : https\:/\[]/verge.io.mycompanyabc.com)
10. Saisissez ***URL du point de terminaison pour que l'utilisateur déconnecte le jeton de session*** (https\:/\[]/login.microsoftonline.com/***TENANTID***/oauth2/v2.0/logout)
11. ***Portée*** doit généralement être laissée à la valeur par défaut : « OpenID profile email ».
12. ***Portée du groupe*** doit être défini si les utilisateurs doivent être créés automatiquement en fonction de l'appartenance à un groupe ; en général, cela est défini sur le mot « groups » sans ponctuation.
13. Saisissez le ***ID client*** obtenu à l'étape précédente.
14. Saisissez le ***Secret client*** obtenu à l'étape précédente.
15. ***Champs utilisateur distant*** définit la liste des champs utilisés pour rechercher initialement l'utilisateur Azure ; ce champ est renseigné automatiquement avec (sub,preferred\_username,email nickname), une liste par défaut qui peut généralement fonctionner pour la plupart des implémentations. **Remarque : pour des raisons de sécurité, il n'est pas recommandé de localiser les utilisateurs distants en fonction de champs modifiables par l'utilisateur final sur le système distant.**
16. Pour transférer l'appartenance aux groupes d'Azure vers VergeOS, cochez la ***Mettre à jour l'appartenance au groupe*** case à cocher. Les groupes doivent être créés dans VergeOS à l'aide des instructions ci-dessous.
17. **Fonctionnalités de création automatique des utilisateurs (facultatif)**: les utilisateurs peuvent être créés automatiquement lors de la première connexion à VergeOS ; cela peut être sélectionné pour tous les utilisateurs Entra ID -OU- limité aux utilisateurs des groupes Entra ID spécifiés.
    * ***Créer automatiquement les utilisateurs*** - Si tous les utilisateurs doivent être créés automatiquement, saisissez `.*` ici.
    * ***Créer automatiquement les utilisateurs dans le groupe*** - Pour créer automatiquement uniquement les utilisateurs membres des groupes Entra ID spécifiés, saisissez les ID d'objet des groupes sous forme d'expression régulière (regex).

{% hint style="info" %}
**Création automatique d'utilisateurs dans des groupes**

* Le **Portée du groupe** doit être défini. (Champ Portée du groupe défini ci-dessus)
* **Configuration du jeton** doit être configuré dans Entra ID (instructions ci-dessous).
* Entra ID **groupes** spécifiés pour la création automatique **doivent être créés du côté de VergeOS** (instructions ci-dessous).
* Pour créer automatiquement selon le groupe, le ***Créer automatiquement les utilisateurs*** **champ doit être vide**
* Plusieurs ID de groupe spécifiques peuvent être saisis en utilisant le format : (ID)|(ID)|(ID)
  {% endhint %}

18. **Options (activation recommandée) :**

* ***Mettre à jour l'utilisateur distant :*** - une fois l'utilisateur localisé dans Entra ID, mettez à jour l'utilisateur VergeOS *Nom d'utilisateur distant* champ vers l'ID unique Azure correspondant.

{% hint style="success" %}
**L'activation de la mise à jour de l'utilisateur distant permettra au système VergeOS de stocker l'ID Azure unique dans l'enregistrement utilisateur VergeOS (après avoir d'abord localisé l'utilisateur Entra ID à l'aide des champs définis dans Champs utilisateur distant), afin que l'identifiant unique puisse ensuite être utilisé pour rechercher l'utilisateur Entra ID ; cela est généralement recommandé, car des champs tels que l'adresse e-mail sont susceptibles de changer.**
{% endhint %}

* ***Mettre à jour l'adresse e-mail de l'utilisateur :*** - Mettez à jour l'adresse e-mail de l'utilisateur VergeOS pour qu'elle corresponde à l'adresse e-mail dans Entra ID.
* ***Mettre à jour le nom d'affichage de l'utilisateur :*** - Mettez à jour le nom d'affichage de l'utilisateur VergeOS pour qu'il corresponde au nom d'affichage dans Entra ID.
* ***Mettre à jour l'appartenance au groupe :*** - Met à jour les groupes dont un utilisateur VergeOS est membre. (Une portée de groupe est requise pour que cela fonctionne.)

19. **Champs optionnels supplémentaires :** Voir [**Sources d'autorisation (général)**](https://docs.verge.io/run-the-platform/fr/authentification/auth-sources-general.md) pour des informations concernant des champs optionnels supplémentaires.

## Ajouter des groupes Azure à VergeOS

L'interfaçage avec les groupes Azure nécessite un jeton sur l'inscription d'application Entra ID et la création de groupes dans VergeOS :

### Configurer une configuration de jeton dans Entra ID

1. Accédez à la **page d'inscription de l'application** pour l'application créée ci-dessus.
2. Cliquez sur **Configuration du jeton** dans le menu de gauche et cliquez sur **+Ajouter une revendication de groupes**.
3. Cochez les **types de groupes**.
4. Définissez le **ID, Access et SAML sur sAMAccountName**.

![azure-editgroupsclaim.pn](https://2455533257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpODKGSQETqL1gSqyxIq3%2Fuploads%2Fgit-blob-24b1f0220d3e8fb693bfde10d1a6b8bc186f1012%2Fazure-editgroupsclaim.png?alt=media)

### Étapes pour ajouter des groupes Azure

1. Accédez à **Système > Groupes.**
2. Cliquez sur **Nouveau** dans le menu de gauche.
3. Saisissez le groupe ***Nom*** pour correspondre au nom du groupe dans Entra ID.
4. Optionnellement, un ***E-mail*** peut être saisi pour le groupe. Cette adresse e-mail est utilisée pour envoyer les alertes d'abonnement et/ou les rapports attribués au groupe.
5. Copiez le **ID d'objet** correspondant ***à partir de la page Groupes/Tous les groupes dans Entra ID vers le*** Identifiant
6. Cliquez sur **Soumettre** (en bas de la page) pour enregistrer le nouveau groupe.

![azure-groupspage.png](https://2455533257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpODKGSQETqL1gSqyxIq3%2Fuploads%2Fgit-blob-82bed5065e0cf17ab7b46e6fd3b73037e16cfc40%2Fazure-groupspage.png?alt=media)

![azure-creategroup.png](https://2455533257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpODKGSQETqL1gSqyxIq3%2Fuploads%2Fgit-blob-df56aab13c11b1297fa9c58d855f1404cd45c165%2Fazure-creategroup.png?alt=media)

## Ajouter manuellement des utilisateurs depuis Azure

Après la création de la source d'authentification Azure, des utilisateurs peuvent être créés manuellement dans VergeOS afin d'utiliser la source d'autorisation pour l'authentification de connexion. La création manuelle des utilisateurs n'est nécessaire que lorsque les utilisateurs ne sont pas configurés pour être créés automatiquement.

### Ajouter des utilisateurs VergeOS qui utiliseront l'authentification Entra ID

Lors de la création du nouvel utilisateur, utilisez la configuration suivante :

* ***Source d'autorisation :*** Sélectionnez la source Entra ID dans la liste déroulante
* ***Nom d'utilisateur :*** nom unique dans le système VergeOS ; en général, il est recommandé d'utiliser le nom principal Azure.
* ***Nom d'utilisateur distant :*** utilisez la valeur de l'un des champs définis comme *champs utilisateur distants* ce sont des champs recherchés dans Azure (e.g. nom d'utilisateur, e-mail)
* ***Nom d'affichage :*** (facultatif) Si *Mettre à jour le nom d'affichage de l'utilisateur* est activé sur la source d'authentification Entra ID, le nom d'affichage sera automatiquement synchronisé depuis Entra ID.
* ***Adresse e-mail :*** (facultatif) Si *Mettre à jour l'adresse e-mail de l'utilisateur* est activé sur la source d'authentification Entra ID, l'adresse e-mail sera automatiquement synchronisée depuis Entra ID.

![azure-newuser.png](https://2455533257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpODKGSQETqL1gSqyxIq3%2Fuploads%2Fgit-blob-542e4c78a054f2f87e170465de77547161eb9ae2%2Fazure-newuser.png?alt=media)


---

# 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.verge.io/run-the-platform/fr/authentification/azure-auth.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.
