Outlook Web Access Add-in - troubleshooting

Introduction

With the Zivver Outlook Web Access Add-in, you can send secure messages from Outlook Web Access (OWA). If you are experiencing an issue with the add-in after installation, for example that the plug-in isn’t visible or that messages can not be sent, then this guide will help you troubleshoot the issue, so that it can be resolved as quickly as possible without needing to contact Zivver.

Prerequisites

For this guide, you will need the following:
- You are using a Zivver account with administrator rights. This means that you have access to the organization- or admin settings at app.zivver.com.
- Your account is a member of the Zivver organization for which your are troubleshooting SSO. This means that the account is listed in the Account Settings pane of the Zivver organization settings.
- You have administrator access to the Office 365 or Exchange environment.
- You are using at least v6 of the OWA add-in. You can check the version number by clicking the installed add-in in the Office 365 Admin Center.
- You are using Exchange Online.
- Your environment meets the other technical requirements for the OWA add-in, as described in the Zivver installation manual.

Quick fix

Only use this quick fix when the add-in is not working for any of your users. When you uninstall the add-in, it will be removed for everyone. This means that users who are currently unaffected by any problems will not be able to use Zivver anymore either. In any case, be aware that the plug-in will be temporarily unavailable after uninstalling it until it is reinstalled and deployed.

A quick way to fix different problems is to remove the existing installation of the OWA add-in, and then installing it again from scratch, as indicated in the Zivver installation manual.

It is required that you do every step in this document. This process will take about 20 minutes.

Re-installing the OWA add-in

  1. Log in to the Office 365 admin center.
  2. Remove the existing installation of the add-in from the Services and Add-ins pane.
    Do these instructions.
  3. Remove the existing mail flow rule from the Exchange admin > Mail flow screen.
  4. Install the OWA add-in again.
    Use the instruction in the Zivver installation manual.
  5. Important: Also perform all the steps under Additional required settings.
  6. Test if the problem is resolved.

Does the problem persist after the steps above? If so, read the rest of the guide to troubleshoot the issue.

Troubleshooting

This section of the guide will help you troubleshoot any problems with the OWA add-in after installation.

several problems listed below. Click the link next to the problem that is most similar to the one you are experiencing to see related causes and fixes:
- The add-in is not visible after installation. This is recognized by the fact that the Zivver icon is missing from the bottom right of the message body when you start a new message - Read this section of the guide for causes and fixes..
- The add-in does not load properly in the side pane. The side pane should appear on the right side of a message when you click the Zivver icon in the bottom right - Read this section of the guide for causes and fixes..
- Messages can not be sent - Read this section of the guide for causes and fixes..
- You get popups asking for permissions all the time - Read this section of the guide for causes and fixes..
- Messages are not sent securely, but as regular emails - Read this section of the guide for causes and fixes..
- Messages are received as both secure and regular emails - Read this section of the guide for causes and fixes..

The add-in is not visible after installation

Problem: After installation, the add-in is not visible in the mailbox of the user(s).

Causes and fixes for this problem are listed below:

The add-in is not deployed

Cause: The add-in is installed, but it is not deployed to the affected users or group.
Fix: Select the add-in under Services and Add-ins for Office 365 and make it available for the right users or groups.

The add-in is not enabled

Cause: The add-in is installed and deployed properly, but it’s not enabled within the OWA user environment. This is based on the deployment method that was selected during the installation.
Fix: Select the add-in under Services and Add-ins, and select either the ‘Fixed’ or ‘Optional’ deployment method. The add-in will now be enabled by default in the user environments.

Problem: After installation, the OWA add-in is not listed in the Services and Add-ins pane.

Cause: After installing the plug-in, it does not shows up under Add-ins and Services pane of Office 365. This is caused by a bug on Microsoft’s end in their user interface.
Fix: Waiting for a fix from Microsoft. In some cases, this can be temporarily fixed by starting the installation process again, entering the manifest URL, and then canceling the process after receiving the error that the add-in is already installed.

The add-in does not load properly in the side pane

Problem: The add-in does not load properly in the side pane after clicking the Zivver icon

Causes and fixes for this problem are listed below:

Trusted Websites are not set up

Cause: The necessary URLs have not yet been added to the Trusted Websites in Internet Options.
Fix: Add all 3 Ural’s to the Trusted Websites in Internet Options in Explorer.

Third party cookies are blocked

Cause: Third party cookies are not allowed on the user’s system.
Fix: Make sure third party cookies are allowed on the affected system.

You get popups asking for permission

Problem: When you compose a new email, you get a popup telling you need to grant (admin) permissions.

Cause: You haven’t granted permissions to use the Graph API for your organization yet. Fix: See this part of the installation manual for further instructions.

Messages can not be sent

Problem: Messages can not be sent via Zivver, because OWA hangs on Zivver is working on your request.

Description: This problem, where OWA is stuck on sending the message, occurs if you create a new message, turn on Zivver, and then hit Send. The OnSend pop-up, the final check window that should appear when you hit Send, may not appear either.
Fix: This is fixed by enabling the setting Access data from across domains in Internet Options for trusted websites.
Go to Internet Options > Security > Trusted Sites > Custom Level… > Miscellaneous and enable the setting Access data from across domains.

It’s also possible to deploy this setting with a registry value via a Group Policy - see this page for more information.

Messages are received as both secure and regular emails

Problem: A message was sent via Zivver, but also as a regular email

Cause: The mail flow rule is not set up in the Exchange admin panel. When Zivver is enabled for a message, this rule deletes the corresponding email when they are offered to the Exchange server, so that they are not also sent unencrypted.
Fix: Set up the mail flow rule within the Exchange admin panel to fix this problem. See this part of the installation manual for further instructions.

Still need help?

Could not find the information that solves your problem? Speak to Zivver support with this information:

  • Who is experiencing the problem?
    For example, all users or some specific users.
  • What are the email addresses of the affected users?
  • At what date and time did the problem occur exactly?
  • What version of the OWA add-in are you using?
  • Which browser are you using, and what version?
  • Can you replicate the problem? If so, please describe the steps that lead to the issue.
  • Tell Zivver support which steps you tried from this guide, as well as the outcome of each step.

Attach this information to a support request.
Contact support

Was this article helpful?

thumb_up thumb_down