Synchroniser avec Google Workspace

Cet article vous aidera à commencer à utiliser Directory Connector pour synchroniser les utilisateurs et les groupes de votre répertoire Google Workspace (anciennement "G Suite") avec votre organisation Bitwarden.

Pour configurer la synchronisation de l'annuaire avec Google Workspace (anciennement "G Suite"), vous aurez besoin d'accéder au Portail Admin de Google Workspace et à la Console de la Plateforme Cloud de Google. Le connecteur de répertoire nécessitera des informations obtenues à partir de ces processus pour fonctionner correctement.

Suivez les étapes suivantes pour créer un projet Google Cloud à utiliser pour connecter le connecteur de répertoire à votre répertoire. Si vous avez déjà un projet Google Cloud disponible, passez à Activer Admin SDK :

1. Dans la Console GCP, sélectionnez le bouton Créer un projet.

2. Entrez un nom spécifique à Bitwarden pour le projet (par exemple, bitwarden-dc-project) et sélectionnez le bouton Créer.

Suivez les étapes suivantes pour activer l'API SDK Admin, à laquelle le connecteur de répertoire fera des demandes :

1. Dans la Console GCP, sélectionnez le projet créé ou préexistant.

2. Dans la navigation à gauche, sélectionnez APIs & Services → Bibliothèque.

3. Dans la boîte de recherche, entrez Admin SDK et ouvrez le service Admin SDK API.

4. Sélectionnez le bouton Activer.

Suivez les étapes suivantes pour créer un compte de service à utiliser lors des appels API :

1. Dans la Console GCP, sélectionnez le projet créé ou préexistant.

2. Dans la navigation à gauche, sélectionnez APIs & Services → Identifiants.

3. Sélectionnez le bouton Créer des identifiants, et sélectionnez Compte de service dans le menu déroulant.

4. Remplissez la section Détails du compte de service, et sélectionnez le bouton Créer.

5. Dans la section Accorder à ce compte de service l'accès au projet, sélectionnez Projet → Propriétaire dans le menu déroulant Rôle et sélectionnez le bouton Continuer.

6. Sélectionnez le bouton Terminé.

Suivez les étapes suivantes pour obtenir les autorisations appropriées pour le compte de service créé :

1. Dans la Console GCP, sélectionnez le projet créé ou préexistant.

2. Dans la navigation à gauche, sélectionnez IAM & Admin → Comptes de Service.

3. Sélectionnez le compte de service créé.

4. Sur la page Détails du Compte de Service, sélectionnez le bouton Ajouter Clé et sélectionnez Créer nouvelle clé dans le menu déroulant.

5. Sélectionnez le type de clé JSON et sélectionnez le bouton Créer pour télécharger une clé au format JSON sur votre machine locale.

6. Retournez sur la page de détails de votre compte de service, sélectionnez le menu déroulant Afficher la délégation à l'échelle du domaine.

7. Suivez ces étapes pour activer l'autorité déléguée à l'échelle du domaine.

8. Entrez un Nom de produit pour l'écran de consentement.

9. Sélectionnez Enregistrer.

Suivez les étapes suivantes pour autoriser le client à lire votre répertoire :

1. Ouvrez le Portail Admin de Google.

2. Dans la navigation à gauche, sélectionnez Sécurité → Contrôles API.

3. Sélectionnez le bouton Gérer la délégation à l'échelle du domaine.

4. Sélectionnez le bouton Ajouter nouveau.

5. Dans le champ ID du client, collez l'ID du client créé.

   Pour récupérer l'ID de client créé, ouvrez la Console GCP et naviguez vers API & Services → Identifiants.

6. Dans le champ des portées OAuth, collez la valeur suivante pour n'accorder qu'un accès en lecture seule :

   Bash
   https://www.googleapis.com/auth/admin.directory.user.readonly,https://www.googleapis.com/auth/admin.directory.group.readonly,https://www.googleapis.com/auth/admin.directory.group.member.readonly

7. Sélectionnez le bouton Autoriser.

Suivez les étapes suivantes pour configurer le connecteur de répertoire pour utiliser votre répertoire Google :

1. Ouvrez l'application de bureau Directory Connector.

2. Naviguez vers l'onglet Paramètres.

3. Dans le menu déroulant Saisir, sélectionnez G Suite (Google).

   Les champs disponibles dans cette section changeront en fonction du type que vous avez choisi de saisir.

4. Entrez le Domaine de votre compte Google.

5. Entrez l'adresse de courriel d'un Utilisateur Admin avec un accès complet à votre répertoire Google.

6. Si vous en avez un, entrez l'ID Client de votre répertoire. De nombreux utilisateurs n'auront pas ou ne seront pas obligés de saisir un identifiant client.

7. Sélectionnez le bouton Choisir un fichier et sélectionnez la clé JSON téléchargée.

Suivez les étapes suivantes pour configurer les paramètres utilisés lors de la synchronisation à l'aide de Directory Connector:

1. Ouvrez l'application de bureau Directory Connector.

2. Naviguez vers l'onglet Paramètres.

3. Dans la section Synchroniser, configurez les options suivantes comme vous le souhaitez :

Utilisez des listes séparées par des virgules pour inclure ou exclure d'une synchronisation en fonction du courriel de l'utilisateur ou du groupe.

L'API SDK Admin offre des capacités de filtrage limitées pour les utilisateurs et les groupes avec un paramètre de requête. Pour en savoir plus :

• Rechercher des utilisateurs

• Rechercher des groupes

Filtres utilisateur

Les syntaxes de filtrage suivantes doivent être utilisées dans le champ Filtre Utilisateur :

Inclure/Exclure des utilisateurs par courriel

Pour inclure ou exclure des utilisateurs spécifiques d'une synchronisation basée sur l'adresse de courriel :

Bash
include:joe@example.com,bill@example.com,tom@example.com

Bash
exclude:joe@example.com,bill@example,tom@example.com

Concaténer avec requête

Pour concaténer un filtre utilisateur avec le paramètre query, utilisez un pipe (|) :

Bash
include:john@example.com,bill@example.com|orgName=Engineering orgTitle:Manager

Bash
exclude:john@example.com,bill@example.com|orgName=Engineering orgTitle:Manager

Utilisez uniquement requête

Pour utiliser uniquement le paramètre query, préfixez la requête avec un pipe (|) :

Bash
|orgName=Engineering orgTitle:Manager

Filtres de groupe

Les syntaxes de filtrage suivantes doivent être utilisées dans le champ Filtre de Groupe :

Inclure/Exclure des groupes

Pour inclure ou exclure des groupes d'une synchronisation basée sur le Nom du Groupe :

Bash
include:Group A,Group B

Bash
exclude:Group A,Group B

Inclure des groupes avec joker

Bash
|name:*marketing*

Les caractères génériques * sont pris en charge des deux côtés du paramètre de recherche. De plus, la recherche n'est pas sensible à la casse.

Concaténer avec requête

Pour concaténer un filtre de groupe avec le paramètre query, utilisez un pipe (|):

Bash
include:name='Engineering'|email:admin*

Bash
exclude:name='Engineering'|email:admin*

Utilisez uniquement requête

Pour utiliser uniquement le paramètre query, préfixez la requête avec un pipe (|) :

Bash
|memberKey=user@company.com

Pour vérifier si le connecteur de répertoire se connectera avec succès à votre répertoire et renverra les utilisateurs et les groupes souhaités, naviguez vers l'onglet Tableau de bord et sélectionnez le bouton Tester maintenant. Si réussi, les utilisateurs et les groupes seront imprimés dans la fenêtre du Connecteur de Répertoire selon les options de synchronisation et les filtres spécifiés :

Une fois que les options de synchronisation et les filtres sont configurés et testés, vous pouvez commencer à synchroniser. Suivez les étapes suivantes pour commencer la synchronisation automatique avec le connecteur de répertoire:

1. Ouvrez l'application de bureau Directory Connector.

2. Naviguez vers l'onglet Tableau de bord.

3. Dans la section Synchroniser, sélectionnez le bouton Démarrer la synchronisation.

   Vous pouvez également sélectionner le bouton Synchroniser maintenant pour exécuter une synchronisation manuelle unique.

Le connecteur de répertoire commencera à interroger votre répertoire en fonction des options de synchronisation et des filtres configurés.

Si vous quittez ou fermez l'application, la synchronisation automatique s'arrêtera. Pour garder Directory Connector en fonctionnement en arrière-plan, minimisez l'application ou cachez-la dans la barre des tâches.