GWMME autoriseren voor uw account

Google Workspace Migration for Microsoft Exchange

Voordat u Google Workspace Migration for Microsoft Exchange (GWMME) kunt gebruiken, moet u het autoriseren voor uw account.

Stap 1: Een serviceaccount maken

Hoe u het serviceaccount maakt, hangt af van of u een geautomatiseerd script wilt uitvoeren (aanbevolen) of handmatig een account wilt maken.

Optie 1: Het account maken met een geautomatiseerd script

Dit GitHub-script wordt niet ondersteund door Google Workspace-support. Als u problemen heeft met het script, volgt u de stappen om het account handmatig te maken. Ontdek hoe u het script gebruikt.

  1. Log in als hoofdbeheerder en open Cloud Shell in een browservenster.
  2. Voer de volgende opdracht in de shell in om het geautomatiseerde script te starten:

    python3 <(curl -s -S -L https://git.io/gwmme-create-service-account)

  3. Voer de stappen in het Cloud Shell-venster uit.
  4. Klik op Downloaden om het json-bestand met de client-ID van het serviceaccount te downloaden op uw computer.
  5. Stel de migratie in. Zie Gegevens migreren met GWMME voor meer informatie.

Bekijk meer informatie over hoe u het script gebruikt.

Optie 2: Handmatig een serviceaccount maken

Stap 1: Een project maken

  1. Ga naar Google Cloud en log in als hoofdbeheerder. Als u voor het eerst inlogt bij de console, moet u akkoord gaan met de Servicevoorwaarden.
  2. Klik op IAM en beheer en dan Bronnen beheren. U moet misschien eerst op Menu klikken.
  3. Klik bovenaan op Project maken en voer een projectnaam in.
  4. (Optioneel) Als u het project aan een map wilt toevoegen, klikt u bij Location (Locatie) op Browse (Browsen), gaat u naar de map en klikt u op Select (Selecteren).
  5. Klik op Maken.
  6. Standaard heeft alleen de maker van het project rechten om het project te beheren. Als u zeker wilt wetendat het project onderhouden kan worden als de maker de organisatie verlaat, moet u ten minste één andere persoon de rol van projecteigenaar toewijzen. Ga naar Toegang tot projecten, mappen en organisaties beheren voor meer informatie.

Stap 2: Zet de API's aan voor het serviceaccount

  1. Vink het vakje aan naast uw nieuwe project.
  2. Klik op API's en services en dan Bibliotheek. U moet misschien eerst op Menu klikken.
  3. Klik voor elke API die vereist is (zie hieronder) op de naam van de API en vervolgens op Inschakelen.
    • Admin SDK
    • Google Calendar API
    • Contacts API
    • Gmail API
    • Groups Migration API

    Tip: Als u de API niet kunt vinden, geeft u de API-naam in het zoekvak op.

Stap 3: Stel het OAuth-toestemmingsscherm in

Tip: Gebruik gedeelde e-mailaccounts voor beheerders als u de e-mailadressen hieronder toevoegt.

  1. Open in Google Cloud het project dat u eerder heeft gemaakt.
    • Als u handmatig een serviceaccount heeft gemaakt, is het project gemaakt in Stap 1: Een project maken.
    • Als u het project heeft gemaakt met een script, staat de projectnaam in de Google Cloud Shell Editor nadat het script is uitgevoerd.
  2. Klik op API's en services en dan OAuth-toestemmingsscherm. U moet misschien eerst op Menu klikken.
  3. Klik op Branding.

    Als je Aan de slag niet ziet, ga je naar stap 4. Ga anders naar stap 5.

  4. Click Klanten.

    Als u + Klant maken ziet, gaat u naar Stap 4: Het serviceaccount maken. Ga anders naar stap 5.

  5. Klik op Get started (Aan de slag).
  6. Voer bij App-naam de naam van je app in (bijvoorbeeld Google Workspace Migrate of GWM).
  7. Voer bij E-mailadres gebruikerssupport een e-mailadres in waarop gebruikers contact kunnen opnemen als ze vragen hebben en klik op Volgende.
  8. Selecteer Intern bij Doelgroep en klik op Volgende.
  9. Voer bij Contactgegevens relevante e-mailadressen in en klik op Volgende.
  10. Vink bij Afronden het vakje Ik ga akkoord met het Beleid voor gebruikersgegevens van Google API Services aan.
  11. Klik op Doorgaan en dan Maken.

Stap 4: Het serviceaccount maken

  1. Klik op API's en services en dan Inloggegevens. U moet misschien eerst op Menu klikken.
  2. Klik op Inloggegevens maken en dan Serviceaccount.
  3. Voer bij Service account name (Naam serviceaccount) een naam in voor het serviceaccount en voeg eventueel een beschrijving toe.
  4. Klik op Maken en doorgaan en dan Klaar.
  5. Noteer de unieke ID van het serviceaccount. U heeft dit later nodig. Deze waarde is ook de client-ID van het serviceaccount.

    Tip: Je vindt de waarde ook op het tabblad Details van het serviceaccount of in het json-bestand.

  6. Klik op Klaar en dan Opslaan.
  7. Klik bovenaan op Sleutels en dan Sleutel toevoegen en dan Nieuwe sleutel maken.
  8. Zorg dat het sleuteltype is ingesteld op JSON en klik op Maken.

    U ziet de melding dat het JSON-bestand voor de privésleutel van het serviceaccount is gedownload op uw computer.

  9. Noteer de bestandsnaam en waar uw browser deze opslaat. U heeft dit later nodig.
  10. Klik op Sluiten.

Stap 2: Uw client-ID autoriseren in de Beheerdersconsole

Als u het serviceaccount heeft gemaakt met een geautomatiseerd script, kunt u deze stap overslaan.

Hoe u autoriseert, hangt af van het type account vanuit waar u migreert.

Optie 1: Niet migreren vanuit een Google Workspace-account

Voer deze stappen uit in het doelaccount.

  1. Ga in de Google Beheerdersconsole naar Menu en dan Beveiliging en dan Toegangs- en gegevensbeheer en dan API-functies en dan Domeinbrede machtiging beheren.

    U moet zijn ingelogd als hoofdbeheerder om deze taak te kunnen uitvoeren.

  2. Klik op Nieuwe toevoegen en vul de client-ID van uw serviceaccount in.

    Deze ID (die ook wel de unieke ID wordt genoemd) staat in het json-bestand dat u heeft gedownload toen u het serviceaccount maakte. De ID staat ook in Google Cloud (klik op IAM en beheer en dan Serviceaccounts en dan de naam van uw serviceaccount).

  3. Kopieer en plak in het veld OAuth-bereiken de volgende door komma's gescheiden lijst met bereiken:

    https://www.googleapis.com/auth/contacts,
    https://www.googleapis.com/auth/admin.directory.domain.readonly,
    https://www.googleapis.com/auth/admin.directory.group.readonly,
    https://www.googleapis.com/auth/admin.directory.user,
    https://www.googleapis.com/auth/admin.directory.user.readonly,
    https://www.googleapis.com/auth/apps.groups.migration,
    https://www.googleapis.com/auth/calendar,
    https://www.googleapis.com/auth/gmail.insert,
    https://www.googleapis.com/auth/gmail.labels

  4. Klik op Autoriseren.
  5. Plaats de muisaanwijzer op de nieuwe client-ID, klik op Details bekijken en zorg dat elk bereik wordt vermeld.

    Als een bereik er niet bij staat, klikt u op Bewerken. Vul het ontbrekende bereik in en klik op Autoriseren. U kunt de client-ID niet bewerken.

Het kan tot 24 uur duren voordat wijzigingen zijn verwerkt, maar meestal gaat dit sneller. Meer informatie

Optie 2: Migreren vanuit een Google Workspace-account

De stappen die u moet nemen, zijn afhankelijk van uw instellingen. Het volgende geldt:

  • Google Workspace-bron- en -doeldomeinen die verschillen: Autoriseer GWMME in zowel uw brondomein als uw doeldomein door stap 1 en 2 te volgen (hieronder op deze pagina).
  • Google Workspace-bron- en -doeldomeinen die hetzelfde zijn: Autoriseer GWMME alleen in uw doeldomein door stap 2 te volgen (hieronder op deze pagina).
  • Wachtwoorden toegevoegd aan het csv-bestand voor controle: Autoriseer GWMME alleen in het doeldomein door stap 2 te volgen (hieronder op deze pagina). Geef daarna het bronaccount toegang voor minder goed beveiligde apps. Ga naar Stap 2: Minder goed beveiligde apps toegang tot accounts geven voor meer informatie.

Stap 1: GWMME autoriseren in het brondomein

  1. Ga in de Google Beheerdersconsole naar Menu en dan Beveiliging en dan Toegangs- en gegevensbeheer en dan API-functies en dan Domeinbrede machtiging beheren.

    U moet zijn ingelogd als hoofdbeheerder om deze taak te kunnen uitvoeren.

  2. Klik op Nieuwe toevoegen en vul de client-ID van uw serviceaccount in.

    Deze ID (die ook wel de unieke ID wordt genoemd) staat in het json-bestand dat u heeft gedownload toen u het serviceaccount maakte. De ID staat ook in Google Cloud (klik op IAM en beheer en dan Serviceaccounts en dan de naam van uw serviceaccount).

  3. Kopieer en plak in het veld OAuth-bereiken het volgende bereik:

    https://www.googleapis.com/auth/gmail.imap_admin

  4. Klik op Autoriseren.
  5. Voer vervolgens stap 2 hieronder uit.

Stap 2: GWMME autoriseren in het doeldomein

  1. Ga in de Google Beheerdersconsole naar Menu en dan Beveiliging en dan Toegangs- en gegevensbeheer en dan API-functies en dan Domeinbrede machtiging beheren.

    U moet zijn ingelogd als hoofdbeheerder om deze taak te kunnen uitvoeren.

  2. Klik op Nieuwe toevoegen en vul de client-ID van uw serviceaccount in.

    Deze ID (die ook wel de unieke ID wordt genoemd) staat in het json-bestand dat u heeft gedownload toen u het serviceaccount maakte. De ID staat ook in Google Cloud (klik op IAM en beheer en dan Serviceaccounts en dan de naam van uw serviceaccount).

  3. Kopieer en plak in het veld OAuth-bereiken de volgende door komma's gescheiden lijst met bereiken:

    https://www.googleapis.com/auth/contacts,
    https://www.googleapis.com/auth/admin.directory.group.readonly,
    https://www.googleapis.com/auth/admin.directory.user,
    https://www.googleapis.com/auth/apps.groups.migration,
    https://www.googleapis.com/auth/calendar,
    https://www.googleapis.com/auth/gmail.insert,
    https://www.googleapis.com/auth/gmail.labels

  4. Als uw Google Workspace-bron- en doeldomeinen hetzelfde zijn, voegt u het volgende bereik toe:

    https://www.googleapis.com/auth/gmail.imap_admin

  5. Klik op Autoriseren.
  6. Plaats de muisaanwijzer op de nieuwe client-ID, klik op Details bekijken en zorg dat elk bereik wordt vermeld.

    Als een bereik er niet bij staat, klikt u op Bewerken. Vul het ontbrekende bereik in en klik op Autoriseren. U kunt de client-ID niet bewerken.

Het kan tot 24 uur duren voordat wijzigingen zijn verwerkt, maar meestal gaat dit sneller. Meer informatie

Stap 3: De migratie instellen

Ga naar Gegevens migreren met GWMME voor meer informatie.


Google, Google Workspace en gerelateerde merken en logo's zijn handelsmerken van Google LLC. Alle andere bedrijfs- en productnamen zijn handelsmerken van de bedrijven waarmee ze in verband worden gebracht.