Installation manual for Microsoft 365

Read this article in: Deutsch, Français, Dutch

This document shows how you can install the SoSafe Phishing Report Button add-in for Outlook if you use Microsoft 365.  

Requirements

One of the following environments is required:

• Microsoft 365 for Business / Microsoft 365 for Education

• Exchange Server 2016 (only Hybrid), Version 15.1.544.27 (CU3) or later version

To install the Phishing Report Button you need a manifest file. This can be downloaded in the SoSafe Manager. Navigate to Phishing Report Button / Microsoft integrations. Select your environment and select Save to confirm. Then, select Download manifest file. Alternatively, you can select Copy URL and then use said URL later.

The centralized deployment of add-ins should be enabled. Further details are available on this Microsoft page. 

After the installation is complete the button can be used in the following mail clients: 

• Outlook 2016 (or higher) for Windows

• Outlook 2016 (or higher) for Mac

• Outlook on the Web (for Exchange 2016 or higher and Microsoft 365 )

• Outlook for iOS

• Outlook for Android

Outlook 2013 is no longer supported.

Note: Microsoft limits shared mailbox compatibility. For details on supported environments, see https://support.sosafe.de/ADOC/outlook-shared-folder-mailbox-compatibility

Installation

1. Log in to your Microsoft 365 admin center and select Admin. In the left sidebar select Settings (1), followed by Integrated Apps (2).
   

   

2. Select Upload custom apps.
   

   

3. First, make sure that App type is set to Office Add-in. Now you have 2 options for providing the manifest file.

   1. You can select Upload manifest file (.xml) from device (1) and then Choose File (2). In the new dialog window that opens, select the manifest file you downloaded in the Manager and confirm.

   2. Alternatively, you can select Provide link to manifest file and paste the link provided earlier. Select Validate to confirm.
      

      

4. Select Next to proceed. The system will briefly validate the file or link. In case of errors, make sure you selected the correct file and/or download the file again in the Manager. If you chose to provide a URL, copy it again and paste it in the text box without any additional inputs such as spaces.
   

   

5. Select Entire organization to roll out the PRB across your entire company. Select Next to proceed.
   

   

6. You should now see the following message:
   

   

   
   
   Select Next and in the following screen Finish deployment. Wait until the installation is completed and select Done.

Note: After the aforementioned steps, the add-in will be provisioned within the next 24 hours. It is best to log off right away from your Microsoft account and log back in. Check if you can find the add-in as mentioned below. Should that not be the case, check again after 24 hours. 

Uninstall

If you no longer want to use the button, you can uninstall it with three easy steps. 

1. Log on to your Microsoft 365 admin center and select Admin. Select Settings, followed by Integrated Apps. In this list, select SoSafe Phishing-Reporting. A new menu will open to the right.
   

   

2. Select Remove app.
   

   

3. Select Yes, I'm sure I want to remove the app and associated data, followed by Remove (2).