Skip to main content

Authenticate your organization calendar with a Microsoft account

  • Updated

This article describes the conditions and steps to successully registrer the Rooms Overview app within your Microsoft tenant. A proper configuration is required for Airtame screens to properly display calendar events via the Room Calendar feature or under the Room Overview signage app.

Required permissions for the Rooms Overview

We require a multiple permissions to be able to fetch and display calendar events in the Room Overview app or in the Room Calendar section of the panel panel.

Azure AD permissions fall into two main categories:

  1. Delegated permissions – Require user sign-in and can be granted at the user level unless elevated privileges are needed.
  2. Application permissions – Do not require user sign-in but operate on behalf of the app, often requiring admin consent.
Permission Purpose Admin Consent?
Calendars.Read Read user’s calendar events ❌ No
Calendars.Read.Shared Read shared calendars ❌ No
Calendars.ReadBasic Read basic event details ❌ No
Place.Read.All Read room & workspace details ✅ Yes
User.Read.All Read all users' full profiles ✅ Yes
User.ReadBasic.All Read all users' basic profiles ✅ Yes
profile Read signed-in user’s profile ❌ No
openid OpenID authentication ❌ No
email Read signed-in user’s email ❌ No

For the integration to work properly within your environment, it is important to ensure that all these permissions are granted.

Recommendations for initial configuration

Step 1: Properly authorize the Rooms Overview application into your Microsoft Entra directory

  1. Log in to your Airtame Cloud organization, an administrator role is needed for this.
  2. Navigate to the Organization settings
  3. Go to Calendar connection
  4. Under Microsoft 365 Calendar, click Sign in with Microsoft
  5. You will be prompted to enter your credentials. Make sure to sign in as an Azure Global Administrator. This will allow you to grant the appropriate permissions for the Rooms Overview application.
  6. Accept permissions to proceed and complete your connection.

MSPromptAdmin.png

Microsoft Oauth prompt for an Azure Global Administrator

Note: if, as a user, you are being blocked when trying to authenticate against this app, please refer to the following article:

Step 2: Sanity check in Microsoft Entra

  1. Log in to the Azure Portal.
  2. Navigate to Microsoft Entra, then Manage > App Registrations
  3. Locate the Rooms Overview application in the list of registered apps. If you don't see it, use the search bar to find it.
  4. Click on the Airtame app to open its settings. In the left-hand menu, navigate to Manage > API Permissions
  5. Under Configured Permissions: make sure that all permissions are granted, both Delegated and Application type of permissions

    1. If necessary, click the Grant admin consent for [YourOrganization] button on top of the list

      AzureConsole.png

Correctly configured API permissions for the Rooms Overview app in your Microsoft Entra directory

 

Step 3: Connect your Service account in Airtame Cloud

  1. Log in to your Airtame Cloud organization, an administrator role is needed for this.
  2. Navigate to the Organization settings
  3. Go to Calendar connection
  4. Click Sign in with Microsoft
    1. If your administrator account is still connected, you will need to Disconnect first.

You are now ready to select room calendars to be displayed on your Airtame screens

AuthenticationPage.png

Microsoft 365 authenticated with a service account

Additional Considerations for Microsoft 365

  • Airtame Cloud supports Office 365 accounts and not self-hosted Exchange. The user enabling Office 365 requires an Exchange Online Kiosk license
  • If the organization has more than 100 rooms, for them to all be displayed correctly in the Airtame Cloud, they need to be organized into "Room Lists".

Related articles