Introduction

We are excited to announce our Zivver OWA add-in v6! With automatic login, a better user experience and reduced sending delays, this new version is a big step forward in optimizing the secure email experience in Outlook on the Web.

Upgrading to version 6 of the Zivver OWA add-in is straightforward but not automatic. This document describes the steps necessary for the upgrade.

• Introduction
• Locate the current installation of the Zivver OWA Add-in
• Change user assignment.
• Install Zivver OWA Add-in v6
• Give admin consent to the required Graph API permissions
• Internet Explorer security zone
• Migrate users from the previous Zivver OWA Add-in version to OWA Add-in v6
• Remove old Zivver OWA Add-in version
  • Previous or latest location
  • Legacy location

Locate the current installation of the Zivver OWA Add-in

Over the past years Microsoft has moved around the location of the add-in in the admin panel. The location where the Zivver OWA Add-in is installed determines the next steps to update to v6 of the Zivver OWA Add-in. Do a check on these locations to know in which of these locations the add-in is installed:

• Latest location
• Previous location
• Legacy location (go to Organization > add-ins)

Change user assignment.

We highly recommend that you test the new version with a group of users, in order to understand the new way of working and ensure that it fits your organization. If you do so, make sure to change the user assignment upfront. Select the old Zivver Add-in version and edit the user assignment. If the add-in is assigned to ‘Everyone’, change this to the specific group of users who will still work with the old version during the test period. No users should ever be assigned to both the old version and v6.

Install Zivver OWA Add-in v6

1. Log in to the Microsoft 365 admin center.
2. Click add Deploy Add-In.
3. Click Next.
4. Select Upload custom apps under Deploy a custom add-in.

5. Enter https://owa-v6.zivver.com/manifest.xml as the URL of the OWA Add-in manifest file.
   

   Make sure to include https://, even though this is already mentioned in the user interface.

6. Click Upload.
   A Configure add-in screen is shown.

7. Choose which users get assigned the Zivver OWA add-in. Select Specific users / groups to only make the add-in available for users in the beta test group.

8. Select how the add-in is deployed to users. For testing purposes, you could choose Optional, so that version v6 is enabled by default for the assigned users, but they can still disable the add-in if necessary. Otherwise, choose Mandatory.

9. Click Deploy.

10. Read the Microsoft notice and click Next.

11. Click Close.
    The Zivver OWA add-in is now installed and configured for your Office 365 organization. It may take up to 24 hours for the change to be implemented in Exchange Online. See Microsoft’s documentation for more information.

12. Continue with the steps for the admin consent

Give admin consent to the required Graph API permissions

Zivver OWA add-in requires admin consent for your organization in order to work seamlessly with the Microsoft Graph API.

Prerequisites

• Have a user mailbox with the Zivver OWA add-in deployed
  This user mailbox is required to have a Zivver account. This user mailbox is not required to admin privileges.
• Have global administrator credentials available when performing the steps below
  Either via the user mailbox that has the OWA add-in deployed or separate administrator credentials

1. Open outlook.office.com with the user mailbox that has the Zivver OWA add-in deployed
2. Open the Zivver OWA add-in by opening a new draft email and clicking the Zivver icon, or via Apps from the top ribbon and selecting Zivver from here
   The login proces should start, opening a flyout window from login.microsoftonline.com

3. If you are logged in with an administrator account, then select Consent on behalf of your organization and click Accept.
   

   If you are logged in with a user mailbox without administrator privileges, then select Have an admin account? Sign in with that account. After you have succesfully authenticated your administrator account, you can select Consent on behalf of your organization and click Accept.

Internet Explorer security zone

For Windows users only.

Add these locations to the Trusted sites zone of Internet Explorer. This prevents a white screen during logging into the OWA add-in.

1. Open the control panel.
2. Click Network and Internet.
3. Click Internet Options.
4. Click the Security tab.
5. Click Trusted websites.
6. Click the Websites button.
7. Add these URLs as trusted websites:
   • Zivver OWA v6 add-in: https://owa-v6.zivver.com
   • Zivver web app: https://app.zivver.com
   • OWA: https://outlook.office.com
8. Click Close.
9. Click OK.

Migrate users from the previous Zivver OWA Add-in version to OWA Add-in v6

If the tests succeed and OWA v6 is working well in your organization, you can start migrating users from the old version to v6. To do so, do these instructions:

1. Remove the to be migrated user(s) assignment from the old Zivver OWA Add-in version.
2. Assign the user(s) to the Zivver OWA Add-in v6.

Remove old Zivver OWA Add-in version

When all users have been assigned to v6 and 24 hours have passed, the old version of the add-in can safely be removed.

Previous or latest location

To remove Zivver OWA Add-in if it was installed at the previous or latest location:

1. Click Zivver.
2. Make sure the selected add-in is the old version
3. Click Remove add-in.
4. Click Remove.
5. Refresh the page.
6. Check that the Zivver OWA Add-in was indeed removed from the list.

Legacy location

To remove Zivver OWA Add-in if it was installed at the legacy location:

1. Double-click Zivver.
2. Make sure the selected add-in is the old version.
3. Click Cancel.
4. Click the trashcan icon.
5. Click Yes.