Howto15r1:Configure Calendar Presence Sync by Connector for Microsoft365

Applies To

This information applies to Connector for Microsoft 365 from version 15r1

More Information

This article outlines a configuration scheme for Connector for Microsoft365 functionality.
In preparation, you first will need to configure one Application in your Azure Portal.
After that, you will install the App in your Application Platform, and configure everything.

System Requirements

• Licenses innovaphone Connector for Microsoft 365 per user who wants to use the innovaphone myApps Connector for Microsoft 365.
• account in Azure Portal of Microsoft (for each of the technical communication users, no permission role needed)
  
• Must have access from the internet to your App Platform
  • This can be done by using a reverse proxy or other firewall
• The public endpoint must have a valid, public signed certificate (in order to make a trusted SSL connection from the Azure cloud to the Application Platform possible)
  • A valid certificate is required in all involved network entities - at least in the App Platform and if used in the Reverse Proxy; to ensure transmission of MS365 HTTPS POST requests to the app service in order to send notifications.
• Admin account for Azure Portal (only necessary for granting needed permission for registered app during setup)

Installation

Configuration in Azure Portal

Create an App for syncing Calendar Events from Teams to PBX

• In the Azure Portal of Microsoft you have to add an app registration
• You only have to give a name for the app

App Registration

• Switch to Certificates & Secrets on the left
• You only have to configure a client secret and save the value for the configuration of the app

• Switch to api permissions on the left
• You have to configure application permission (Calendars.Read) and (User.Read.All) as shown in the picture
• Grant access to the api permissions, if not possible you have to ask an admin

Installing and configuring App Platform and PBX

Installing the connector app

• First you need to install the connector app from the App Store:

• Install the app by selecting

1. All apps
2. innovaphone AG
3. innovaphone myApps Connector for Microsoft 365
4. select the current Version
5. Click install

Creating an instance for the connector app

• For creating an Instance, in the AP Manager you need to

1. select innovaphone myApps Connector for Microsoft 365
2. click add

• Insert the following information and save

1. The technical Instance Name (we suggest microsoft365)
2. Your Domain (This should be the domain you have already configured in your PBX and your Application Platform)
3. define a password for the communication between the PBX and the app instance
4. define a password for the communication between the app instance and the database

All other fields should be filled automatically

Creating the PBX app object using the PBX Manager Plugin

• Open the PBX Manager and

1. select the AP InstanceName Tile
2. Click Add an app

• Specify the Name and the SIP (We suggest using microsoft365 for this technical names)

Add the admin app to a user or a template

To be able to configure the connector app, you need users to have access to the admin app.
You can achieve this by adding the app to a user, or to a template.
In this Howto - as an example - we will add the app to the Config Admin template.

• In the PBX Manager

1. select the Templates tile
2. click on the Config Admin template

• In the Config Admin template

1. open Apps
2. Check the app name checkbox
3. Save the changes

Configure the connector with the admin app

Now your admins (designated groups or configured user) should have access to the connector admin app.

• A user with access to the app can now see a new tile in the All Apps area
• The name depends on the configured app name from the PBX Manager plugin

Synchronization from the Teams to PBX

• For the calendar synchronization you select from Teams to PBX for Calendar Presence in the admin app

1. ClientIDCalendar - Please insert the Application ID (Client ID) from Azure Portal from the in preparation created Calendar app
2. TenantCalendar - Please insert the Directory ID (Tenant) from Azure Portal from the in preparation created Calendar app
3. ClientSecretCalendar - Please insert the shared secret from the in preparation created Calendar app
4. NotificationURLCalendar - You need to specify the address Microsoft can send presence updates to
   1. You need to make sure that you define a URL where you can reach your App Platform from the public internet public.dns
   2. Next you need the domain you have configured in the app instance before (3.2.2) your.domain
   3. Next you need the name of the instance you have configured before (3.2.2) microsoft365
   4. The URL will always be terminated by subscriptions
      • https://public.dns/your.domain/microsoft365/subscriptions

Related Articles

Concept App Service Connector for Microsoft 365
Howto15r1:Configure User Presence Sync by Connector for Microsoft365