Microsoft Integration - Calendar + Directory

This document aims to detail the whole process and the main implications of integrating a Skedway account with Microsoft Office 365

Gateway

Skedway platform uses the API Rest Microsoft Graph v1.0 to access users (read-only) accounts/groups and manipulate (read-write) resource and user calendars.

• The process is performed by the Microsoft identity platform /adminconsent endpoint. The consent link is generated in the integration setup process via Web Admin Skedway.

• Scopes and permissions are mandatory for integration completion

• The registered manager will have full control of the permissions given to the Skedway application.

• The customer has full control of Skedway application permissions, which can be revoked at any time.

Scopes

• Read all user’s basic profiles

• Read all groups

• Have full access to user calendars

• Read all users` full profiles

• Read all groups

• Read and write calendars in all mailboxes

• Read online meeting details

Application permissions

Below is a detailed list of each permission requested in the admin consent process. Some of these permissions are used when users use the platform and others are used by processes that run in background.

1. Calendars.ReadWrite - Allows the app to create, read, update, and delete events of all calendars.

2. Group.Read.All - Allows the app to list groups, and to read their properties and all group memberships.

3. User.Read.All & User.ReadBasic.All - Allows the app to list users and to read their properties.

4. OnlineMeetings.Read.All - Allows the app to read online meeting details in your organization

Tenant ID

Your Microsoft 365 tenant ID is a globally unique identifier (GUID) that is different than your organization name or domain.

Skedway only supports one TenantID, one organization per customer

Steps

Activating the Skedway Integration

1. Access the integration submenu by following these steps: Menu-ADMINISTRATION > Section- CONECTIONS > submenu-INTEGRATIONS and clicking on the NEW button, or you can click HERE to be redirect direct to de creation page (You need to be logged in to Skedway).
2. Select the desired gateway, "Microsoft 365 Exchange & Azure Active Directory". The following information and fields will be updated according to the chosen gateway.

3. Fill in the TenantID field with your Tenand. You will be able to find your tenet id more easily through the shortcut that is found below or by going to Microsoft's own documentation.

4. Save.

5. After saving, the authorization URL for the scopes that Skedway needs will be displayed. You can copy the URL or click the button to open it in a new page. You need to be logged in with your admin account so the URL already lists the permissions. If you are not, log in first and then click on the URL again.

   
6. Grant the required permissions by clicking the Accept bottom.
7. After acceptance, the user will be redirected to a Skedway screen and the system will present a message that the procedure was successful.

   

8. Done, Your integration is completed!! 🎉🎉🎉

References

Get access without a user - Microsoft GraphMicrosoftLearn

Microsoft Graph permissions reference - Microsoft GraphMicrosoftLearn

Find your Microsoft 365 tenant ID - SharePoint in Microsoft 365MicrosoftLearn

Referência do ponto de extremidade do Microsoft Graph v1.0 API REST - Microsoft Graph v1.0MicrosoftLearn

Find your Microsoft 365 tenant ID - SharePoint in Microsoft 365MicrosoftLearn