This documentation page will guide you through the process of deploying the Synergy Mac Office Add-ins. Please follow the steps below to ensure a smooth installation experience.

The Office Add-ins will only work when the Synergy Agent is installed on user machines.

MacOS - Synergy Mac Agent - Installation Guide

Windows - Synergy Agent for Windows: Deployment Guide

Prerequisites

Before you start the installation process, please make sure you meet the following prerequisites:

Office365 Admin Center: Ensure that you have access to Office365 Admin Center.
Requirements for user machines
1. Synergy Agent installed
2. Requirements for each platform:
  1. Windows:
    1. Office Version: Office 2013 or later, including Office 365 subscription plans.
    2. Browser: Internet Explorer 11 or later, Microsoft Edge (latest version).
  2. Mac:
    1. Office Version: Office 2016 for Mac or later, including Office 365 subscription plans.
    2. Browser: Safari (latest version).
  3. Web:
    1. Office Version: Office on the web (formerly Office Online) or Office 365 subscription plans.
    2. Browsers:
      1. Microsoft Edge (latest version)
      2. Google Chrome (latest version)
      3. Mozilla Firefox (latest version)
      4. Apple Safari (latest version)

Installation Process

Generate Manifest for Word/Excel/PowerPoint:
1. Create a new file named manifest.xml.
2. Visit https://your.cluster.com/synergy-server/manifest-generator.html, copy the content, and paste it into the manifest.xml file.
Generate Manifest for Outlook:
1. Create a new file named outlook-manifest.xml.
2. Visit https://your.cluster.com/synergy-server/outlook-manifest-generator.html, copy the content, and paste it into the outlook-manifest.xml file.
Log in to Office 365 Admin Center:
1. Go to https://www.microsoft.com/en-ie/microsoft-365/business/office-365-administration and sign in.
2. Click on 'Admin'.
3. Navigate to 'Settings', then select 'Integrated apps'.
Upload Word/Excel/PowerPoint Add-in:
1. Click on 'Upload custom apps' under 'Deployed apps'.
2. Choose 'Office Add-in' as the App type.
3. Upload the manifest.xml file created in Step 1.
4. Click 'Next'.
5. Select the appropriate deployment targets.
6. Continue clicking 'Next' until you complete the wizard.
Upload Outlook Add-in: Repeat the steps from Step 4 (a-f) for the outlook-manifest.xml file created in Step 2.

Cluster Certificate Configuration

The bundles for the Synergy Office Plugins are hosted on a Kubernetes cluster. The user machine must trust the certificate of the server in order to be able to access the plugins. Follow the below steps to check if the certificate is trusted and to trust it if necessary.

Windows

Chrome

Open Chrome
Navigate to the cluster address: Go to https://your.cluster.address.com/synergy-server/ (replace "your.cluster.address.com" with the actual address of the Kubernetes cluster).
Check for a warning: If a warning is displayed, proceed to the next steps. If no warning is shown, the machine already trusts the certificate, and you're good to go.
Click on the ‘Not secure’ icon in the navigation bar and then ‘Certificate is not valid’:
The certificate details will be shown, click ‘Details’, then ‘Export’. Pick a location under which the certificate will be saved.
Open chrome settings, then → “Privacy and security” → “Security” → “Manage device certificates”. A new window will be shown with device certificate settings. Click on the “Trusted Root Certification Authorities” and then “Import…”.
Go through the wizard and import the file created in point 5.

MacOS

Desktop Office + Safari

Open Safari: Launch the Safari browser on the user machine (it must be Safari for this process).
Navigate to the cluster address: Go to https://your.cluster.address.com/ui (replace "your.cluster.address.com" with the actual address of the Kubernetes cluster).
Check for a warning: If a warning is displayed, proceed to the next steps. If no warning is shown, the machine already trusts the certificate, and you're good to go.
Download the certificate: Open the Terminal app on the Mac machine and run the following command to download the cluster's certificate (replace "address.to.your.cluster.without.https.com" with the actual address without "https://"):
```
sudo echo -n | openssl s_client -connect address.to.your.cluster.without.https.com:443 | sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' > /tmp/getvisibility.local.cert
```
Install the certificate: Double click on the downloaded certificate and install it in the system keychain. After that double click on the certificate and under ‘Trust’ select ‘Always Trust’
Restart Safari. Now the icon in the status bar should show a valid lock and no warning should appear.

***************************************************************************************End Of Document*********************************************************************************

Synergy Office Add-ins (MacOS & Web Plugins): Deployment Guide

Table of Contents