This article discusses how to setup Quicklaunch to use Graph API to access your enterprise calendars, email and user profile information using your own app registration. For other options, please see: https://quicklaunch.ucworkspace.com/en/support/solutions/articles/3000101635-setting-up-graph-api


CAUTION: this is an advanced setup and is not supported by UC Workspace.  Setting up Graph API using your own app registration requires a solid understanding of Azure Active Directory and Azure App Registration.  UC workspace can help with your Azure setup through our paid configuration services.




1. Prerequisites

In order to setup Quicklaunch with Graph API you will require an Azure administrator.  This is to give permissions, and set up the App registration. Setting up Graph API using your own app registration requires a solid understanding of Azure Active Directory and Azure App Registration. Caution: UC Workspace does not support custom Azure configurations for Graph API.



2. Setting Up your App Registration in Azure Portal


1. Have your administrator create an App Registration

2. It must have the following Authentication redirect URIs


3. Quicklaunch must have the following API permissions for full functionality.



    Note:

What Corporate Information Does Quicklaunch Access

Limiting Quicklaunch Graph API Calendar Access


User.Read.All permission is optional. It is used to lookup room account Display Name, All Organizer Images within the organization, autocomplete the email field in add participant and group email. Calendar settings must be turned off if not granting User.Read.All permission.
Image


User.Read and User.Read.All Permissions are optional. Delegate permissions are required for Change User and System Check-in features. Make sure to disable these features in Quicklaunch Settings if permissions are not granted.


4. And generate an App Secret. Copy the secret VALUE.





3. Setting Up Quicklaunch to use your App Registration


In the setup wizard or the Settings accounts login screen, set the Calendar Authentication to "Graph Customer Secret"

Enter the Application Registration ID and App Secret (from Azure Portal)


If you have already granted consent, enter the Tenant ID (from Azure Portal).  If you have not granted consent, leave the tenant ID blank and click on "Grant Consent to Quicklaunch"