Synchroniseren met Google Workspace

Dit artikel helpt je op weg met Directory Connector om gebruikers en groepen uit je Google Workspace (voorheen "G Suite") Directory te synchroniseren met je Bitwarden-organisatie.

Om mapsynchronisatie met Google Workspace (voorheen "G Suite") in te stellen, heb je toegang nodig tot de Google Workspace Admin Portal en Google Cloud Platform Console. Directory Connector heeft de informatie uit deze processen nodig om goed te kunnen functioneren.

Voer de volgende stappen uit om een Google Cloud-project aan te maken dat je kunt gebruiken om Directory Connector te verbinden met je directory. Als je al een Google Cloud-project hebt, ga dan naar Admin SDK inschakelen:

1. Selecteer in de GCP Console de knop Create Project (Project maken).

2. Voer een Bitwarden-specifieke naam in voor het project (bijvoorbeeld bitwarden-dc-project) en selecteer de knop Aanmaken.

Voer de volgende stappen uit om de Admin SDK API in te schakelen, waarnaar Directory Connector verzoeken zal doen:

1. Selecteer in de GCP Console het aangemaakte of reeds bestaande project.

2. Selecteer in de linker navigatie API's en services → Bibliotheek.

3. Voer in het zoekvak Admin SDK in en open de API-service Admin SDK.

4. Selecteer de knop Inschakelen.

Voer de volgende stappen uit om een serviceaccount aan te maken die u kunt gebruiken bij het doen van API-aanroepen:

1. Selecteer in de GCP Console het aangemaakte of reeds bestaande project.

2. Selecteer in de linkernavigatie API's & Services → Credentials.

3. Selecteer de knop Credentials aanmaken en selecteer Service account in de vervolgkeuzelijst.

4. Vul de gegevens van de serviceaccount in en selecteer de knop Aanmaken.

5. Selecteer in het gedeelte Deze serviceaccount toegang verlenen tot project Project → Eigenaar in de vervolgkeuzelijst Rol en selecteer de knop Doorgaan.

6. Selecteer de knop Gereed.

Voer de volgende stappen uit om de juiste machtigingen te verkrijgen voor de aangemaakte serviceaccount:

1. Selecteer in de GCP Console het aangemaakte of reeds bestaande project.

2. Selecteer in de linker navigatie IAM & Admin → Service Accounts.

3. Selecteer de aangemaakte serviceaccount.

4. Selecteer op de pagina Service Account Details de knop Add Key (Sleutel toevoegen) en selecteer Create new key (Nieuwe sleutel maken ) in de vervolgkeuzelijst.

5. Selecteer het sleuteltype JSON en selecteer de knop Maken om een sleutel in JSON-formaat te downloaden naar uw lokale computer.

6. Selecteer op de detailpagina van je serviceaccount de vervolgkeuzelijst Domeinbrede delegatie weergeven.

7. Volg deze stappen om delegate domain-wide authority in te schakelen.

8. Voer een productnaam in voor het toestemmingsscherm.

9. Selecteer Opslaan.

Voer de volgende stappen uit om de client te machtigen om je map te lezen:

1. Open het Google beheerportaal.

2. Selecteer in de linkernavigatie Beveiliging → API-besturingselementen.

3. Selecteer de knop Domeinbrede delegatie beheren.

4. Selecteer de knop Nieuwe toevoegen.

5. Plak in het veld Client ID de aangemaakte Client ID.

   Om de aangemaakte Client ID op te halen, open de GCP Console en navigeer naar API & Services → Credentials.

6. Plak in het veld OAuth scopes de volgende waarde om alleen leestoegang te verlenen:

   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. Selecteer de knop Autoriseren.

Voer de volgende stappen uit om Directory Connector te configureren om je Google-map te gebruiken:

1. Open de Directory Connector desktop app.

2. Navigeer naar het tabblad Instellingen.

3. Selecteer G Suite (Google) in de vervolgkeuzelijst Type.

   De beschikbare velden in dit gedeelte veranderen afhankelijk van het geselecteerde type.

4. Voer het domein van je Google-account in.

5. Voer het e-mailadres in van een Admin-gebruiker met volledige toegang tot je Google-map.

6. Als je er een hebt, voer dan de klant-ID van je telefoonboek in. Veel gebruikers zullen geen klant-ID hebben of hoeven in te voeren.

7. Selecteer de knop Bestand kiezen en selecteer de gedownloade JSON-sleutel.

Voer de volgende stappen uit om de instelling te configureren die wordt gebruikt bij het synchroniseren met Directory Connector:

1. Open de Directory Connector desktop app.

2. Navigeer naar het tabblad Instellingen.

3. Configureer de volgende opties naar wens in het gedeelte Sync:

Gebruik door komma's gescheiden lijsten om op te nemen in of uit te sluiten van een synchronisatie op basis van gebruikerse-mail of groep.

De Admin SDK API biedt beperkte filtermogelijkheden voor gebruikers en groepen met een queryparameter. Voor meer informatie:

• Zoeken naar gebruikers

• Groepen zoeken

Gebruikersfilters

De volgende filtersyntaxis moet worden gebruikt in het veld Gebruikersfilter:

Gebruikers per e-mail insluiten/uitsluiten

Specifieke gebruikers in- of uitsluiten van een synchronisatie op basis van e-mailadres:

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

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

Aaneenschakelen met query

Gebruik een pijp(|) om een gebruikersfilter aaneen te rijgen met de queryparameter:

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

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

Alleen query gebruiken

Om alleen de queryparameter te gebruiken, zet je een pijp(|) voor de query:

Bash
|orgName=Engineering orgTitle:Manager

Filters groeperen

De volgende filtersyntaxis moet worden gebruikt in het veld Groepsfilter:

Groepen insluiten/uitsluiten

Groepen in- of uitsluiten van een synchronisatie op basis van groepsnaam:

Bash
include:Group A,Group B

Bash
exclude:Group A,Group B

Groepen opnemen met jokertekens

Bash
|name:*marketing*

Jokertekens * worden ondersteund aan beide zijden van de zoekparameter. Bovendien is het zoeken niet hoofdlettergevoelig.

Aaneenschakelen met query

Om een groepsfilter samen te voegen met de query parameter, gebruik je een pipe(|):

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

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

Alleen query gebruiken

Om alleen de queryparameter te gebruiken, zet je een pijp(|) voor de query:

Bash
|memberKey=user@company.com

Om te testen of Directory Connector succesvol verbinding maakt met je directory en de gewenste gebruikers en groepen retourneert, navigeer je naar het tabblad Dashboard en selecteer je de knop Nu testen. Als dit lukt, worden gebruikers en groepen afgedrukt in het Directory Connector-venster volgens de opgegeven synchronisatieopties en filters:

Zodra de synchronisatieopties en filters zijn geconfigureerd en getest, kun je beginnen met synchroniseren. Voer de volgende stappen uit om de automatische synchronisatie met Directory Connector te starten:

1. Open de Directory Connector desktop app.

2. Navigeer naar het tabblad Dashboard.

3. Selecteer in het gedeelte Synchronisatie de knop Synchronisatie starten.

   Je kunt ook de knop Nu synchroniseren selecteren om een eenmalige handmatige synchronisatie uit te voeren.

Directory Connector begint je directory te controleren op basis van de geconfigureerde synchronisatieopties en filters.

Als je de toepassing afsluit of sluit, stopt de automatische synchronisatie. Als je Directory Connector op de achtergrond wilt laten draaien, minimaliseer je de toepassing of verberg je deze in het systeemvak.