Skip to main content

 

Eptura Knowledge Center

Enable OAuth for the calendar service

  1. Last updated
  2. Save as PDF

Before you start

If you have existing meeting room screens installed, check they are prepared for OAuth first. Learn more: How to prepare existing meeting room screens for OAuth

How to enable OAuth for your calendar service

  1. Sign in to the Device Hub.
  2. Click the Calendar Settings icon in the left icon bar.
  3. Click the Exchange calendar service to display the settings.
  4. Use a service account: Do not enable. The service account is used to run applications, automated services, virtual machine instances, and various background processes.
  5. Authentication:
    1. OAuth-Delegate: Select to allow the application to act on behalf of the signed-in user. Enter the URL for the Exchange calendar.
      ⚠️Entra ID: If using Entra ID, read/write must be enabled for MS Graph API before enabling the calendar service. 
      cal oauth 01.png
    2. OAuth app-only: Select to allow the app access to the data without requiring a signed-in user. Enter your Client ID, Tenant ID, and Client secret.
      Learn more      : Azure AD App registrations
      cal oauth 02.png
  6. Click Save.

Azure AD App Registrations

To find the Client ID, Tenant ID, and Client secret for the OAuth App, check the registered app in Azure AD or follow the steps below to register a new one.

  1. Sign in to Microsoft Azure and select Azure Active Directory from the left menu pane.
  2. Select App registrations from the left menu and then click New registration.
    azure app reg 02.png
  3. Complete the details on the Register an application screen:
    1. Name: Enter a name for the app.
    2. Supported account types: Select who will use this application or access the API.
    3. Click Register to save the new registration and display the Overview page.
      azure app reg 03.png
  4. ✏️ Make a note of the Application (client) ID and Directory (tenant) ID as you will need them when enabling OAuth App-only in the Device Hub.
    azure app reg 04.png
  5. Select API Permissions from the left menu. Click Add a permission to open the 'Request API permissions' window on the right of the screen and select Microsoft Graph.
    azure app reg 05.png
  6. Select Application permissions.
    azure app reg 06.png
  7. Enter 'calendar' in the search box to display the list of calendar permissions and tick Calendars.ReadWrite. Click Add permissions to add the permissions and return to the API Permissions screen.
    azure app reg 07.png
  8. Microsoft Graph and the selected permissions are displayed under Configured permissions. Click Grant admin consent for [app name]. 
    azure app reg 08.png
  9. Select Certificates & secrets from the left menu and click New client secret.
    azure app reg 09.png
  10. Enter a name for the new client secret and set an expiry date. 
    azure app reg 11.png
  11. ✏️ Before closing the screen, copy the secret value as it is only visible at the time of creation. 
    azure app reg 10.png

The Client ID, Tenant ID, and Client secret are required when enabling OAuth App-only for your calendar service in the Device Hub. Learn more: Enable OAuth for the calendar service

 

Next step for new meeting room screens

When OAuth authentication is enabled for your calendar service, new meeting room screens will inherit the same setting. All that is needed is for each new screen to be authenticated. Learn more: How to authenticate a meeting room screen for OAuth