Volg de stappen in de aangegeven volgorde om Zivver met Gmail te gebruiken. Deze instructies leggen uit hoe je als Google Super Admin de Zivver Chrome-extensie voor Google Workspace installeert, zodat gebruikers Zivver-berichten kunnen verzenden en ontvangen in Gmail.

Installatie en configuratie van de Zivver Chrome-extensie

Het instellen van de Zivver Chrome-extensie bestaat uit twee stappen. Zorg ervoor dat je beide stappen uitvoert om Zivver met Gmail te kunnen gebruiken.

1. Installeer de Zivver Chrome-extensie
2. Maak een serviceaccount aan voor de Zivver Chrome-extensie

Zorg ervoor dat je vóór de installatie aan de volgende technische vereisten voldoet:

• Super Admin-rechten in de Google Cloud Platform Console en de Google Beheerdersconsole.
• Zivver-beheerdersrechten.

Tip

Bekijk onze installatie-instructievideo

Installeer de Zivver Chrome-extensie

Stappen

1. Log in met je beheerdersgegevens op de Google Beheerdersconsole van je organisatie.

2. Optioneel: Je kunt de Zivver-extensie beschikbaar maken voor een specifieke groep gebruikers in plaats van voor je hele organisatie — bijvoorbeeld een bepaald team of een pilotgroep. Maak hiervoor eerst een nieuwe organisatie-eenheid (OE) aan en wijs de betreffende gebruikers eraan toe.

Opmerking

Onderliggende organisatie-eenheden (OE’s) nemen apps automatisch over van hun bovenliggende OE, tenzij je overerving uitschakelt voor de onderliggende OE. Zie de Google-pagina Hoe de organisatiestructuur werkt voor meer informatie.

3. Ga in het navigatiemenu links naar Devices > Chrome > Apps & Extensions > Users & Browsers.
   
   

4. Selecteer de OE waaraan je de extensie wilt toewijzen.
   
   

5. Beweeg de muis over het +-icoon rechtsonder en selecteer Add Chrome app or extension by ID.
   
   

6. Voer de ID van de Zivver-extensie in: kckcdkheokdjcdgdfmpkgppflhdbmmhl. Klik vervolgens op SAVE.
   
   

Zivver verschijnt nu in de lijst met geïnstalleerde apps en extensies.

7. Pas het installatiebeleid aan. Gebruik het dropdownmenu aan de rechterkant om Force Install te selecteren.
   
   

8. Klik rechtsboven op SAVE.
   
   

Wat je daarna moet doen

Ga verder met Maak een serviceaccount aan voor de Zivver Chrome-extensie. Deze stap is essentieel om de extensie goed te laten functioneren.

Maak een serviceaccount aan voor de Zivver Chrome-extensie

Na het installeren van de Zivver Chrome-extensie maak je een serviceaccount aan om toegang te verlenen aan je gebruikers.
Je hebt een Google Workspace-account nodig om de Zivver Chrome-extensie te gebruiken.

Een project aanmaken

Technische vereisten

Opmerking

Zorg dat je de Zivver Chrome-extensie succesvol hebt geïnstalleerd. Zie Zivver Chrome-extensie installeren.

• Super Admin-rechten in de Google Cloud Platform Console en Google Admin Console
• Zivver-beheerdersrechten

Procedure

1. Ga naar de Google Cloud Platform Console en log in.

2. Klik bovenaan het scherm op de naam van je organisatie.
   
   

3. Klik in het pop-upvenster op NEW PROJECT.
   
   

4. Geef het project een naam die aansluit bij het doel.
   De velden Organization en Location moeten de naam van je organisatie bevatten.
   Voorbeeld: Zivver

5. Klik op CREATE.
   Het project is nu aangemaakt. Het projectdashboard verschijnt.

Gmail API inschakelen voor het project

Procedure

1. Selecteer dit project in het dropdownmenu naast het Google Cloud-pictogram.
   
   

2. Ga in het linkerpaneel naar API’s & Services > Library.
   
   

3. Typ Gmail API in de zoekbalk van de API-bibliotheek en selecteer deze uit de lijst.
   Je wordt doorgestuurd naar de startpagina van de Gmail API.

4. Klik op ENABLE.
   
   

De Gmail API is nu ingeschakeld voor je project.

Serviceaccount aanmaken

1. Ga naar Credentials en klik op addCREATE CREDENTIALS.

2. Selecteer in het dropdownmenu Service account.
   
   

3. Geef de serviceaccount een duidelijke naam.
   Voorbeeld: Zivver

4. Klik op DONE.
   De serviceaccount verschijnt onderaan het scherm met een e-mailadres dat eindigt op gserviceaccount.com.

5. Klik op het e-mailadres van de serviceaccount.
   
   

6. Ga naar het tabblad KEYS en klik op ADD KEY arrow_drop_down.
   

   Tip

   Heb je problemen met het aanmaken van een nieuwe sleutel? Dan heeft je account waarschijnlijk niet de vereiste rechten. Zie Google Cloud-beleidsinstellingen aanpassen voor instructies om de juiste machtigingen toe te kennen.

7. Selecteer Create new key.
   
   

Er verschijnt een pop-up waarin je het type sleutel moet kiezen.

8. Kies het type JSON en klik op CREATE.
   
   

Je wordt gevraagd om de privésleutel op te slaan in een JSON-bestand.
Na het aanmaken van de serviceaccount genereer je een sleutel om toegang te krijgen tot deze serviceaccount en je Gmail-omgeving. Je hebt deze sleutel maar één keer nodig, tenzij je hem per ongeluk verwijdert in Zivver.
De sleutel wordt opgeslagen in een JSON-bestand dat Zivver versleutelt. Let op: je kunt dit bestand later niet opnieuw downloaden — sla het dus veilig op en zorg dat alleen geautoriseerde personen er toegang toe hebben.

9. Je bent nog steeds op de pagina met serviceaccountgegevens. Klik op Advanced Settings.

10. Kopieer de Client-ID.
    
    

Wat nu?

Gebruik de Client-ID in de volgende sectie.

Verbind de serviceaccount met de Google Workspace-omgeving

Voor je begint

Je hebt de client-ID gekopieerd naar het klembord van je besturingssysteem. Zie Serviceaccount aanmaken.

Procedure

1. Ga naar de Google Admin Console.

2. Klik op Security > Access and data control > API controls.

3. Klik op MANAGE DOMAIN-WIDE DELEGATION.
   
   

4. Klik op Add new.

5. Plak bij Client ID de client-ID die je eerder hebt gekopieerd.

6. Vul bij OAuth-scopes (komma-gescheiden) het volgende in:
   https://www.googleapis.com/auth/gmail.insert

7. Klik op AUTHORIZE.
   Je hebt nu API-machtigingen ingesteld voor de serviceaccount.

Problemen oplossen

Opmerking

Als er een fout optreedt, is de client-ID mogelijk onjuist, bestaat er al een serviceaccount met die ID, of is de opgegeven scope niet ondersteund.

Stel de serviceaccount-sleutel in Zivver in

Procedure

1. Ga naar de pagina Google Workspace-instellingen in de Zivver WebApp.

2. Open het JSON-bestand uit de serviceaccountsectie in een teksteditor op je computer.

3. Klik op Voeg een sleutel toe.

4. Plak de volledige inhoud van het bestand in het tekstvak bij Google Workspace Service-accountsleutel.

5. Klik op Opslaan.
   Het tekstvak verdwijnt dan om veiligheidsredenen. Je ziet nu alleen de knoppen Bewerken en Verwijderen. Gebruik deze knoppen niet, tenzij je bijvoorbeeld migreert naar een andere Google-omgeving.

6. Als je de oranje waarschuwing Er zijn x gebruiker(s) die geen toegang hebben tot de servicesleutel. Als gevolg hiervan kunnen ze de Chrome-extensie niet gebruiken voor Gmail. ziet, klik je op Verleen nu toegang.
   
   
   
   
   Daarna kunnen alle gebruikers zich authenticeren met de Serviceaccount-sleutel.

Info

Je moet toegang verlenen tot de servicesleutel voor elk account dat handmatig is aangemaakt in Zivver.
Dat is niet nodig voor gebruikers die zijn aangemaakt met de Zivver Synctool, want die krijgen automatisch toegang tot de servicesleutel.

Je Zivver Chrome Extension (wanneer uitgerold) is nu klaar voor gebruik.

Verleen toegang tot de Zivver Chrome Extension

Over deze taak

Als je een gebruiker hebt aangemaakt zonder de Zivver Synctool, moet je die gebruiker handmatig toegang geven tot de Zivver Chrome Extension op de pagina Google Workspace-instellingen. Gebruikers zonder toegang zien dit bericht in het Zivver-paneel in Gmail:
Zivver is not set up correctly, speak to your administrator

Procedure

1. Ga naar de pagina Google Workspace-instellingen in de Zivver WebApp.
2. Klik op Verleen nu toegang in de oranje waarschuwing Er zijn x gebruiker(s) die geen toegang hebben tot de servicesleutel. Als gevolg hiervan kunnen ze de Chrome-extensie niet gebruiken voor Gmail..

Na het vernieuwen van de pagina kunnen de gebruikers de Zivver Chrome Extension gebruiken.