Configure SSL certificates and custom domain names

Completed

When a portal is provisioned, it will have a portal URL that is a subdomain of powerappsportals.com, for example, contoso.powerappsportals.com. A common task for a portal administrator is to configure a custom URL for a Power Apps portal to reflect the domain naming conventions of an organization, such as https://www.contoso.com.

Note

You can have only one custom URL for each portal.

The following sections describe how to add a custom URL to a Power Apps portal.

Prerequisites

  • The organization needs to have a valid SSL certificate for the domain. The SSL certificate must be in PFX format, signed by a trusted certificate authority, and meet many other security requirements (see Add SSL certificates for the full requirements list).
  • The domain name needs to have a CNAME record set up in DNS pointing to the contoso.powerappsportals.com domain that was configured during the portal provisioning process.
  • The portal must be in Production mode (that is, not Trial or Suspended) when you're adding a custom domain.

To configure a custom domain name, open the Power Apps portals admin shortcuts page.

  1. Sign in to the Microsoft Power Platform admin center.

  2. In the left pane, expand Resources and then select Portals.

  3. Select the target portal.

  4. Select Manage at the top of the page.

  5. That will open the Power Apps portals admin shortcuts page.

Screenshot of Power Apps portals admin shortcuts page.

Custom domain name wizard

To configure a custom domain name using a wizard.

  1. On the Power Apps portals admin shortcuts page, select Portal Actions. That will open the Power Apps portals admin center with the Portal Actions page selected.

  2. Select Add a Custom Domain Name. A wizard opens to walk you through the steps required to define a custom domain.

Screenshot of a portal custom domain wizard

Manual installation

Certificates and custom domain names can be set up and maintained independently.

Manage SSL certificates

  1. On the Power Apps portals admin shortcuts page, select Manage SSL certificates shortcut. That will open the Power Apps portals admin center with the Manage SSL certificates page selected.

  2. Select Add new to upload a new certificate.

Screenshot of the Manage SSL certificates page in Power Apps portals admin center.

You can use this page to upload a renewed certificate before the existing one expires. That allows for the certificate to be switched over without any portal downtime.

Set up a custom domain name and SSL

  1. On the Power Apps portals admin shortcuts page, select Set up custom domain name and SSL. That will open Power Apps portals admin center with Set up custom domain name and SSL page selected.

    Screenshot of Set up custom domain name and SSL page in Power Apps portals admin center.

  2. Select Add new in the HOST NAME section to add the new custom domain name.

  3. Enter the domain name and press TAB. The domain name will be validated.

  4. Select OK to add a custom domain.

    Screenshot of the steps to add custom domain name to a portal.

  5. Select Add new in the SSL Bindings section.

  6. Select HOSTNAME, then select Certificate.

  7. Press OK to create a new binding.

    Screenshot of the steps to add SSL binding to the custom domain name.

Visitors should now be able to browse the portal by using the custom domain name.

Note

If you want to change your existing custom domain name, upload a new SSL certificate and follow the preceding steps.

For more information, see Add a custom domain.