Explorezel Azure App Registration Guide
OVERVIEW
To use Explorezel you are required to register the application on Azure Active Directory. The application will be used to acquire an access token to make web API requests to access certain Microsoft resources for a tenant (organisation). The app is registered via the Azure Web portal
APP REGISTRATION
-
Sign in to the Azure web portal using the link below https://azure.microsoft.com/en-gb/features/azure-portal/
-
Once signed in, click on Azure Active Directory

-
Click on App Registrations from the left menu

-
Click on the New registration button
-
Enter Explorezel into the name input field

-
Under Supported account types section enabled Accounts in this organizational directory option

-
Click on the Register button
AUTHENTICATION
-
Click AUTHENTICATION

-
Under Platform configurations click Add a platform

-
Click Single-page application

-
For the Redirect URI field, type in the domain base URL configured for Explorezel followed by /Explorezel/
NoteThe URI is case-sensitive, the route must match exactly the pattern below where the only variable that needs to be replaced is the domain. Please include the trailing slash in the URL. Example: https://[domain]/Explorezel/

-
Click on the Configure button
GRANTING API PERMISSION
The application will require various API permissions, please follow the steps below to add the required permission for Explorezel.
-
Click on API permissions option from the left menu

-
Click on the Add Permissions button
-
When the right-hand permission panel appears, click on Microsoft Graph (This will be at the very top)

-
Click on Delegated permission

-
Using the select permission window, add the following permissions to the application
-
Files.ReadWrite.All
-
Sites.Read.All

-
Scroll down to the bottom of the panel and click on the** Add Permission** button
-
An Azure administrator will need to grant permission for the application to access the resources by clicking on the Grant Permission button
-
Once granted the status will update to Green, indicating the permission has been successfully granted
NoteDo not remove the default user.read delegated permission
NoteNote if users are still receiving the below message upon the first login then an Azure Administrator will need to complete the first login and grant consent from the Microsoft login pop-up instead.

AZURE PERMISSIONS USAGE
| NAME | TYPE | DESCRIPTION | CONSENT REQUIRED | USAGE |
|---|---|---|---|---|
| Sites.Read.All | Delegated | Read items in all site collections | Yes | This permission is used to find documents across all sites in the tenant |
| Files.ReadWrite.All | Delegated | Read and write files in all site collections | Yes | This permission is required to query all documents across the tenant as well as edit and check-in documents via Explorezel |
NAVIGATING AZURE WEB PORTAL
HOW TO GET THE APPLICATION ID
Please follow the steps below to retrieve the application ID on the Azure portal. This is required for the installation.
-
Once signed in to the Azure portal click on the Azure Active Directory button

-
Click on the App registrations option
-
Click on the required application (Explorezel created previously)
-
Click on Overview

-
Copy the Application (client) ID to the clipboard (you will need this value for the MSI)

HOW TO GET THE TENANT INFORMATION
Please follow the steps below to retrieve the Tenant ID and Tenant Name on the Azure portal. This is required for the installation.
-
Once signed in to the Azure portal click on Azure Active Directory

-
Click on Overview
-
The Tenant ID can be found under the Tenant ID section and the Tenant Name can be found under the Primary Domain Section

VALUES REQUIRED FOR INSTALLATION
The following values will be required for the installation of Explorezel. Please ensure that the person responsible for the installation has these values.
- Redirect URI
- Application ID
- Tenant ID
| Name | Description |
|---|---|
| Redirect URI | The URI where Azure will send the authentication payload upon successful authentication. Please refer to the Redirect URI section to acquire the redirect URI. |
| Application ID | Application ID of the registered Explorezel application. Please refer to the HOW TO GET THE APPLICATION ID section for further info. |
| Tenant ID | The organization tenant's unique identifier on Azure Portal. Please refer to HOW TO GET THE TENANT INFORMATION section for further info. |
REGISTERING CM LAUNCHER ON AZURE
Like Explorezel, it is necessary to register the CM Launcher on Azure. This is required for real-time document synchronization when editing a document natively. Please refer to the dedicated CM Launcher Guide for further details.
