Custom Domain

Unified Contacts Pro only.

Step 1: Custom Domain Creation and Assignment

If you want to create your own custom domain for your Unified Contacts App Service URL, there are two options depending on your domain provider:

Option 1: Azure App Service Domain

• Navigate to your Unified Contacts App Service

• In the left navigation bar scroll down to the "Settings" section. Click "Custom domains".

• Click "Add custom domain" (in case you have not bought an App Service Domain yet, first create one by clicking "Buy App Service domain").

• Configure the custom domain as follows:

  • Domain provider: App Service Domain

  • TLS/SSL certificate: select App Service Managed Certificate if you want to create and bind the certificate to your custom domain automatically, this certificate is managed by Azure and will be automatically renewed at no cost.

  • TLS/SSL type: SNI SSL Binding is free of cost and supported by most modern browsers.

  • App Service Domain: Choose an existing App Service Domain

  • Domain type: Subdomain

  • Subdomain: Set your preferred subdomain

• Click "Add"

By clicking on add, the custom domain and the SSL Managed Certificate will be created and bound automatically.

Option 2: Non-Azure Domain

• Navigate to your Unified Contacts App Service

• In the left navigation bar scroll down to the "Settings" section. Click "Custom domains".

• Click "Add custom domain"

• Configure the custom domain as follows:

  • Domain provider: All other domain services

  • TLS/SSL certificate: select App Service Managed Certificate if you want to create and bind the certificate to your custom domain automatically, this certificate is managed by Azure and will be automatically renewed at no cost.

  • TLS/SSL type: SNI SSL Binding is free of cost and supported by most modern browsers.

  • Domain: Set your preferred domain

  • Hostname record type: CNAME

• Register the displayed CNAME or TXT record mapping with your DNS provider. Once this is done, click "Validate".

• Click "Add" when the validation is successful.

In both cases it can take a few moments until the SSL binding with the App Service Managed Certificate is complete.

Step 2: Update Permissions

This step is only required if you are adding the custom domain after you have already deployed Unified Contacts.

The App Registrations that were created during the post-deployment step must now be updated to support the new custom domain. Therefore,

• Navigate to Azure AD, "Manage" --> "App registrations"

• Locate the two App registrations that were created during the deployment of Unified Contacts. You assigned the name in the first step of the deployment.

  
• First, click on the "admin" App registration and navigate to "Manage" --> "Authentication".

  • Under the "Redirect URLs", add your custom domain and click "Save"

    
• Next, go the the "teams" App registration and navigate to "Manage" --> "Authentication".

  • Under the "Redirect URLs", add your custom domain and click "Save"

    
  • Next, navigate to "Manage" --> "Expose API" and update the "Application ID URI" with your custom domain.

    

The configuration of the custom domain is complete.

In the next step of the deployment guide, remember to update the Api Domain in the Teams Manifest configuration.