Bienvenue sur le guide de configuration de votre Google Workspace avec Hector. Cette configuration a pour but de permettre à vos utilisateurs de s’identifier avec leur propre compte Google ainsi que d’effectuer une synchronisation journalière de ceux-ci.
1. Connexion à votre compte Google Admin
Vous devez avoir des droits d’administration pour être en mesure d’ajouter Hector comme une application autorisée.
2. Domaine
Une fois connecté, cliquez sur le lien «Manage Domains» de votre page principal. Copiez le domaine principal pour usage futur.
3. «Domain Wide Delegation»
La prochaine étape est de donner à Hector des accès pour qu’il puisse aller voir les données sur vos groupes, les membres de vos groupes ainsi que vos utilisateurs. Voici quelques lignes dont vous allez avoir besoin afin de configurer votre délégation de domaine à Hector:
Client ID (nous): 112195502243245937406
Scopes (accès):
- https://www.googleapis.com/auth/admin.directory.group.readonly
- https://www.googleapis.com/auth/admin.directory.group.member.readonly
- https://www.googleapis.com/auth/admin.directory.user.readonly
Cliquez sur les boutons «Security» et «API Controls» du menu et finalement sur le lien «Manage Domain Wide Delegation».
Cliquez sur le bouton «Add new». Remplissez le formulaire avec l’information donnée plus haut, puis cliquez «Authorize».
La partie de la configuration sur votre compte Google Workspace est terminée. La prochaine étape consiste d’ouvrir votre instance d’Hector en tant qu’administrateur.
4. Configurer Hector pour la connexion des utilisateurs
Connectez vous à votre instance d’Hector en tant qu’administrateur puis naviguez vers le menu «Réglages» et ensuite «Sécurité». Une fois sur la page, choisissez l’option «Google Workspace» dans le liste afin d’afficher les champs nécessaires à la configuration de Google.
Si vous sauvegardez vos configurations de cette façon, vos utilisateurs vont pouvoir se connecter à votre instance d’Hector avec leur compte Google. Si vous voulez importer votre Google Workspace (qui est probablement la raison de votre lecture) et avoir une synchronisation journalière, suivez les étapes suivantes!
5. Configurer Hector pour la synchronisation des utilisateurs
Premièrement, vous devez cocher la boite «Importer les utilisateurs» pour voir de nouvelles options apparaitre.
- Le domaine est ce que nous avons récupéré lors de la deuxième étape du guide.
- Le courriel administrateur est un courriel ayant des privilèges administrateur dans votre Google Workspace.
- Dans «Groupe d’administrateurs», «Groupe du personnel» et «Groupe d’utilisateurs» vous allez entrer la partie à gauche du «@» dans l’adresse électronique de vos groupes. Vous trouverez ces adresses dans votre Google Workspace en cliquant sur «Directory» et «Groups». Vous pouvez choisir plusieurs groupes par rôle en séparant leurs noms par une virgule.
Une fois que vous avez décidé sur vos groupes, complétez le formulaire. Il devrait ressembler quelque peu à celui-ci un fois rempli:
Vous avez terminé! N’oubliez pas de sauvegarder vos configurations et de les valider pour un retour instantané de leur validité.