You are viewing an earlier version of the admin guide. For the latest version, please visit EmpowerID Admin Guide v7.211.0.0.
Configure Exchange Online App Service Authentication
The Exchange Online microservice interfaces with EmpowerID and Azure to execute Azure AD operations in response to your actions in EmpowerID. For this to occur, the App Service hosting the microservice needs to be configured so that it can authenticate to Azure AD and receive identity and access tokens with the necessary permissions to call the relevant Graph API endpoints on your behalf.
To configure the App Service for authentication involves the following:
App Service authentication must be turned on and Login with Azure Active Directory must be enabled
Azure Active Directory must be selected as the Identity Provider
Information about the application (service principal) you registered in Azure AD must be added to the App Service
A system assigned managed identity must be created for the App Service in Azure AD so that the needed permissions can be granted to the microservice
Configure the App Service
Log in to your Azure portal as a user with the necessary permissions to configure the Exchange Online App service you created earlier.
In Azure, navigate to the App Service.
Under Settings in the sidebar, select Authentication / Authorization.
Turn on App Service Authentication.
Under Action to take when request is not authenticated, select Log in with Azure Active Directory.
Under Authentication Providers, click Azure Active Directory.
Under Management mode, select Advanced.
Enter the following information for the Advanced mode settings:
Client ID — Enter the Client ID for the service principal you registered earlier for EmpowerID.
Issuer Url — Enter https://login.microsoftonline.com/<TenantID>, where <TenantID> is the TenantID of the application you registered in Azure AD for EmpowerID.
Client Secret — Enter the client secret for the application you registered in Azure AD for EmpowerID.
Allowed Token Audience — Enter the App Service URL.
The settings should look similar to the below image:
Click OK to close the Active Directory Authentication dialog.
Back in the main Authentication / Authorization blade, click Save.
Under Settings, select Identity.
Turn on system assigned managed identity and click Save.
Click Yes to confirm that you want to enable system assigned managed identity.
Back in the Overview page for the App Service, click Get Publish Profile. You will need this file when you publish the Exchange Online Microservice to Azure.