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!
Synchronisation
Pour activer l’intégration One Login, connectez vous à votre compte administrateur Hector. Seuls les administrateurs peuvent configurer les intégrations
Dans Hector, allez dans les Réglages, dans la section Intégrations vous pourrez trouver Google Workspace dans l’onglet Ressources. Cliquez sur Ajouter pour commencer la configuration.
Dans les régalages de l’intégration Google Workspace, vous devez compléter les champs Domaine et Courriel Administrateur. Si vous avez déjà complété ces champs dans Réglages > Sécurité > Google Workspace, ils devraient apparaître avec les bonnes informations. Vous pouvez garder les mêmes réglages ou en changer si vous souhaiter utiliser une autre instance Google Workspace pour la synchronisation des utilisateurs.
- 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é. Les utilisateurs non synchronisés pendant plus de deux jours sont automatiquement désactivés dans Hector.
6. Fonctionnement de l’intégration
🔄 À quoi s’attendre lors de la synchronisation
Une fois la synchronisation activée, Hector commencera à se synchroniser avec Google Workspace en fonction de vos paramètres d’intégration et de la fréquence de synchronisation définie.
⚠️ Remarque : Il s’agit d’une synchronisation unidirectionnelle de Google Workspace vers Hector. Hector n’envoie aucune mise à jour vers Google.
🕒 Fréquence de synchronisation
Hector se synchronise avec Google Workspace toutes les nuits. Tout membre ajouté, mis à jour ou désactivé dans Google Workspace sera automatiquement reflété dans Hector selon les règles définies dans votre intégration.
🔁 Première synchronisation
- Tous les membres de Google Workspace appartenant à l’un des groupes récupérés selon les filtres définis dans l’importation des groupes — tels que configurés dans les réglages de l’intégration — sont synchronisés.
- Les utilisateurs Hector existants avec une adresse courriel correspondante sont mis à jour.
- Seulement les membres de Google Workspace non présents dans Hector sont créés comme nouveaux utilisateurs.
🧱 Mapping des champs lors de la création de l’utilisateur
Lorsqu’un membre Google Workspace est créé dans Hector, les champs suivants sont renseignés :
| Champ Google | Champ Hector | Notes |
|---|---|---|
| Prénom | Prénom | |
| Nom | Nom | |
| Courriel | Courriel | Utilisé pour correspondre aux utilisateurs existants |
| Courriel | Code unique | |
| Rôle | Titre | |
| Langue | Langue par défaut défini dans Réglages → Global → Général → Général → Langue | |
| Ville | Ville par défaut défini dans Réglages → Global → Général → Adresse → Ville par défaut | |
| Activé | Par défaut, défini à « Actif » | |
| Groupes | Rôle | Rôle associé au groupe configuré dans les réglages de l’intégration. Si un utilisateur appartient à plusieurs groupes liés à différents rôles, le rôle placé le plus haut dans les réglages de l’intégration sera prioritaire |
| Groupes | Groupes | Tous les groupes associés à l’utilisateur dans Google Workspace qui correspondent au filtre défini dans l’importation des groupes, tel que configuré dans les réglages de l’intégration sont associés à l’utilisateur dans Hector |
| Département | Département par défaut défini dans Réglages → Ressources → Utilisateur → Options → Département par défaut |
🔄 Mapping des champs lors de la mise à jour de l’utilisateur
Lorsqu’un membre Google Workspace est mis à jour, les modifications sont reflétées dans Hector en mappant les champs suivants :
| Champ Google | Champ Hector | Notes |
|---|---|---|
| Prénom | Prénom | Mis à jour si modifié |
| Nom | Nom | Mis à jour si modifié |
| Rôle | Titre | Mis à jour si modifié |
| Groupes | Rôle | Rôle associé au groupe configuré dans les réglages de l’intégration. Si un utilisateur appartient à plusieurs groupes liés à différents rôles, le rôle placé le plus haut dans les réglages de l’intégration sera prioritaire |
| Groupes | Groupes | Tous les groupes associés à l’utilisateur dans Google Workspace qui correspondent au filtre défini dans l’importation des groupes, tel que configuré dans les réglages de l’intégration sont associés à l’utilisateur dans Hector |
⛔ Gestion des membres inactifs ou supprimés
- Si un membre Google Workspace précédemment synchronisé avec Hector ne peut plus être récupéré (par exemple s’il a été supprimé ou désactivé), il sera automatiquement désactivé dans Hector après plus de 2 jours sans récupération.
💡 Astuce : Utilisez les paramètres de rétention des utilisateurs d’Hector pour supprimer automatiquement les utilisateurs inactifs après un certain délai.