Configuring integration with Microsoft 365

Introduced in 2025

To enable users to securely sync their Outlook calendars with My Calendar in Alloy Navigator, you must enable and configure integration with Microsoft 365 (formerly Office 365). This integration ensures seamless calendar sync between Alloy Navigator and users' Outlook accounts, allowing for unified scheduling and visibility. This article guides you through the setup process, first in Microsoft Azure portal, and then in Alloy Navigator, including how to obtain the necessary Tenant ID and Client ID for the integration.

How it works

Once technicians add their Outlook calendar to My Calendar and sign in with their Microsoft 365 account, their Outlook events automatically appear in My Calendar and stay in sync.

Behind the scenes, Alloy Navigator uses secure credentials the administrator provides during initial setup to access Microsoft 365 through Microsoft Graph, a unified API that provides secure access to Microsoft services like Outlook, Teams, and OneDrive. This allows Alloy Navigator to retrieve users' Outlook calendar data securely and keep it in sync.

To enable this, follow these steps:

1. Register your integration in Microsoft Entra ID (Azure AD)

2. Enable the integration in Alloy Navigator

Register your app in Microsoft Entra ID (Azure AD) for Outlook calendar access

To set up the integration, you need to register your integration in Microsoft Entra ID (formerly Azure Active Directory) to obtain the Application (client) ID and Directory (tenant) ID required for calendar access.

To register your app for Outlook calendar integration:

1. Sign in to the Azure portal.

2. Go to Microsoft Entra ID > App registrations > New registration.

3. Enter a name for your app (e.g., Alloy Calendar Integration).

4. Under Redirect URI, select Single-page application, and enter the root URL of your Alloy Navigator Web App.

   For example:

   • Your Web App URL: https://example.com/wp/

   • Redirect URI: https://example.com

   This root site address is required for handling calendar authentication responses.

5. Complete the registration and save the Application (client) ID and Directory (tenant) ID. You will need these in the final step.

To allow the app to read calendar data:

1. In the Azure portal, open Microsoft Entra ID, then App registrations, and select your registered app.

2. Navigate to API permissions on the left menu.

3. Click Add a permission, then choose Microsoft Graph.

4. Select Delegated permissions.

5. Search for and add Calendars.Read. This permission allows the app to read users' Outlook calendar events.

6. Click Add permissions to save.

After these steps, your app will have the necessary permissions to access users' calendars through Microsoft Graph.

INFO: The above steps cover registering a single-tenant application in a standard configuration. For detailed guidance on other scenarios such as multi-tenant apps, certificate-based authentication, and more, see Register an application in Microsoft Entra ID by Microsoft.

Enable the integration and provide Tenant ID and Client ID

Once you have the required IDs:

1. In Alloy Navigator Admin Center, go to Services and Integrations > Integration with Microsoft 365.

2. Select the Enable integration with Microsoft 365 checkbox.

3. Provide your credentials obtained in Microsoft Entra ID (Azure AD):

   • Tenant ID: The Directory (tenant) ID that identifies your organization in Microsoft 365

   • Client ID: The Application (client) ID that uniquely identifies the app registered within your organization for calendar access.

4. Click Save.

Related Information:

Adding Outlook calendar to My Calendar

Configuring My Calendar sharing