Skip to main content

 

Eptura Knowledge Center

Authenticate a meeting room screen for OAuth

  1. Last updated
  2. Save as PDF

OAuth can be enabled either from the Device Hub or directly from the screens.

Enable OAuth for screens from the Device Hub

Follow the steps below to authenticate a room screen using the Device Hub.

  1. Sign in to the Eptura Device Hub.
  2. Click the Device Management icon in the left icon bar (top).
  3. Select Rooms & Screens to display a list of your room screens.
    dh oauth 02.png
  4. The authentication status for each screen is displayed in the Authentication column:

Green tick: The screen is activated and OAuth is authenticated.
Check Status: The screen is activated but OAuth is not yet authenticated. Click Check Status to check the status and authenticate.
Not applicable: The screen is not activated. Click Activate to activate the screen. When activated, the Authentication column will show 'Check Status'.
Authenticate: The screen is not authenticated. Click Authenticate to authenticate the screen.

  1. Depending on the screen status, click either Check Status or Authenticate to start the process. 'Check Status' checks the status of the authentication before displaying the 'Authenticate' option.
  2. When authentication has started, the Authenticate pop-up window is displayed; you will need both the email address and code displayed on this screen for the next steps. Click the URL to open a new browser window.
    dh oauth 05.png
  3. When prompted in the new browser window, enter the code displayed on the Authenticate pop-up window, and click Next.
    ms-enter-code.png

The code is valid for 15 minutes. If authentication is not completed within this time, a timeout error is displayed.

  1. Enter the mailbox email address displayed on the Authenticate pop-up window, and click Next.
    image-20210218-143049_v1.png
  1. Enter the Password for the calendar mailbox and click Sign in.
    image-20210218-143448.png
  1. If prompted to agree access, review the requested permissions then tick Consent on behalf of your organization. Click Accept to provide the required access to the room calendar. By clicking ‘Accept’ you are agreeing that the Exchange Web Service can access the mailbox, sign in as the mailbox, and read its profile. To learn more, click ‘Terms of Service’ in the Permissions window.
    ms-permissions_v1.png
  1. When Microsoft confirms you have successfully signed in to the OAuth application, close the Microsoft window.
    image-20210218-143816_v1.png
  1. When a successful authentication is confirmed, click close this window.
    dh oauth 06.png

The Rooms & Screens list now displays a green tick in the Authentication column for the room screen.

Congratulations! OAuth is now enabled for your room screen.

Authenticate OAuth directly from the room screen

Prerequisites

To authenticate OAuth directly from the screen, you need:

  • Security PIN for the meeting room screen to open the Admin menu.
  • Microsoft 365 calendar URL and email address.
  • A laptop/device with internet access.

How is it done?

These steps apply to the following device types:

  • Eptura (Condeco) Room Screen v2
  • Eptura Room Screen v3
  • Third-party device running the Eptura Room Screen app (follow the steps for the Eptura Room Screen v3)

Follow the steps below to authenticate directly from the room screen.

  1. Hold your finger at the top right of the screen until you are prompted for the screen security PIN. Learn more: v2 Admin menu | v3 Admin menu | Eptura room screen app Admin menu
  2. Enter the PIN to display the Admin menu then tap Calendar to open the Calendar Settings. 
  3. Click Authenticate using OAuth.
    room-screen-1-not-authenticated.png
    Eptura (Condeco) Room Screen v2     		 v3 cal 03.png
    Eptura Room Screen v3 and third-party devices running the Eptura Room Screen app
  4. A URL and code are displayed. Note: the code is valid for 15 minutes - if authentication is not completed within this time, a timeout error is displayed.
    room-screen-2-pending.png
    Eptura (Condeco) Room Screen v2     		 v3 cal 02.png
    Eptura Room Screen v3 and third-party devices running the Eptura Room Screen app
  5. Open a web browser on your laptop/device and enter the URL displayed on the screen. Enter the Code displayed on the screen when prompted and click Next.
    ms-enter-code.png
  6. Enter the Email address for the calendar displayed on the screen and click Next.
    image-20210218-143049_v1.png
  7. Enter the Password for the calendar mailbox and click Sign in.
    image-20210218-143448.png
  1. If prompted, tick Consent and click Accept to provide the required access to the room calendar. By clicking ‘Accept’ you are agreeing the Exchange Web Service can access the mailbox, and sign in as the mailbox and read its profile. To learn more click ‘Terms of Service’ in the Permissions window.
    ms-permissions_v1.png
  1. When Microsoft confirms you have signed in to the OAuth application, close the Microsoft window.
    image-20210218-143816_v1.png
  1. When successful, the authentication status on the screen displays Authenticated.
    room-screen-3-authenticated.png
    Eptura (Condeco) Room Screen v2    		 v3 cal 01.png
    Eptura Room Screen v3 and third-party devices running the Eptura Room Screen app

Congratulations! OAuth is now enabled for your screen.