Skip to content
  • There are no suggestions because the search field is empty.

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