Installatiehandleiding OWA add-in

Inleiding

Gebruik de Zivver Outlook Web Access Add-in om veilige berichten te verzenden en ontvangen vanuit de Outlook Web Access (OWA). Deze handleiding beschrijft hoe je de add-in installeert in Exchange Online (onderdeel van Microsoft Office 365).

Vanaf OWA add-in v6 gebruikt Zivver een andere vorm van versienummers, in lijn met onze andere integraties. Daarom zul je een versienummer in de vorm van 3.xxx.x zien, in plaats van 6.x

Technische vereisten

Je kunt de Zivver OWA add-in installeren in Exchange Online. Om de OWA add-in te gebruiken, moet je aan deze vereisten voldoen:

  • Gebruik Exchange Online
  • De werkstations van de gebruikers (Windows of Mac) hebben de nieuwste algemeen beschikbare (GA) of stabiele versie van een van deze moderne browsers geïnstalleerd:
    • Microsoft Edge gebaseerd op Chromium (aanbevolen)
    • Google Chrome / Chromium (voor Android/iOS) (aanbevolen)
    • Mozilla Firefox
    • Apple Safari (voor iOS)
  • Sta cookies toe in de browser voor deze exacte URL’s. Lees meer over CookiesAllowedForUrls in Edge (deze instelling werkt hetzelfde in Chrome)
    • [*.]office.com
    • [*.]office365.com
    • [*.]zivver.com
      De Zivver-add-in slaat de actieve sessie van een gebruiker op in LocalStorage. Het blokkeren van cookies voor deze domeinen zal ervoor zorgen dat gebruikers na elke paginavernieuwing opnieuw moeten inloggen
  • Sta pop-ups toe in de browser voor deze exacte URL’s. Lees meer over PopupsAllowedForUrls in Edge (deze instelling werkt hetzelfde in Chrome)
    • [*.]office.com
    • [*.]office365.com
    • [*.]zivver.com
      De Zivver-add-in maakt gebruik van pop-ups om gebruikers in te loggen. Het blokkeren van pop-ups voor deze domeinen zal voorkomen dat gebruikers zich kunnen aanmelden bij Zivver
  • Een Entra ID admin account met Global Administrator rechten
  • Een Zivver beheeraccount

Installatie

Je kunt de Zivver OWA add-in installeren via het Microsoft 365 admin center. Volg de stappen hieronder.

Implementeer en configureer de Zivver OWA add-in via Microsoft 365 admin center

  1. Log in op het Microsoft 365 admin center.
  2. Klik op add Invoegtoepassing implementeren.
  3. Klik op Volgende.
  4. Kies Aangepaste apps uploaden onder Aangepaste invoegtoepassing implementeren.
  5. Voer https://owa-v6.zivver.com/manifest.xml in als de URL van het OWA Add-in manifestbestand.
    Zorg ervoor dat je https:// opneemt, ook al staat dit al in de gebruikersinterface.
  6. Klik op Uploaden.
    Een Invoegtoepassing configureren scherm wordt getoond.
  7. Kies welke gebruikers de Zivver OWA add-in krijgen toegewezen:
    • Iedereen
      Alle gebruikers in jouw organisatie kunnen de add-in gebruiken. Kies "Iedereen" om de add-in uit te rollen naar jouw hele organisatie. Bijvoorbeeld bij het live gaan met Zivver.
    • Specifieke gebruikers/groepen
      Maak de add-in alleen beschikbaar voor specifieke gebruikers of groepen. Kies dit voor een pilot of wanneer alleen specifieke gebruikers OWA gebruiken.
    • Microsoft ondersteunt het toewijzen van invoegtoepassingen aan geneste groepen niet. Lees hier meer over in hun documentatie.
    • Alleen ik
      Maakt de add-in alleen beschikbaar voor jouw ingelogde beheerdersaccount. Kies dit als je alleen zelf wilt testen.
  8. Kies hoe de add-in wordt geïmplementeerd naar gebruikers:
    • Vast (Standaard)
      Aanbevolen. De add-in is standaard ingeschakeld voor toegewezen gebruikers en ze kunnen de add-in niet uitschakelen.
    • Beschikbaar
      Niet aanbevolen. De add-in is standaard uitgeschakeld, maar toegewezen gebruikers kunnen de add-in installeren wanneer ze willen.
    • Optioneel
      De add-in is standaard ingeschakeld voor toegewezen gebruikers, maar ze kunnen de add-in uitschakelen wanneer ze willen.
  9. Klik op Implementeren.
  10. Lees de melding van Microsoft en klik op Volgende.
  11. Klik op Sluiten
    De Zivver OWA add-in is nu geïnstalleerd en geconfigureerd voor jouw Office 365-organisatie. Het kan tot 24 uur duren voordat de wijziging is doorgevoerd in Exchange Online. Zie Microsoft's documentatie voor meer informatie.
  12. Ga verder met de stappen voor de admin-toestemming.

Geef admin-toestemming voor de vereiste Graph API-rechten

Zivver OWA add-in heeft admin-toestemming van jouw organisatie nodig om naadloos samen te werken met de Graph API.

Zorg ervoor dat je de toestemming geeft voor de hele organisatie, zelfs als slechts een selecte groep gebruikers de add-in zal testen.
  1. Bij het starten van de add-in (na succesvol inloggen op Zivver als je nog niet bent ingelogd), verschijnt er een dialoogvenster dat de vereiste toestemmingen van Zivver OWA add-in toont.
  2. VERGEET NIET om het vakje aan te vinken dat zegt Toestemming geven namens jouw organisatie voordat je op de knop Accepteren klikt.

    Als je vergeet het vakje aan te vinken om Toestemming te geven namens jouw organisatie, krijg je geen tweede kans. Een andere admin moet opnieuw beginnen door de add-in vanuit zijn/haar mailbox te starten.
Door toestemming te geven namens jouw organisatie, hoeven de gebruikers zich geen zorgen te maken over de toestemmingen en kunnen ze meteen Zivver gebruiken in hun OWA-omgeving.
  1. Je bent klaar. Ga verder met de vereiste aanvullende instellingen

Maak een Exchange regel voor Zivver-berichten

De volgende regel in Exchange voorkomt dat Zivver-berichten vanuit OWA als onversleutelde, normale e-mail worden verzonden.

Als je deze regel niet instelt, worden Zivver-berichten onveilig verstuurd en ontstaat er mogelijk een datalek.
  1. Log in op het Exchange beheercentrum.
  2. Klik e-mailstroom > regels.
  3. Klik add Nieuw > Nieuwe regel maken… . nieuwe regel opent.
  4. Voer in Naam zivver-action:discard.
  5. Selecteer bij Deze regel toepassen als… de optie Een berichtkop komt overeen met deze tekstpatronen.
  6. Klik Voer tekst in….
    Een pop-up scherm verschijnt om een naam op te geven van de header.
  7. Geef zivver-action op als naam van de header.
  8. Klik OK.
  9. Klik Tekstpatronen invoeren….
    woordgroepen opgeven opent.
  10. Voer discard in
  11. Klik Toevoegen.
  12. Klik OK.
  13. Onder Doe het volgende… de optie Bericht blokkeren en de subsectie bericht verwijderen zonder iemand op de hoogte te brengen.
  14. Klik Volgende.
  15. Kies een modus voor deze regel: Afdwingen
  16. Selecteer ernstniveau: Laag.
  17. Selecteer Stoppen met verwerken van meer regels.
  18. Bij Afstemmen op afzenderadres in het bericht kies Header.
  19. Klik Volgende, daarna Voltooien.
  20. Wacht enkele momenten. De prioriteit kan nu worden bepaald.
  21. Selecteer de nieuwe regel.
  22. Activeer de regel.
  23. Klik edit Bewerken.
  24. Klik Instellingen.
  25. Verhoog de prioriteit van de zivver-action:discard regel naar 0.
    De Exchange regel is nu aangemaakt zodat Zivver-berichten niet meer als onversleutelde, normale e-mail kunnen worden verzonden.
  26. Klik Opslaan, klik daarna op Klaar.

Aanvullende vereiste instellingen

Schakel Inbound Direct Delivery in

Inbound Direct Delivery (IDD) zorgt ervoor dat gebruikers inkomende Zivver-berichten direct kunnen lezen in plaats van in het Zivver zijpaneel. Volg de procedure in de Inbound Direct Delivery handleiding om deze functionaliteit in te schakelen.

Sta cookies to in Edge/Chrome

Sta cookies toe in de browser voor deze exacte URL’s. Lees meer over CookiesAllowedForUrls in Edge (deze instelling werkt hetzelfde in Chrome).

  • [*.]office.com
  • [*.]office365.com
  • [*.]zivver.com
    De Zivver-add-in slaat de actieve sessie van een gebruiker op in LocalStorage. Het blokkeren van cookies voor deze domeinen zal ervoor zorgen dat gebruikers na elke paginavernieuwing opnieuw moeten inloggen

Sta pop-ups toe in Edge/Chrome

Sta pop-ups toe in de browser voor deze exacte URL’s. Lees meer over PopupsAllowedForUrls in Edge (deze instelling werkt hetzelfde in Chrome).

  • [*.]office.com
  • [*.]office365.com
  • [*.]zivver.com
    De Zivver-add-in maakt gebruik van pop-ups om gebruikers in te loggen. Het blokkeren van pop-ups voor deze domeinen zal voorkomen dat gebruikers zich kunnen aanmelden bij Zivver

Configureer interne domeinen

Configureer interne domeinen om deze domeinen uit te zonderen van Smart Classification.

Add-in gedrag

Stel Automatisch Zivver gebruiken wanneer een bedrijfsregel dit aanbeveelt in op Aan, afgedwongen in de Add-in instellingen pagina. Lees meer over de Outlook Web Access Add-in instellingen.

Vertrouwde websites in Internet Opties

Alleen voor Windows-gebruikers.

Voeg de volgende locaties toe aan de Vertrouwde websites zone van Internet Opties. Dit voorkomt een wit scherm tijdens het inloggen in de OWA add-in.

  1. Open configuratiescherm.
  2. Klik Netwerk en internet.
  3. Klik Internetopties.
  4. Klik het tabblad Beveiliging.
  5. Klik Vertrouwde websites.
  6. Klik de knop Websites.
  7. Voeg onderstaande URL’s toe als vertrouwde websites:
    • Zivver OWA add-in: https://owa-v6.zivver.com/
    • Zivver WebApp: https://app.zivver.com
    • OWA: https://outlook.office.com
  8. Klik sluiten.
  9. Klik OK.

MacOS Safari privacy instellingen

Alleen voor MacOS Safari-gebruikers.

  1. Bij Instellingen > Privacy zorg dat “Voorkom cross-sitetracking” is uitgeschakeld.
  2. Bij Instellingen > Privacy zorg dat “Blokkeer alle cookies” is uitgeschakeld.
  3. Bij Websites > Pop-up schermen zorg dat “outlook.office.com” is toegestaan.

Controleer of de installatie gelukt is

Het kan tot 24 uur duren voordat alle veranderingen actief zijn in Exchange Online. Als je niet binnen 24 uur kunt checken of alles goed werkt, probeer het dan de volgende dag opnieuw.
  1. Klik op Nieuw om een nieuw bericht te maken.
  2. Maak een bericht zoals je gewend bent met een ontvanger, onderwerp en tekst.
  3. Klik op de drie puntjes in de Outlook-werkbalk bovenin je scherm.
  4. Klik op de Zivver-link in het menu.
    Het Zivver zijpaneel opent aan de rechterkant.
  5. Log in op Zivver als je nog niet automatisch bent ingelogd.
  6. Zet Veilige mail aan.
  7. Klik op Ontvangerverificatie.
    Een nieuw scherm verschijnt met een lijst van alle ontvangers.
  8. Vul waar nodig de ontvangerverificatie in.
    Leer meer over Ontvangerverificatie
  9. Klik op Toepassen.
  10. Klik op Verzenden om het bericht te sturen.
    Er kan een Zivver pop-up verschijnen om de e-mail en bijlagen te checken op gevoelige info.
  11. Check in de inbox van de ontvangers of er een Zivver bericht is ontvangen en geen onversleutelde, normale e-mail.
    Je hebt nu gecontroleerd of de installatie gelukt is.
Stuur ook een onversleutelde, normale e-mail om te checken of de normale e-mailstroom ook goed werkt.

Verwijder de Zivver OWA-add-in uit het Microsoft 365 admin center

Als je de Zivver-add-in wilt verwijderen, volg dan deze stappen:

  1. Log in op het Microsoft 365 admin center.
  2. Kies Zivver.
    Het Zivver invoegtoepassing scherm verschijnt aan de rechterkant.
  3. Scroll naar beneden en klik helemaal onderaan op Invoegtoepassing verwijderen.
  4. Bevestig door op Verwijderen te klikken.
    De Zivver OWA-add-in is nu weg.

Verwijder de Zivver Exchange-regel

Doe het volgende om de Zivver Exchange-regel te verwijderen:

  1. Log in op het Exchange admin center.
  2. Klik links op e-mailstroom.
  3. Ga naar het tabblad Regels.
  4. Kies de mail flow regel zivver-action:discard.
  5. Verwijder de regel delete .

Verwijder OWA Assisted Mail Submission

  1. Neem contact op met support@zivver.com om OWA AMS uit te schakelen voor jouw organisatie
  2. Ga naar https://admin.exchange.microsoft.com/#/transportrules en verwijder de mail flow regel “Zivver Plugin Assisted Mail Submission”
  3. Ga naar https://admin.exchange.microsoft.com/#/connectors en verwijder de Send Connector voor Zivver