Using Microsoft 365

Warning

Prerequisites for Exchange Online Integration:

If you plan to integrate SOPS with Exchange Online, please do not add your Hubs or Displays to the system yet.

You must first configure a valid public domain name and install a valid SSL certificate (issued by a trusted third-party authority) on the SOPS Web Portal.

Navigate to https://<SOPS-LAN-IP>/settings/security to configure the domain and enable HTTPS.

Summary

To integrate Office 365 with SyncSign On-Premise Server (SOPS), please follow the steps below:

  1. Register and Configure Application

  2. Setup the SOPS to Access the API

  3. Calendar Integration on the SOPS

Register and Configure Application

Attention

User Interface Notice: This guide primarily uses the Microsoft Entra admin center for instructions, but you can also find similar functionality in the Azure Portal.

App Registration

  • Register a new application using the Microsoft Entra admin center

    1. Sign in to the Microsoft Entra admin center or Azure portal using an Administrator account.

    2. Find “App registrations” on the home page. If you cannot find it, you can search for “App registrations” in the search bar.

    ../_images/azure1.png ../_images/azure2.png

    1. Enter the following information for the new application:

      • Name - Enter a meaningful application name that will be displayed to users of the app.

      • Supported account types - Select which accounts you would like your application to support. Either “Single tenant” or “Multitenant” is OK if you are signing in with the admin account of your organization.

      • Redirect URI - Select the type of app you’re building as Web , and then enter the redirect/reply URI for your application. Please use https://<Your-SOPS-Domain>/m. Incorrect URI may lead to AADSTS50011 error while linking Office 365 account to SyncSign.

    ../_images/azure3.png

    1. When finished, select Register.

Configure Authentication

  1. Find the App you just created. Under “Authentication”, select the “Supported account types” based on your deployment needs (Single-tenant for internal use or Multitenant for external access), enable implicit grant flows for both Access and ID tokens, and click “Save”.

../_images/azure4.png

Configure Permissions

  1. Grant administrative consent for the “Calendars.Read” and “User.Read.All” application permissions to enable organization-wide read access for the application.

../_images/azure5.png

Generate Credentials

  1. Create a new client secret and capture the string from the “Value” column to serve as the application password for authentication.

../_images/azure6.png

Note

It is recommended to set a long expiration period for the Client Secret to prevent any disruption to the calendar integration caused by secret expiration.

Note

Please mark down the Client Secret on this page, as you may need it to configure the SOPS later.

Setup the SOPS to Access the API

Before accessing the SOPS web portal, please go to the Microsoft Entra admin center and locate the App you just registered. In the App Overview, find the “Application (client) ID” and copy it.

../_images/azure7.png

  • The next step is to enable the SOPS to use your Office 365 developer account

    1. Go to https://<Your-SOPS-Domain>/m, click The navigation bar > Settings > Integration > Settings > Office 365 > Edit.

    2. Fill in the Client Id and Client Secret obtained when registering Office 365 App, and hit [ Save ].

Calendar Integration on the SOPS

  • The last step is to connect to your Office 365 account and access the calendars

    1. Go to https://<Your-SOPS-Domain>/m, Click The navigation bar > Settings > Integration > Office 365 > Connect.

    2. The page will redirect to the Office 365 Login page. Please enter your Office 365 account and complete the login. SOPS will connect to your Office 365 Service through this account.

    3. Now you can connect your displays to calendar resources of Office 365.

Note

Please refer to the instruction Use Office 365 with SyncSign’s global administrator authorization method (Cloud-based Office 365 Integration).