Microsoft 365 GCC Integration with Humly Control Panel
This document will guide IT administrators through the specific configurations required to successfully integrate Humly Control Panel with Microsoft 365 Government environments, including GCC, GCC High, and DoD. These environments use separate, secure infrastructure and require distinct endpoints for authentication and API access.
Configuration Steps for Microsoft 365 Government Cloud:
Organizations using Microsoft 365 Government Cloud (GCC, GCC High, or DoD) must use specific service endpoints when connecting the Humly Control Panel (HCP) to Microsoft’s APIs. This is due to the isolated infrastructure of these environments, which differ from the public (commercial) Microsoft 365 cloud. Follow the steps below.
Step 1: Prepare the Server Environment:
Ensure that the Humly Control Panel is installed on a supported server. If it's a new installation, perform a clean setup using the latest HCP version.
Step 2: Create the env.json File
You will need to create a configuration file named env.json and place it in the following directory on your server as seen in the screenshot below C:\Program Files\Humly\ControlPanel\application_data
This JSON file must include the correct API endpoints for your government cloud environment. Below is an example configuration for Microsoft 365 GCC:
{
"EWS_URL": "https://outlook.office365.us/ews/exchange.asmx",
"OAUTH_LOGIN_URL": "https://login.microsoftonline.us",
"OAUTH_RESOURCE_URL": "https://outlook.office365.us",
"OAUTH_SCOPE": "https://outlook.office365.us/.default",
"AZURE_GRAPH_URL": "https://graph.microsoft.us/v1.0/me"
}
Note: URLs may differ depending on whether your tenant is in GCC, GCC High, or DoD. Refer to Microsoft’s documentation on Graph API national cloud deployments
PowerShell Test Samples for Government Tenants (Microsoft GitHub):
GitHub – Graph API PowerShell Samples for GCC/GCC High/DoD
Step 3: Restart the Humly Services:
After saving the JSON file, restart the Humly Control Panel services in the server to apply the new configuration. Go to services > HCP Service > Restart
You are now done with this part of the configuration. If you have not prepared the booking system, please follow this guide to set up your booking system.
Booking system preparation Microsoft Graph
If you already configured the booking system, please follow this guideline to connect the booking system to the Humly Control Panel.
Connect Humly Control Panel to the Booking system