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

L'ID client et le secret peuvent généralement être générés à l'adresse : https://console.developers.google.com

1. Cliquez sur Système dans le menu du haut.
2. Sélectionnez Sources d'authentification.
3. Cliquez sur Nouveau dans le menu de gauche.
4. Saisissez un Nom pour la source (par exemple « Google »). Ce nom apparaîtra sur le bouton de connexion de la page de connexion VergeOS.
5. Dans la Pilote dans le champ (liste déroulante), sélectionnez Google.
6. 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.
7. Saisissez le ID client et Secret client valeurs obtenues auprès de Google.
8. 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.
9. 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.

L'activation de Mettre à jour l'utilisateur distant 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.

1. Champs optionnels supplémentaires Voir Sources d'autorisation - Vue d'ensemble pour des informations sur les champs optionnels supplémentaires.
2. 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.