Configuring integration with Microsoft 365
Introduced in 2025
To enable users to securely sync their Outlook calendars with My Calendar in Alloy Navigator Express, 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 the Azure portal, and then in the Alloy Navigator Express Admin Center, including how to obtain the necessary Tenant ID and Client ID for the integration.
How it works
Alloy Navigator Express uses your Application (client) ID and Directory (tenant) ID to call Microsoft Graph, a unified API that provides secure access to Microsoft 365 services such as Outlook, and retrieve users' Outlook calendar events. Once a user adds their Outlook calendar to My Calendar and signs in to Microsoft 365, their Outlook events appear in their calendar in Alloy Navigator Express.
To enable this, follow these steps:
Obtain Tenant ID and Client ID
To set up the integration, you need your unique Tenant ID and Client ID from the Microsoft identity platform. You have two options:
-
Option 1: Use the pre-registered app
Submit a request to our Alloy Support Team to obtain Tenant ID and Client ID values for the pre-registered multi-tenant app configured by Alloy Software. Once you receive the required IDs, proceed to Enable the integration and provide Tenant ID and Client ID.
-
Option 2: Register your own app in Microsoft Entra ID (Azure AD)
If you prefer to register your own app, follow the steps below.
Register your app for Outlook calendar access
Register your integration in Microsoft Entra ID (formerly Azure Active Directory) to obtain the Tenant ID and Client ID required for calendar access.
To register your app for Outlook calendar integration:
-
Sign in to the Azure portal.
-
Go to Microsoft Entra ID > App registrations > New registration.
-
Enter a name for your app (e.g., Alloy Calendar Integration).
-
Under Redirect URI, select Single-page application, and enter the root URL of your Alloy Navigator Express 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.
- Your Web App URL:
-
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:
-
In the Azure portal, open Microsoft Entra ID, then App registrations, and select your registered app.
-
Navigate to API permissions on the left menu.
-
Click Add a permission, then choose Microsoft Graph.
-
Select Delegated permissions.
-
Search for and add Calendars.Read. This permission allows the app to read users' Outlook calendar events.
-
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:
-
In Alloy Navigator Express Admin Center, go to Services and Integrations > Integration with Microsoft 365.
-
Select the Enable integration with Microsoft 365 checkbox.
-
Provide your Tenant ID and Client ID.
-
Click Save.