# Changing the Application Password

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

Se você encontrou o erro abaixo ao tentar acessar o portal de administração ou um erro relacionado à senha do usuário de serviço do Power BI no portal de relatórios, não se preocupe. Isso ocorreu porque a senha do usuário de serviço do Power BI expirou ou foi alterada no portal do Azure.

<figure><img src="https://2731617315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdK3JKuIebMeMb9nnUas8%2Fuploads%2Fgit-blob-baf71f602e04f98d75e7582c0235acb34cea2053%2Fimage%20(192).png?alt=media" alt=""><figcaption></figcaption></figure>

Outra mensagem de erro bem comum quando a senha expira é quando um usuário tentar abrir um relatório no portal de visualização e se depara com a mensagem de erro abaixo:

<figure><img src="https://2731617315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdK3JKuIebMeMb9nnUas8%2Fuploads%2Fgit-blob-db6c493fc01453aa61a493eef81598739125b574%2Fimage%20(403).png?alt=media" alt=""><figcaption></figcaption></figure>

A tela de Configurações irá te alertar quando essa senha está próximo de expirar:

<figure><img src="https://2731617315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdK3JKuIebMeMb9nnUas8%2Fuploads%2Fgit-blob-5119bef46cc62fa5f7acf5821ec650e462e116f8%2Fimage%20(402).png?alt=media" alt=""><figcaption></figcaption></figure>

A tela inicial do Power Embedded também mostra um alerta quando essa senha está perto de expirar:

<figure><img src="https://2731617315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdK3JKuIebMeMb9nnUas8%2Fuploads%2Fgit-blob-1ea3c9dd0f6d1ae87cef2c7105e279c1dd0712d9%2Fimage%20(401).png?alt=media" alt=""><figcaption></figcaption></figure>

Para resolver o problema, basta gerar uma nova senha no portal do Azure e atualizar a senha na tela de configurações do Power Embedded.

Siga o passo a passo abaixo para concluir o processo:

<div align="left"><figure><img src="https://2731617315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdK3JKuIebMeMb9nnUas8%2Fuploads%2Fgit-blob-db6c493fc01453aa61a493eef81598739125b574%2Fimage%20(193).png?alt=media" alt=""><figcaption><p>A senha do usuário de serviço do Power BI, que utiliza o aplicativo 'abc123' expirou.</p></figcaption></figure></div>

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

1. **Access the Azure Portal.**&#x43;lick on this link to access the[ Azure portal](https://portal.azure.com/#view/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/~/RegisteredApps).
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 initial screen and navigate to "App registrations". Search for the user created during installation, which by default is named "PowerEmbedded-App".&#x20;

Click on it when found.

<figure><img src="https://2731617315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdK3JKuIebMeMb9nnUas8%2Fuploads%2Fgit-blob-5f3919a8a7ced599294bec79b31772fe5b9555ef%2Fimage%20(194).png?alt=media" 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="https://2731617315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdK3JKuIebMeMb9nnUas8%2Fuploads%2Fgit-blob-2ed8bf506b60bb167432d0dfa3b3a8bfc0ec0599%2Fimage%20(195).png?alt=media" alt=""><figcaption></figcaption></figure>

**Step 3:** In the new screen, enter a description for this secret (as you prefer) and select its validity.\
It is recommended to choose 24 months so you only need to worry about expiration after 2 years (Yes, after the chosen period, this secret will expire and the system will STOP working.&#x20;

You will need to generate a new secret and update it in Power Embedded).<br>

Now click the "Add" button at the end of the page.

<figure><img src="https://2731617315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdK3JKuIebMeMb9nnUas8%2Fuploads%2Fgit-blob-4278af1072ae78de4f51093448a7a8b59f11a0bd%2Fimage%20(196).png?alt=media" alt=""><figcaption></figcaption></figure>

**Step 4:** Copy the "Value" field 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.

\
The value you highlighted and copied should be pasted into the "Power BI Client Access Key" field in the Power Embedded configuration screen.

<figure><img src="https://2731617315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdK3JKuIebMeMb9nnUas8%2Fuploads%2Fgit-blob-28bed7a8f1f66a6792f0302cd60d10af01f8789e%2Fimage%20(197).png?alt=media" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://2731617315-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdK3JKuIebMeMb9nnUas8%2Fuploads%2Fgit-blob-ac05a3012b2fb7ee14f259e943a5486f75f76597%2Fimage%20(198).png?alt=media" alt=""><figcaption></figcaption></figure>

Once done, the portal will return to normal operation.
