How to Pre-configure SSO domains for Office 365 add-in to Zoom App

This post was most recently updated on July 29th, 2022

Administrators of Zoom Outlook can integrate the Zoom Outlook add-in with the single sign-on URL (SSO) pre-configured in the add-in, which makes deployment a lot easier. Having preconfigured the URL for the add-in, users will automatically be prompted to use SSO to authenticate to the system when interacting with the add-in, such as clicking the Add a Zoom Meeting button or the Settings button within the add-in.

Notes:

  • In the event that you use custom manifest files, the add-in will not receive automatic updates, and you will have to manually update it with a new manifest file to receive updates.
  • It must be noted that if the add-in has a preconfigured SSO URL, it will not be able to automatically login to the add-in when it is deployed.

Prerequisites for managing SSO domains for the Outlook add-in

  • Your Zoom account has been configured with single sign-on (SSO)
  • The owner of the account or the administrator of the account

How to configure the manifest file

  1. Please download the Outlook add-in manifest file from the following link.
  2. Using a text editor, open the manifest file and begin editing it.
  3. Replace the current value in <Id>%value%</Id> with c7740fe1-f1ea-4869-9bec-fc827930b38f.
    For example if your manifest file lists the ID as <Id>a7ca6c74-33fb-43a4-a3e4-781078f0eff5</Id>, change the line to <Id>c7740fe1-f1ea-4869-9bec-fc827930b38f</Id>.
  4. There will be two lines appearing twice in the manifest which you need to find:
    <bt:Url id="messageReadTaskPaneUrl" DefaultValue="https://zoom.us/office365/schedule"/>
    <bt:Url id="functionFile" DefaultValue="https://zoom.us/office365/addzoom"/>
    <bt:Url id="phoneTaskpaneReadUrl" DefaultValue="https://zoom.us/office365/phoneread"/>
  5. Replace those lines with above, with the following lines respectively:
    <bt:Url id="messageReadTaskPaneUrl" DefaultValue="https://zoom.us/office365/schedule?login=sso&amp;domain=%ssodomain%"/>
    <bt:Url id="functionFile" DefaultValue="https://zoom.us/office365/addzoom?login=sso&amp;domain=%ssodomain%"/>
    <bt:Url id="phoneTaskpaneReadUrl" DefaultValue="https://zoom.us/office365/phoneread?login=sso&amp;domain=%ssodomain%"/>
  6. By replacing “%ssodomain%” with your domain’s name, you will be able to modify the newly added lines. Using mycompany.zoom.us as an example, instead of “%ssodomain%” you can simply replace it with “mycompany”.
  7. The file needs to be saved.

How to deploy the manifest file

  1. To access the Office 365 Admin Portal, you will need to log in.
  2. Once you have expanded the Settings section, click the Add-Ins & Services link, and then click the Configure button.
  3. To install the add-in, click the Deploy Add-in button.
  4. Click on the Next button to continue.
  5. The next step is to upload your custom apps.
  6. You will be able to select I have the manifest file (.xml) on this device by clicking the button.
  7. Please select the manifest file from the Choose File menu, and click Open.
  8. You can upload your file by clicking the upload button.
  9. Click Deploy when you have chosen the user assignments and deployment method that you wish to use.
  10. The deployment will be completed once the close button is clicked once it has been completed.

How to update the manifest file

You will need to download the latest version of the manifest file if you are using a custom manifest file and feel the need to update it. Your configuration will also need to be updated if you are using a custom manifest file. After that is complete, you will need to follow the following steps in order to update the add-in:

  1. You can find this section in the Office 365 admin center by going to the Services & add-ins menu.
  2. You can zoom in by clicking on it.
  3. To update the add-in, click the Update button.
  4. Select the location where the new manifest file should be saved.
  5. Then click the Update button.