Online Help | Web App

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:

  1. Obtain Tenant ID and Client ID from Microsoft Entra ID (Azure AD)

  2. Enable the integration in Alloy Navigator Express

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:

  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 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.

  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 Express Admin Center, go to Services and Integrations > Integration with Microsoft 365.

  2. Select the Enable integration with Microsoft 365 checkbox.

  3. Provide your Tenant ID and Client ID.

  4. Click Save.