> 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).

# Utilisation de Google pour l’authentification

Guide pas à pas pour configurer Google comme source d’autorisation OAuth2 dans VergeOS, y compris l’obtention des identifiants et la création d’utilisateurs.

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

## Configurer une source d'autorisation Google

1. Obtenir **ID client** et **Secret client** à partir du 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 des instructions, comme [**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 à : [***https://console.developers.google.com***](https://console.developers.google.com/)
{% endhint %}

2. Cliquez sur **Système** dans le menu supérieur.
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 le ***Pilote*** 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 les ***ID client*** et ***Secret client*** valeurs obtenues auprès de Google.
9. ***Champs utilisateur distant*** est la liste des champs utilisés pour localiser initialement l’utilisateur Google ; ce champ est prérempli 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 les 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’ID 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 du&#x20;*****champ Mettre à jour l’utilisateur distant*****&#x20;permettra au système VergeOS de stocker l’ID Google unique dans l’enregistrement utilisateur VergeOS (après avoir initialement localisé l’utilisateur Google à l’aide des champs définis dans Champs utilisateur distant), afin que l’identifiant unique puisse ensuite être utilisé pour retrouver l’utilisateur Google ; cela est généralement recommandé, car des champs tels que l’adresse e-mail sont susceptibles de changer.**
{% endhint %}

11. **Champs facultatifs supplémentaires** Voir [**Sources d’authentification - Vue d’ensemble**](https://docs.verge.io/run-the-platform/fr/authentification/auth-sources-general.md) pour obtenir des informations sur les champs facultatifs supplémentaires.
12. Une fois la configuration terminée, 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 pour 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 distant, c’est-à-dire les champs recherchés dans Google ; l’adresse e-mail de l’utilisateur ou la chaîne sub, qui équivaut à l’ID 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 sera synchronisé depuis 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 sera synchronisée depuis 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 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/google-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.
