Configure SSL certificates and custom domain names
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
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.
- 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.comdomain 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.
Sign in to the Microsoft Power Platform admin center.
In the left pane, expand Resources and then select Portals.
Select the target portal.
Select Manage at the top of the page.
That will open the Power Apps portals admin shortcuts page.
Custom domain name wizard
To configure a custom domain name using a wizard.
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.
Select Add a Custom Domain Name. A wizard opens to walk you through the steps required to define a custom domain.
Certificates and custom domain names can be set up and maintained independently.
Manage SSL certificates
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.
Select Add new to upload a new certificate.
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
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.
Select Add new in the HOST NAME section to add the new custom domain name.
Enter the domain name and press TAB. The domain name will be validated.
Select OK to add a custom domain.
Select Add new in the SSL Bindings section.
Select HOSTNAME, then select Certificate.
Press OK to create a new binding.
Visitors should now be able to browse the portal by using the custom domain name.
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.