Manage website authentication key

Power Pages connectivity architecture explained how a website connects to Microsoft Dataverse environment. When a website is created, a new authentication key is generated with the public key uploaded to Microsoft Entra application. Power Pages uses this authentication key to connect to the Dataverse environment. You must renew the key once every year to ensure that your website can connect to Dataverse environment. If the authentication key isn't renewed, your website will not be accessible to your end users once the authentication key expires.

Check authentication key details

Tip

To learn about the roles required to perform this task, read Admin roles required for website administrative tasks.

The details of an authentication key are displayed on Power Platform admin center and the website.

Power Platform admin center

  1. Open the Power Platform admin center.

  2. In the Resources section, select Power Pages sites.

  3. Select the site for which you want to manage the website authentication key.

  4. In the site details page, select Website Authentication Key in the Security section.

Website

  1. Sign in to the website with a user that is assigned the administrator webrole.

  2. Navigate to the URL <website_path>/_services/about. The authentication key expiration date is displayed.

    Website services page.

Note

To view authentication key information, you must sign in to the website in the same browser session and you must have all website access permission.

Check authentication key expiration notification

Before the authentication key expires, you receive notifications via emails, Power Platform admin center, and the website.

Email

Email is sent to users who signed up for email notification for the organization connected to their Power Pages site. More information about signing up for email notification: Manage email notifications to admins

Email notifications are sent at the following intervals:

  • 90 days
  • 60 days
  • 30 days
  • 15 days
  • Seven days
  • Six days
  • Five days
  • Four days
  • Three days
  • Two days
  • One day
  • 12 hours
  • Six hours
  • Three hours

You'll also be notified after the key expires every day until one week after key expiration.

Note

  • Intervals are calculated in UTC from the key expiration date.
  • Email is not guaranteed to be exactly at the intervals as listed. Email notification can be delayed or missed. Be sure to check for the key expiration date online as well.

Power Platform admin center

A message about key expiration is displayed at the top of the page.

Website

When you navigate to the URL <website_path>/_services/about, a notification about key expiration is displayed at the bottom of the page.

Note

You must sign in to your website in the same browser session, and you must be assigned all website access permission.

Renew authentication key

Use the following steps if the authentication key for your website is near expiration.

Note

To renew the key, you must have permissions to manage your website.

  1. Open the Power Platform admin center.

  2. In the Resources section, select Power Pages sites.

  3. Select the site for which you want to manage the website authentication key.

  4. In the site details page, select Website Authentication Key in the Security section.

    Manage authentication key.

  5. Select Update key.

  6. Select OK in the message. The update process starts, and a message is displayed.

Note

  • While this process runs in the background, the website will restart.
  • When you update a key, it's valid for the next one year.
  • This process will take five to seven minutes.
  • Updating authentication key doesn't change any other website configuration or the website state.

Troubleshooting renewal of authentication key

If the key update fails, an error message is displayed along with the following action:

  • Retry Authentication Key Update. This action allows you to restart the website authentication key update process. If the update fails multiple times, contact Microsoft support.

See also