Breadcrumbs

Microsoft Azure configuration for Miralix Calendar Import (English)

Preface

This guide is for technicians who are to install Miralix Calendar Import. The technician should have formal training as an IT Supporter or have equivalent qualifications. Furthermore, relevant knowledge of Microsoft Azure, Microsoft Office 365 and Microsoft Entra ID is required.

Miralix Calendar Import collects calendar appointments from Microsoft Office365, enabling Miralix clients to show calendar appointments for internal contacts.

GDPR


The General Data Protection Regulation (GDPR) means that customers who install Miralix software need to consider the scope and duration of data storage.

All Miralix customers are offered a data processing agreement, as Miralix generally has no obligations regarding this data storage.

Prerequisites for Miralix Calendar Import

For Miralix Calendar Import Service to work, some prerequisites must be in place:

Microsoft Entra ID App Registration

An app registration for Miralix Calendar Import must be created:
This app registration must have the following API permissions:

  • Application – Calendars.Read

  • Delegated – User.Read

  • Application – User.Read.All

This is required for Miralix Calendar Import to make extractions from Microsoft Office 365.

Creating an app registration in Microsoft Entra ID

(See the guide “Register a new application using the Azure portal » https://docs.microsoft.com/en-us/graph/auth-register-app-v2 ).

  1. Log-in to Azure Portal (https://portal.azure.com/ ) with an admin user.

See figure 1.

att_12_for_27951177.png

Figure 1

  1. Click "Microsoft Entra ID". It is possible to see and copy the tenant ID from the “Tenant information” box in the Overview. See figure 2.

Remember to choose the correct tenant (where Miralix Calendar Import should have access to). It is possible to choose another tenant by clicking “switch tenant” and then choosing the correct account.

att_8_for_27951177.png

Figure 2

  1. Click ”App registrations”, see figure 3. If "Microsoft Entra ID" is not shown, click ”more services”.

att_9_for_27951177.png

Figure 3


  1. For Miralix Calendar Import to retrieve calendar updates, a new application must be registered. Click ”new registration”, enter a name and choose the supported account types to be used.

In the example shown in figure 4, the following is selected:

Name: "Miralix Graph Calendar Import"
Supported account types: " Accounts in this organizational directory only (Miralix only - Single tenant)”

att_7_for_27951177.png

Figure 4

  1. Click “register”.

  1. It is now possible to see and copy the Client ID from ”Application (client) ID” in the Overview. See figure 5.

att_11_for_27951177.png

Figure 5

Assignment of rights to Miralix Calendar Import

Rights must be assigned to Miralix Calendar Import for it to make extractions from Microsoft Office 365.
The required rights are:

  • Application – Calendars.Read

  • Delegated – User.Read

  • Application – User.Read.All

  1. Open the App Registration that has been created for Miralix Graph Calendar Import

  2. Click ”API permissions”

  3. Click ”Add a permission” and choose "Microsoft Graph". See figure 6

att_10_for_27951177.png

Figure 6

  1. Choose "Delegated permissions", search for the User.Read right and select it. See figure 7.

att_3_for_27951177.png

Figure 7

  1. Choose ”Application permissions”, search for the User.Read.All and Calendars.Read rights and select them. See figure 8 and 9.

att_4_for_27951177.png

Figure 8

att_5_for_27951177.png

Figure 9

  1. Click ”Add permissions”.

Please note: The User.Read.All and Calendars.Read rights require "Grant admin consent for ...", for Miralix Calendar Import to use them correctly.

7Click "Grant admin consent for ..." and click ”Yes” to grant admin consent to all rights. See figure 10.

att_1_for_27951177.png

Figure 10

  1. After this, "Granted for …" will be written in front of every permission. See figure 11.

att_6_for_27951177.png

Figure 11

Create a Secret


For Miralix Calendar Import to log-in, a Client Secret for this app permission must be created.

  1. Open the app registration that has been created for Miralix Graph Calendar Import

  2. Click” Certificates & secrets”

  3. In Client secrets, click ”New client secret”

  4. Enter a description and choose an expiration date. See figure 12

image-20230621-060157.png

Figure 12

  1. Click “Add”

  1. Remember to copy the value and save it in a safe place as this Client Secret will only be shown this once.

Please note: If this Client Secret is lost, it is possible to create a new one and update the Client Secret for Calendar Sync Source in Miralix Wrench.

Miralix Calendar Import installation

The necessary prerequisites for Miralix Calendar Import have been created and therefore, the Calendar Import can be installed. Please contact Miralix in order to complete the installation.