# Changing the Application Password

### **Expired Password or Access Token Validation Error**

If you encountered the error below when trying to access the administration portal, or an error related to the Power BI service user password in the reports portal, do not worry. This occurred because the Power BI service user's password expired or was changed in the Azure portal.

<figure><img src="/files/pKOeAETHwPauxXh0wSEK" alt=""><figcaption></figcaption></figure>

Another very common error message when the password expires is when a user tries to open a report in the visualization portal and encounters the following error message:

<figure><img src="/files/zAtjzVNKEc9oUoQyIQlP" alt=""><figcaption></figcaption></figure>

The Settings screen will alert you when this password is about to expire:

<figure><img src="/files/KEPVyRjG97zofHHFSuTL" alt=""><figcaption></figcaption></figure>

The Power Embedded home screen also shows an alert when this password is close to expiring:

<figure><img src="/files/C6V4kDnclt6lmAyh1MpH" alt=""><figcaption></figcaption></figure>

To resolve the issue, simply generate a new password in the Azure portal and update the password on the Power Embedded settings screen.

Follow the step-by-step guide below to complete the process:

<div align="left"><figure><img src="/files/zAtjzVNKEc9oUoQyIQlP" alt=""><figcaption><p>The Power BI service user's password, which uses the 'abc123' application, has expired.</p></figcaption></figure></div>

To complete this process, you will need to perform the following steps:

1. **Access the Azure Portal.** [Click this link](https://portal.azure.com/#view/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/~/RegisteredApps) to access the Azure portal.
2. Search for the Power Embedded Application (PowerEmbedded-App).
3. Click on "Certificates & secrets" in the sidebar menu, then click on "New client secret".
4. Define a description and expiration date for this key.
5. Copy the new key and securely store it in a password vault, as it cannot be recovered again.
6. In Power Embedded, access the "Settings" page, paste the copied value into the "Power BI Client Access Key" field, and click Save.

### **How to Create an Application Password in the Azure Portal**

**Step 1:** With the Azure portal open, go to the home screen and navigate to "App registrations". Search for the user created during installation.

By default, the suggested name is **PowerEmbedded-App**. Click on it when you find it.

<figure><img src="/files/EmyrQVHca7AqSA3DbCUt" alt=""><figcaption></figcaption></figure>

**Step 2:** On this screen, click on **"Certificates & secrets"** and then click on **"New client secret"** to create a new client secret.

<figure><img src="/files/mqhHhyXaAaFd4rN38CM9" alt=""><figcaption></figcaption></figure>

**Step 3:** In the new screen that opens, enter a description for this secret (according to your preference) and select the validity period for this secret.

*The recommendation is to choose 24 months so you only need to worry about this expiration after 2 years (Yes, after the chosen period, this secret will expire and the system will STOP working. You will need to generate a new secret and update it in Power Embedded).*

Now click the **Add** button at the bottom of the page.

<figure><img src="/files/7KI4A5poivobkc6zRs1p" alt=""><figcaption></figcaption></figure>

**Step 4:** Now copy the "Value" field that was generated. There is a copy button next to this key.

Note and securely store this key, as this will be the ONLY time you can see it. If you lose this key, it cannot be recovered: You will need to generate a new secret and update it in the system.

This value that you copied should be pasted into the "**Power BI Client Access Key**" field on the Power Embedded configuration screen.

<figure><img src="/files/YGgnvMeCQgqSrNvWQiMl" alt=""><figcaption></figcaption></figure>

### **Configuring the Application Password in Power Embedded**

**Step 5:** Go to the administration portal and add the copied value to the "**Power BI Client Access Key"** field.

<figure><img src="/files/uhOc1yFMj3P9cZF8VGOR" alt=""><figcaption></figcaption></figure>

Once done, the portal will return to normal operation.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.powerembedded.com/administration-portal/settings/organization/change-application-password.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.