1. Introduction

Cyber Guru offre la possibilité de synchroniser automatiquement les utilisateurs de votre organisation directement depuis Google Workspace. Cette intégration te permet de maintenir à jour la liste des utilisateurs sur la plateforme Cyber Guru sans interventions manuelles, en reflétant en temps réel les modifications effectuées sur votre domaine Google.

Ce guide décrit, étape par étape, les opérations à effectuer sur votre compte Google Workspace et les données à communiquer à l'équipe Cyber Guru pour compléter la configuration.

Les services offerts par la synchronisation sont Create, Update, Suspend (Delete).

Les champs synchronisés automatiquement sont :

1.1 Aperçu du processus

L'intégration est basée sur un Service Account Google autorisé à lire en lecture seule les utilisateurs de votre domaine. Voici les phases principales :

2. Prérequis

Avant de procéder, vérifie que tu satisfais les exigences suivantes :

• Accès en tant que Super Admin (ou Admin délégué avec permissions sur les comptes de service) à la Google Admin Console (admin.google.com)
• Accès à la Google Cloud Console (console.cloud.google.com) avec le rôle Propriétaire ou Éditeur sur le projet Google Cloud de l'organisation
• Un projet Google Cloud existant associé au domaine Google Workspace (ou la possibilité d'en créer un)
• Identifiants d'accès à la plateforme Cyber Guru avec le rôle administrateur

3. Configuration sur Google Cloud Console

3.1 Accès à la Google Cloud Console

1. Ouvre le navigateur et accède à https://console.cloud.google.com
2. Connecte-toi avec le compte administrateur de l'organisation
3. À partir du menu en haut à gauche, vérifie que tu es dans le projet Google Cloud correct (ex. le projet associé au domaine d'entreprise)

3.2 Création du Service Account

Le Service Account est une identité applicative que Cyber Guru utilise pour s'authentifier auprès des API de Google Workspace. Procède comme suit :

1. À partir du menu latéral, sélectionne IAM et administration > Comptes de service
2. Clique sur + CRÉER UN COMPTE DE SERVICE
3. Remplis le formulaire avec les valeurs suivantes :
   • Nom du compte de service : cyberguru-sync (ou un nom de ton choix)
   • ID du compte de service : sera généré automatiquement en fonction du nom
   • Description : Compte de service pour la synchronisation des utilisateurs avec Cyber Guru
4. Clique sur CRÉER ET CONTINUER
5. Dans la section Accorder à ce compte de service l'accès au projet, assigne le rôle Lecteur (Viewer) et clique sur CONTINUER
6. Dans la section Accorder aux utilisateurs l'accès à ce compte de service, laisse vide et clique sur TERMINER

3.3 Activation de la Domain-Wide Delegation

Pour permettre au Service Account de lire les utilisateurs de tout le domaine Google Workspace, il est nécessaire d'activer la Domain-Wide Delegation (délégation au niveau du domaine).

1. Dans la liste des Comptes de service, clique sur le Service Account que tu viens de créer
2. Sélectionne l'onglet Détails avancés
3. Dans la section Délégation au niveau du domaine, clique sur Modifier et copie l'ID Client

3.4 Génération de la clé JSON (google_private_key)

La clé JSON contient les identifiants cryptographiques que Cyber Guru utilise pour s'authentifier. C'est l'élément le plus sensible de toute la configuration.

1. Ouvre le Service Account que tu as créé
2. Sélectionne l'onglet CLÉS
3. Clique sur AJOUTER UNE CLÉ > Créer une nouvelle clé
4. Sélectionne le format JSON
5. Clique sur CRÉER : le fichier JSON sera téléchargé automatiquement sur ton ordinateur

4. Configuration sur Google Admin Console

4.1 Autorisation du Service Account (OAuth Scopes)

Dans la Google Admin Console, il est nécessaire d'autoriser le Service Account à accéder aux API de Google Workspace via les OAuth Scope appropriés.

1. Accède à https://admin.google.com et connecte-toi en tant que Super Admin
2. À partir du menu, sélectionne Sécurité > Accès et contrôle des données > Contrôles API
3. Clique sur Gérer la délégation au niveau du domaine
4. Clique sur Ajouter nouveau
5. Dans le champ ID Client, insère l'ID Client numérique du Service Account que tu as noté précédemment
6. Dans le champ OAuth Scope, insère les scopes suivants séparés par une virgule :

1. Clique sur AUTORISER

4.2 Récupération du Customer ID (google_customer_id)

Le Customer ID identifie de manière unique ton compte Google Workspace.

1. À partir de la Google Admin Console, accède à Compte > Paramètres du compte
2. Dans la section Informations sur le profil, trouve le champ ID client
3. La valeur a le format Cxxxxxxxx (ex. C03abc1de)
4. Annote cette valeur : elle correspond au paramètre google_customer_id

4.3 Récupération du Domaine (google_domain)

Le domaine primaire de ton Google Workspace est visible dans la Google Admin Console :

1. À partir de la Google Admin Console, accède à Compte > Domaines > Gérer les domaines
2. Le domaine primaire (marqué comme Principal) est la valeur à communiquer
3. Ex. : azienda.com. Elle correspond au paramètre google_domain

4.4 Identification de l'Admin Email (google_admin_email)

Le Service Account doit usurper l'identité d'un compte administrateur pour lire les utilisateurs du domaine. Identifie un compte avec les exigences suivantes :

• Doit être un utilisateur réel du domaine Google Workspace (pas un alias)
• Doit avoir le rôle de Super Admin ou Admin avec permissions de lecture seule sur l'annuaire
• Doit être un compte stable, non sujet à désactivation ou changement d'email

Cette valeur correspond au paramètre google_admin_email à communiquer à Cyber Guru.

5. Paramètres Avancés

Les trois paramètres suivants sont optionnels et concernent des fonctionnalités avancées de personnalisation. Configure-les uniquement si nécessaire, en accord avec l'équipe Cyber Guru.

5.1 google_custom_schemas

Google Workspace permet aux administrateurs d'ajouter des attributs personnalisés aux utilisateurs via Custom Schemas. Ces attributs ne font pas partie du profil utilisateur standard et sont définis par l'administrateur pour les besoins spécifiques de l'organisation (ex. département, siège, niveau de risque, etc.).

Le paramètre google_custom_schemas indique à Cyber Guru quels schémas personnalisés lire pour chaque utilisateur. Si ton organisation utilise des custom schemas et souhaite que Cyber Guru les acquière, procède comme suit :

1. À partir de la Google Admin Console, accède à Annuaire > Paramètres personnalisés
2. Vérifie quels schémas personnalisés sont définis (ex. HR_Data, Security_Attributes)
3. Pour chaque schéma d'intérêt, annote le nom du schéma et les noms des champs à inclure

La valeur à communiquer est une liste de noms de schéma, par exemple :

5.2 google_org_mapping

Le paramètre google_org_mapping définit comment renommer les champs des Custom Schema de Google Workspace lorsqu'ils sont synchronisés en tant qu'org dans Cyber Guru.

Ce mappage te permet de standardiser les noms des attributs personnalisés provenant de Google, les rendant cohérents avec la nomenclature utilisée dans Cyber Guru (ex. département, siège, manager).

Format

Exemple

Chaque ligne contient la paire NomChampsSchema; nom_destination :

Les champs non inclus dans le mappage sont néanmoins synchronisés, en conservant la structure originale.

5.3 google_groups

Le paramètre google_groups te permet de limiter la synchronisation aux seuls utilisateurs appartenant à un ou plusieurs groupes Google Workspace spécifiques. S'il n'est pas configuré, tous les utilisateurs du domaine sont synchronisés.

Si ton organisation souhaite synchroniser uniquement un sous-ensemble d'utilisateurs basé sur l'appartenance à des groupes, procède comme suit :

1. À partir de la Google Admin Console, accède à Annuaire > Groupes
2. Identifie les groupes d'intérêt et annote l'ID de chaque groupe

Comment cela fonctionne : seuls les utilisateurs qui sont membres directs d'au moins l'un des groupes indiqués seront synchronisés. Si un groupe configuré n'est pas trouvé dans Google Workspace, la synchronisation pour la company est interrompue (comportement fail-safe).

ℹ️ Quand configurer ce paramètre Ce paramètre est optionnel. Si tu souhaites synchroniser tous les utilisateurs du domaine, laisse vide. Il est combinable avec google_domain : dans ce cas, seuls les utilisateurs des groupes indiqués qui appartiennent au domaine spécifié seront synchronisés.

6. Résumé des Paramètres à Communiquer

Une fois que tu as complété les opérations décrites dans les sections précédentes, collecte toutes les valeurs dans le tableau suivant et transmets-les à l'équipe Cyber Guru via ticket ou email chiffré (voir Section 7).

7. Comment Envoyer les Données à Cyber Guru

Une fois que tu as collecté tous les paramètres, communique-les à l'équipe Cyber Guru en suivant les instructions ci-dessous.

7.1 Canaux acceptés

• Ticket de support sur la plateforme Cyber Guru (méthode préférée) : joindre les données dans un fichier texte chiffré
• Email à ton référent Cyber Guru : utilise uniquement des adresses email d'entreprise vérifiées

7.2 Format recommandé pour le ticket / email

Inclus dans le corps du message ou en pièce jointe les informations suivantes :

7.3 À quoi s'attendre après l'envoi

1. L'équipe Cyber Guru recevra les données et les chargera dans la configuration de ton instance dans 1-2 jours ouvrables
2. Un test de connectivité et une première importation des utilisateurs seront effectués
3. Tu recevras une confirmation via ticket avec le nombre d'utilisateurs synchronisés et le résultat de l'opération
4. En cas d'erreurs, l'équipe Cyber Guru te contactera pour demander les informations manquantes ou correctes

8. Questions Fréquemment Posées (FAQ)

Q : Le Service Account a-t-il accès à des données sensibles des utilisateurs ?

R : Non. Le Service Account est configuré avec des scopes de lecture seule (readonly) limités à l'annuaire des utilisateurs. Il n'a pas accès aux emails, documents, calendrier ou autres données personnelles des utilisateurs.

Q : Que se passe-t-il si un utilisateur est désactivé dans Google Workspace ?

R : À chaque synchronisation, Cyber Guru met à jour l'état des utilisateurs. Les utilisateurs désactivés ou supprimés de Google Workspace sont automatiquement désactivés également sur la plateforme Cyber Guru.

Q : À quelle fréquence la synchronisation a-t-elle lieu ?

R : La fréquence de synchronisation est configurable par l'équipe Cyber Guru en fonction de tes besoins. Par défaut, elle est exécutée toutes les 24 heures. Pour des besoins spécifiques, contacte le support.

Q : Que se passe-t-il si je change le mot de passe de l'email admin indiqué dans google_admin_email ?

R : Le mot de passe de l'email admin n'affecte pas l'intégration : le Service Account utilise la clé privée JSON pour s'authentifier, pas le mot de passe de l'utilisateur. Cependant, si le compte est désactivé ou si le rôle d'admin est supprimé, la synchronisation cessera de fonctionner. Dans ce cas, communique le nouveau compte admin à Cyber Guru.

Q : Dois-je renouveler la clé JSON périodiquement ?

R : Les clés JSON de Google n'expirent pas automatiquement, mais il est recommandé de les faire tourner tous les 12 mois pour des raisons de sécurité. Dans ce cas, génère une nouvelle clé (section 3.4), supprime l'ancienne du projet Google Cloud, et communique la nouvelle clé à l'équipe Cyber Guru.

Q : Puis-je utiliser un Service Account déjà existant dans mon organisation ?

R : Oui, il est possible d'utiliser un Service Account existant à condition qu'il n'ait pas de permissions excessives. Vérifie qu'il a la Domain-Wide Delegation activée et les OAuth Scope corrects comme indiqué dans la section 4.1.

Q : google_custom_schemas et google_org_mapping sont-ils obligatoires ?

R : Non, les deux paramètres sont optionnels. Si tu n'utilises pas de custom schemas ou qu'un mappage organisationnel n'est pas requis, communique-le à l'équipe Cyber Guru qui configurera l'intégration avec les valeurs par défaut.

Q : La synchronisation inclut-elle les utilisateurs de tous les domaines de l'organisation ?

R : Par défaut, le domaine indiqué dans google_domain est synchronisé. Si ton organisation a plusieurs domaines Google Workspace (domaines alias ou domaines supplémentaires), contacte l'équipe Cyber Guru.

Q : Puis-je synchroniser uniquement certains Custom Schema ?

R : Oui, utilise le champ google_custom_schemas pour spécifier quels schémas synchroniser.

Q : Puis-je renommer les champs des Custom Schema ?

R : Oui, utilise le champ google_org_mapping pour mapper SchemaName.FieldName → tags.custom_name.

Q : Pourquoi le pays n'est-il pas synchronisé ?

R : Le champ countryCode n'est disponible que si l'adresse est insérée via API avec des champs structurés. Depuis la Google Admin Console, le champ adresse est du texte libre et ne fournit pas de countryCode.

Q : Puis-je modifier les utilisateurs de CyberGuru vers Google ?

R : Non, la synchronisation est unidirectionnelle. Google Workspace est toujours la source de vérité.

Q : Les utilisateurs sont-ils supprimés ?

R : Non, si un utilisateur n'existe plus dans Google, il est seulement suspendu dans CyberGuru, pas supprimé.

Q : Puis-je synchroniser uniquement les utilisateurs de groupes Google spécifiques ?

R : Oui, communique à l'équipe Cyber Guru les ID des groupes Google à inclure. Seuls les utilisateurs membres d'au moins l'un des groupes indiqués seront synchronisés.

Q : Que se passe-t-il si un groupe configuré n'existe plus ?

R: La synchronisation pour la company est interrompue pour des raisons de sécurité. Contacte l'équipe Cyber Guru pour mettre à jour la configuration.

9. Support et Contacts

Pour toute question lors de la configuration, l'équipe Cyber Guru est à ta disposition via les canaux suivants :