# Alterar senha do aplicativo

### Erro de senha expirada ou ao validar token de acesso

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://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2FztwQtoCtftg0V6ynSqRC%2Fimage.png?alt=media&#x26;token=41224bcc-d06c-471f-8100-5127fd5ae26a" 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://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2FZtKGIKiG9vcdr7tDDhFl%2Fimage.png?alt=media&#x26;token=39e8463b-5f60-4aa1-8f9b-1b0b056831d4" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2FguyknGXkiOhavfhSu7C4%2Fimage.png?alt=media&#x26;token=92369fa6-0cc2-45fe-a877-17589d493048" 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://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2FK05Tdi3bPsO5rfCgoi1u%2Fimage.png?alt=media&#x26;token=824873d2-fbc0-41a3-a1a4-cf0365c886bd" 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://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2FhXUiWF5MaR5KLIaEOXHi%2Fimage.png?alt=media&#x26;token=05d3f7fb-8519-46ab-9086-5fc5a7c09c6c" alt=""><figcaption><p>A senha do usuário de serviço do Power BI, que utiliza o aplicativo 'abc123' expirou.</p></figcaption></figure></div>

Para concluir esse processo, você precisará realizar estes passos abaixo:

1. Acesse o portal do Azure [clique nesse link](https://portal.azure.com/#view/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/~/RegisteredApps)
2. Pesquise pelo aplicativo do Power Embedded (PowerEmbedded-App)
3. Clique no item "Certificados & segredos" no menu lateral e depois clique em "Novo segredo do cliente"
4. Defina uma descrição e a data de expiração dessa chave
5. Copie essa nova chave e guarde-o com segurança em um cofre de senhas, pois não será possível recuperá-la novamente
6. No Power Embedded, acessa a página de "Configurações", cole o valor copiado no campo “Chave de Acesso do Cliente” e clique em Salvar.

### Como criar a senha do aplicativo no portal do Azure

**Passo 1:** Com o portal do Azure aberto, na tela inicial, vá para ‘App registrations’ e procure pelo usuário criado durante a instalação.

Por padrão, o nome sugerido é **PowerEmbedded-App**. Clique sobre ele ao encontrá-lo.

<figure><img src="https://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2FbBCyqz9wivIPEaJaB0ZT%2Fimage.png?alt=media&#x26;token=4529f26f-aa1f-4115-b3c5-be2c3c96bd35" alt=""><figcaption></figcaption></figure>

**Passo 2:** Nessa tela, clique em **“Certificates & secrets”** e em seguida clique em **“New client secret”** para criar um novo segredo do cliente.

<figure><img src="https://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2Fg89cWW1BvQb1sndqheMu%2Fimage.png?alt=media&#x26;token=a0758559-08ce-4cac-9304-311a6a0751de" alt=""><figcaption></figcaption></figure>

**Passo 3:** Na nova tela aberta, digite uma descrição para esse segredo (conforme a sua preferência) e selecione a validade deste segredo.

*A recomendação é escolher 24 meses para só precisar se preocupar com essa expiração depois de 2 anos (Sim, após o prazo escolhido, esse segredo irá expirar e o sistema irá PARAR de funcionar. Você precisará gerar um novo segredo e atualizar no Power Embedded).*

Agora clique no botão **Adicionar (Add)**, no final da página.

<figure><img src="https://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2Fs6mLHtIKuIV2uoTBcLpH%2Fimage.png?alt=media&#x26;token=7b1d33c9-b08a-40f9-b206-8e5f68caf119" alt=""><figcaption></figcaption></figure>

**Passo 4:** Agora copie o campo “Value” gerado. Existe um botão de copiar ao lado dessa chave.

Anote e guarde bem essa chave, pois essa será a ÚNICA vez que você poderá vê-la. Caso você perca essa chave, não será possível recuperá-la: Você precisará gerar um novo segredo e atualizar no sistema.

Esse valor que destaquei e você copiou, você deverá colar no campo “**Chave de Acesso do Cliente do Power BI**” da tela de configuração do Power Embedded.

<figure><img src="https://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2Fc1qxEuGmwpaamisf9ajX%2Fimage.png?alt=media&#x26;token=7c31c1f3-796c-4b11-987f-25d8e761bfb9" alt=""><figcaption></figcaption></figure>

### Configurando a senha do aplicativo no Power Embedded

**Passo 5:** Vá ao portal de administração e adicione o valor copiado no campo **“Chave de Acesso do Cliente do Power BI”.**

<figure><img src="https://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2FsFuY1pCTJR4ywkX9mh8v%2Fimage.png?alt=media&#x26;token=52c7daed-9e52-4711-9b17-403c9f827013" alt=""><figcaption></figcaption></figure>

Feito isso o portal irá voltar a funcionar normalmente.
