Om Zivver in Gmail te gebruiken, volg je deze stappen in de aangegeven volgorde. De volgende instructies begeleiden je bij het installeren van de Zivver Chrome-extensie voor Google Workspace als Google Super Admin, zodat gebruikers Zivver-berichten kunnen verzenden en ontvangen via Gmail.

Installatie en configuratie van de Zivver Chrome-extensie

De installatie van de Zivver-extensie in Google Chrome bestaat uit twee stappen. Zorg ervoor dat je beide stappen voltooit om Zivver in Gmail te kunnen gebruiken.

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

Zorg ervoor dat je deze technische vereisten hebt voordat je begint:

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

Installeer de Ziver Chrome Extension

Procedure

1. Log in met je beheerdersgegevens in de Google Workspace van je organisatie via de Google Admin Console.
   
2. (Optioneel) Je kunt de Zivver-extensie alleen beschikbaar maken voor een specifieke groep gebruikers in plaats van voor je hele organisatie. Bijvoorbeeld voor een specifiek team of een pilotgroep. Als je dit wilt doen, maak dan eerst een nieuwe Organizational Unit (OU) aan en wijs de relevante gebruikers aan deze OU toe.

1. Ga vanuit het navigatiemenu aan de linkerkant naar Devices > Chrome > Apps & Extensions > Users & Browsers.
   
   

2. Selecteer de OU waaraan je de extensie wilt toewijzen.
   
   

3. Beweeg met de muis over het +-icoon rechtsonder in het scherm en selecteer Add Chrome app or extension by ID.
   
   

4. Voer het ID van de Zivver-extensie in: kckcdkheokdjcdgdfmpkgppflhdbmmhl. Klik daarna op Save.
   
   

Nu wordt Zivver weergegeven als een app in de lijst van geïnstalleerde apps en extensies.

1. Wijzig het installatiebeleid.
   Gebruik het dropdownmenu aan de rechterkant om Force install te selecteren.
   
   

2. Klik rechtsboven op SAVE.
   
   

Volgende stap
Ga verder met Maak een service-account aan voor de Zivver Chrome Extension. Dit is een cruciale stap voor het functioneren van de extensie.

Maak een Service-account aan voor de Zivver Chrome Extension

Na de installatie van de Zivver Chrome Extension kun je een serviceaccount aanmaken om toegang te verlenen aan je gebruikers. Je moet beschikken over een Google Workspace Account om met de Zivver Chrome Extension te kunnen werken.

Pas de Google Cloud policy aan

Voordat er een Google Service account key kan worden aangemaakt, moet dit eerst worden toegestaan. Volg de onderstaande stappen om dit mogelijk te maken.

1. Ga naar de Google Cloud Platform Console en log in met je Super Admin-account.

2. Selecteer linksboven, naast het Google Cloud-logo, je organisatie uit de dropdownlijst.
   
   

3. Ga naar shield_person IAM and admin.
   
   

4. Klik op person_add GRANT ACCESS.
   
   

5. Voeg je Super Admin-account toe in het veld New principal.
   
   

6. Selecteer onder Assign roles de rollen Organization Administrator en Organization Policy Administrator.
   
   

7. Klik op SAVE en wacht een paar minuten (ongeveer 3 minuten) om zeker te zijn dat IAM correct is doorgevoerd.

8. Ga naar article Organization Policies.
   
   

9. Filter op iam.disableServiceAccountKeyCreation.
   
   

10. Selecteer het beleid iam.disableServiceAccountKeyCreation.

11. Klik op edit MANAGE POLICY.
    
    

12. Scroll naar beneden naar Rules en klap de Enforced rule open.

13. Verander Enforcement naar Off.
    
    

14. Klik op DONE.
    
    

15. Klik op SET POLICY.
    
    

Maak een project aan

Technische vereisten

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

Procedure

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

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

3. Klik in de pop-up die verschijnt op NEW PROJECT.
   
   

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

5. Klik op CREATE.
   Je hebt een project aangemaakt. Nu zie je het dashboard van het project.

Activeer de Gmail API voor het project

Procedure

1. Selecteer dit project in de dropdown naast het Google Cloud-icoon.
   
   

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

3. Voer gmail api in de zoekbalk van de API Library in en selecteer deze vervolgens uit de lijst.
   De procedure leidt je door naar de Gmail API startpagina.

4. Klik op ENABLE.
   
   

Je hebt nu de Gmail API geactiveerd voor je project.

Maak het service account aan

1. Ga naar Credentials en klik op + CREATE CREDENTIALS.

2. Kies in het dropdownmenu Service Account.
   
   

3. Geef het service account een beschrijvende naam.
   Voorbeeld: Zivver

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

5. Klik op het e-mailadres van het service account.
   
   

6. Ga naar het tabblad KEYS. Klik vervolgens op ADD KEY.

7. Selecteer Create new key.
   
   
   Er verschijnt een pop-up om het type sleutel te selecteren.

8. Kies JSON type en klik op CREATE.
   
   
   Je krijgt een verzoek om de private key op te slaan in een JSON-bestand.
   
   Nadat je het serviceaccount hebt aangemaakt, maak je een key aan om toegang te krijgen tot dit serviceaccount en je Gmail-omgeving. Je hebt de key slechts één keer nodig, tenzij je deze per ongeluk verwijdert in Zivver.
   De key wordt opgeslagen in een JSON-bestand. Zivver slaat dat bestand vervolgens versleuteld op. Maar zowel Google als Zivver laten je het bestand niet opnieuw downloaden. Sla het bestand dus op een veilige locatie op waar alleen geautoriseerde personen toegang hebben.

9. Nog steeds op de pagina Service account details, klik op Advanced Settings.

10. Kopieer het Client ID.
    
    

Volgende stap
Gebruik het Client ID voor de volgende paragraaf.

Verbind het service account met de Google Workspace-omgeving

Voorbereiding
Je hebt het client ID naar het klembord van je besturingssysteem gekopieerd. Zie Maak het service account aan.

Procedure

1. Ga naar de Google Beheerconsole.
   
2. Klik op Security > Access and data control > API controls.

3. Klik op MANAGE DOMAIN-WIDE DELEGATION.
   
   

4. Klik op Add new.

5. Bij Client ID, plak het client ID die je gekopieerd hebt.

6. Bij OAuth scopes (kommagescheiden) vul je het volgende in:
   https://www.googleapis.com/auth/gmail.insert

7. Klik op AUTHORIZE.
   Je hebt nu API-rechten ingesteld voor het service account.

Problemen oplossen

Configureer de service account sleutel in Zivver

Procedure

1. Ga naar de External Services pagina in de Zivver WebApp.
   Gebruik deze link, omdat de pagina voor external services verborgen is in het linker paneel van het Zivver beheerportaal.
   
2. Open het JSON-bestand uit de service account sectie in een tekstbewerker op je computer.
3. Plak de volledige inhoud van het bestand in het tekstvak bij G-Suite Service Account Key.
4. Klik op Save.
   Het tekstvak verdwijnt dan om veiligheidsredenen. Je ziet nu alleen de knoppen Update/Delete. Gebruik deze knoppen niet, tenzij je bijvoorbeeld migreert naar een andere Google-omgeving.
5. Als je de kaart Users without access op de pagina ziet, klik dan op Grant Access.
   
   
   Alle gebruikers kunnen zich dan authenticeren met de Service Account-sleutel.

Je Zivver Chrome Extension (na implementatie) is nu klaar voor gebruik.

Toegang verlenen tot de Zivver Chrome Extension

Inleiding
Als je een gebruiker hebt aangemaakt zonder de Zivver Synctool, moet je ze toegang verlenen tot de Zivver Chrome Extension op de pagina Externe Services. Gebruikers zonder toegang zien dit bericht in het Zivvervenster in Gmail:
Zivver is not set up correctly, speak to your administrator

Procedure

1. Ga naar de pagina Externe Services.
   
2. Klik op Grant access onder Users without access.
   

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

De-installeer de Chrome Extensie

1. Ga naar https://admin.google.com
2. Navigeer naar Devices > Chrome > Apps & Extensions > Users & Browsers
3. Verwijder de Chrome Extensie
4. Ga naar https://console.cloud.google.com/
5. Selecteer het Zivver project
6. Navigeer naar IAM and admin
7. Selecteer Settings
8. Klik op Shut Down