Ga naar hoofdinhoud

Synchronisatie met Google Workspace

Om Toolbox te kunnen synchroniseren met Google Workspace, moeten er een aantal zaken worden ingesteld.

1. Google Workspace Setup​

Wanneer er in de google UI naar tekst verwezen wordt, gebruiken we standaard de Nederlandstalige labels. De Engelse vertaling wordt telkens tussen haakjes vermeld.

2. Een serviceaccount aanmaken​

Zorg er eerst voor dat er een project is in Google Cloud waarin je een service account kan aanmaken. Je mag een bestaand project selecteren, maar we raden aan om een project specifiek voor Toolbox aan te maken. Bovenaan in de Cloud Console is er een dropdown beschikbaar voor projecten, waar je ook meteen een nieuw project kan aanmaken.

Gsync_1 Gsync_2 Gsync_3

  • Selecteer het gewenste project en ga vervolgens naar 'APIs & Services > Bibliotheek' (APIs & Services > Library). Zoek hier naar de 'Admin SDK API', en schakel hem in.

Gsync_4 Gsync_5 Gsync_6

  • Ga nu naar 'APIs & Services > Inloggegevens' (APIs & Services > Credentials) en klik op 'Inloggegevens maken > Serviceaccount' (Create Credentails > Serviceaccount).

Gsync_7

  • Geef de naam 'toolbox' op voor de accountnaam en klik op 'aanmaken' tot je op het overzichtsscherm van de API accounts komt.

Gsync_8

  • Klik op de account die je net aangemaakt hebt en selecteer de tab 'Sleutels' (Keys).

Gsync_9 Gsync_10

  • Hier klik je op de knop 'Sleutel toevoegen' > 'Nieuwe sleutel maken' (Add key > Create new Key).

Gsync_11

  • Selecteer de JSON optie en download het sleutelbestand.

Gsync_12 Gsync_13

3. Een admin account aanmaken​

De service account die je net hebt aangemaakt, kan in principe enkel gebruikt worden om zonder gebruikersinteractie geauthenticeerde API calls te maken. Er dient nog een gebruiker aangemaakt te worden door wie de wijzigingen in de achtergrond zullen worden doorgevoerd. In principe kan hiervoor een bestaand, persoonlijk admin account gebruikt worden, maar i.v.m. continuiteit raden we aan om hiervoor een nieuw account, specifiek voor toolbox, in te richten.

Ga naar https://admin.google.com en maak daar een gebruiker aan, toolbox@[domein]. Zorg ervoor dat deze gebruiker rechten heeft op alle mogelijke rechten in de groep 'Gebruikers' (Users).

Gsync_14 Gsync_15 Gsync_16 Gsync_17

Als laatste moeten we onze API nog toegang geven tot de directory.

  • Ga hiervoor in de Adminconsole naar 'Beveiliging > Toegangs- en Gegevenscontrole > API functies' (Security > Access & data control > API controls), en ga onderaan de pagina naar 'Domeinbrede machtigingen' (Domain-wide delegation).
  • Klik op 'Nieuw toevoegen' (Add new). Plak onder het 'Client-Id' het 'Client-Id' uit het JSON-bestand dat je eerder downloadde en voeg volgend Oauth bereik toe: https://www.googleapis.com/auth/admin.directory.user .
  • Klik nu op 'Autoriseren' (Authorise).

4. Instellingen Toolbox​

Ga naar de module Instellingen in Toolbox en zoek naar Google. Vul onderaan bij de sectie 'Algemeen' de inhoud van de json in alsook ook de gebruikersnaam van de account die je hebt aangemaakt.

Gsync_18