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

# Utiliser Google pour l’authentification

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

## Configurer une source d'autorisation Google

1. Obtenir **ID client** et **Secret client** dans le système Google. Ces valeurs doivent être générées en fonction de l'URL publique du système VergeOS. Consultez la documentation Google pour obtenir des instructions, par exemple [**https://developers.google.com/identity/protocols/oauth2**](https://developers.google.com/identity/protocols/oauth2)

{% hint style="success" %}
L'ID client et le secret peuvent généralement être générés à l'adresse : [***https://console.developers.google.com***](https://console.developers.google.com/)
{% endhint %}

2. Cliquez sur **Système** dans le menu du haut.
3. Sélectionnez **Sources d'authentification**.
4. Cliquez sur **Nouveau** dans le menu de gauche.
5. Saisissez un ***Nom*** pour la source (par exemple « Google »). Ce nom apparaîtra sur le bouton de connexion de la page de connexion VergeOS.
6. Dans la ***Pilote*** dans le champ (liste déroulante), sélectionnez **Google**.
7. ***URI de redirection*** doit être renseigné avec l'URL du système VergeOS. Il doit s'agir d'une adresse publique accessible par l'API Google.
8. Saisissez le ***ID client*** et ***Secret client*** valeurs obtenues auprès de Google.
9. ***Champs utilisateur distants*** est la liste des champs utilisés pour trouver initialement l'utilisateur Google ; ce champ est renseigné automatiquement avec (sub,preferred\_username,email nickname), une liste par défaut qui peut généralement fonctionner pour les implémentations Google. **Remarque : pour des raisons de sécurité, il n'est pas recommandé de localiser des utilisateurs distants à partir de champs modifiables par l'utilisateur final sur le système distant.**
10. **Options (Il est recommandé d'activer ces options.)**
    * ***Mettre à jour l'utilisateur distant :*** - une fois l'utilisateur localisé dans le système Google, mettre à jour l'utilisateur VergeOS *Nom d'utilisateur distant* champ avec l'identifiant unique Google correspondant (chaîne sub)
    * **Mettre à jour l'adresse e-mail de l'utilisateur :** - mettre à jour l'adresse e-mail de l'utilisateur VergeOS pour qu'elle corresponde à l'adresse e-mail dans Google.
    * **Mettre à jour le nom d'affichage de l'utilisateur :** - mettre à jour le nom d'affichage de l'utilisateur VergeOS pour qu'il corresponde au nom d'affichage dans Google.

{% hint style="success" %}
**L'activation de&#x20;*****Mettre à jour l'utilisateur distant*****&#x20;champ permettra au système VergeOS d'enregistrer l'identifiant Google unique dans l'enregistrement utilisateur VergeOS (après avoir initialement localisé l'utilisateur Google à l'aide des champs définis dans les Champs utilisateur distants), afin que l'identifiant unique puisse ensuite être utilisé pour retrouver l'utilisateur Google ; c'est généralement recommandé, car des champs tels que l'adresse e-mail sont susceptibles de changer.**
{% endhint %}

11. **Champs optionnels supplémentaires** Voir [**Sources d'autorisation - Vue d'ensemble**](https://github.com/verge-io/docs-vergeos/tree/main/run/product-guide/auth/auth-sources-overview.md) pour des informations sur les champs optionnels supplémentaires.
12. Après avoir terminé la configuration, cliquez sur **Soumettre** pour enregistrer la nouvelle source d'autorisation.

## Ajouter des utilisateurs VergeOS qui utiliseront l'authentification Google

Une fois la source d'autorisation créée, des utilisateurs peuvent être créés afin d'utiliser la source Google pour la connexion. **Créez de nouveaux utilisateurs VergeOS avec la configuration suivante :**

* ***Source d'autorisation :*** Sélectionnez la source Google dans la liste déroulante
* ***Nom d'utilisateur :*** nom unique dans le système VergeOS ; il est généralement recommandé d'utiliser le même nom de connexion que celui utilisé dans Google.
* ***Nom d'utilisateur distant :*** utilisez la valeur de l'un des champs définis comme champs utilisateur distants, c'est-à-dire les champs recherchés dans Google ; l'adresse e-mail de l'utilisateur ou la chaîne sub, qui est l'équivalent de l'identifiant Google de l'utilisateur, sont généralement les meilleurs choix.
* ***Nom d'affichage :*** (facultatif) Si *Mettre à jour le nom d'affichage de l'utilisateur* est activé sur la source d'authentification Google, le nom d'affichage se synchronisera à partir de l'utilisateur Google.
* ***Adresse e-mail :*** (facultatif) Si *Mettre à jour l'adresse e-mail de l'utilisateur* est activé sur la source d'authentification Google, l'adresse e-mail se synchronisera à partir de l'utilisateur Google.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/run-the-platform/fr/authentification/google-auth.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
