# Migração

Para simplificar a configuração do Power Embedded, preparamos um script que automatiza o processo de importação de usuários, RLS e relatórios do Power BI para o Power Embedded de forma simples e fácil.

## Requisitos

Para conseguir executar o processo de migração é importante está com as seguintes permissões habilitadas:

<details>

<summary>Permissão de admin do usuário de serviço</summary>

Essa permissão precisa está habilitada em todos os workspaces que irão está disponível no portal.

Para adicionar o Service Principal criado como administrador de um workspace, acesse o workspace, clique nos 3 pontinhos e selecione a opção “Gerenciar acesso

<img src="https://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2F1Q0hFVpFPKWGzaJTLxWs%2Fapp%201.png?alt=media&#x26;token=1bcd0054-3c21-44b8-8122-5ec71589dfc4" alt="" data-size="original">

Clique no botão “+ Adicionar pessoas ou grupos”

<img src="https://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2Fh19cVSw6ePGILfi2Xu3N%2Fapp%202.png?alt=media&#x26;token=fc27b221-33fb-42a0-8bb6-e75356efc498" alt="" data-size="original">

Pesquise pelo nome do aplicativo que foi criado anteriormente (PowerEmbedded-App) e lembre de alterar o nível de acesso para “Administrador”. Após isso, clique no botão “Add”

<img src="https://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2FV6hL8XPrlsifpEr6ZrrK%2Fapp%203.png?alt=media&#x26;token=24e13752-713d-443f-9cc0-19082fce6a56" alt="" data-size="original">

Pronto! Agora o Power Embedded já possui acesso nesse workspace. Repita isso para todos os Workspaces que você quer importar relatórios.

</details>

<details>

<summary>Permissões Leitura API</summary>

Permissões para a importação de dados do Entra ID

Para ser possível importar dados de usuários e grupos do Entra ID, é necessário atribuir algumas permissões para o Service Principal, criado no Portal do Azure, utilizado pelo Power Embedded para se comunicar com o seu ambiente.

Na tela de [Registro de aplicativos](https://portal.azure.com/#view/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/~/RegisteredApps), pesquise pelo nome do aplicativo criado (O nome padrão é PowerEmbedded-App).

Na tela do aplicativo, clique em *API permissions*, no menu lateral e depois em *Add a Permission*.

<img src="https://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2FRRU9B4qmXOzK3XnitXBY%2Fsin%201%20small.png?alt=media&#x26;token=9cf26b3b-0a25-4f3e-aa95-acb1a702c781" alt="" data-size="original">

Na próxima tela selecione a opção do *Microsoft Graph*.

<img src="https://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2FGx5KFkaw8hWn88jkJP5t%2Fsinc%202%20small.png?alt=media&#x26;token=108b8255-bf4f-4c91-a664-f2addabe5b6a" alt="" data-size="original">

Em seguida selecione a opção de *Application permissions*.

<img src="https://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2FpPXObo6fvRkOtoK3aNwr%2Fsinc%20small%203.png?alt=media&#x26;token=de4e92d7-0e01-4e9a-9e40-58665482055e" alt="" data-size="original">

Na aba a seguir, busque por *Directory* e selecione a primeira opção *Directory.Read.All* e clique em *Add permissions*.

<img src="https://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2FXhOC6tRa4xLsSaQxrEXR%2Fsinc%20small%204.png?alt=media&#x26;token=f6658dfe-9db7-4fa8-879a-2664d597b7e4" alt="" data-size="original">

Para finalizar basta conceder o consentimento do administrador clicando em *Grant admin consent for*.

<img src="https://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2FM9NqHbjWNZ0bh3yjxQwb%2FScreenshot%202024-10-29%20164709.png?alt=media&#x26;token=78298e4c-dd2b-4921-8d47-5868fe38940b" alt="" data-size="original">

Pronto, agora você já conseguirá importar os usuários e grupos do Azure AD (Entra ID) para o Power Embedded.

</details>

## Instruções

Com as devidas permissões habilitadas agora é só seguir o passo a passo de processo.

Vá ao portal de administração do Power Embedded no menu de migração, siga estas etapas. Nesse menu siga as instruções abaixo.

**Etapa 1:** Gere os tokens de acesso utilizando o botão abaixo e copie. O token gerado será válido por apenas 1 hora.

<figure><img src="https://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2FtoAIG61Gr7MOIPBO5J93%2Fimage.png?alt=media&#x26;token=d43fe4a7-4e2f-4d81-826c-0b8cc2ade2b5" alt=""><figcaption></figcaption></figure>

**Etapa 2:** Abra o script PowerShell disponível no link dessa página, copie e cole no console do PowerShell.

**Etapa 3**: Substitua as variáveis do script pelos respectivos valores

<figure><img src="https://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2FtwCPBlfmSamjfPbxlvpv%2Fimage.png?alt=media&#x26;token=7ac74425-4573-4ad2-acc3-c292b1f7d59d" alt=""><figcaption></figcaption></figure>

**ID de Cliente do Power BI**: Acesse o Portal de Administração do Power BI Embedded > Configurações > campo “ID de Cliente do Power BI”.

<figure><img src="https://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2FmsAK4Sk7zFaXeNmFi9Ku%2Fimage.png?alt=media&#x26;token=feeba2bb-4d94-45e9-a27c-f191535a8179" alt=""><figcaption></figcaption></figure>

**Chave de API**: Acesse o Portal de Administração do Power BI Embedded > Configurações > campo “Chave de API” (clique no ícone em vermelho para gerar a chave).

<figure><img src="https://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2F0ZsdUfI7aYr6WZjlCheP%2Fimage.png?alt=media&#x26;token=6d86ebcb-5399-4c74-8c3b-d8cbc25a8b3a" alt=""><figcaption></figcaption></figure>

**Pbi Token:** Chave Gerada no menu de migração

<figure><img src="https://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2FZP18wTVtYewG3mqF1RpD%2Fpbi.png?alt=media&#x26;token=bec0da13-6c23-46e6-816e-cc358a0bbbc2" alt=""><figcaption></figcaption></figure>

**Ad Token :** Chave gerada no menu de migração.

<figure><img src="https://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2Fh3IubJQGUQLPqXcQLOCi%2Fad.png?alt=media&#x26;token=13ac1c6c-498f-4309-8cbd-007b5f4331d6" alt=""><figcaption></figcaption></figure>

Com os campos preenchidos agora é só rodar o código no Power Shell.

<figure><img src="https://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2FXAl0Oe04fW9wZPldVcCe%2Fprint%208.png?alt=media&#x26;token=17b18814-711f-4788-a663-4ef35e89c0cb" alt=""><figcaption></figcaption></figure>

Com o script finalizado, todos os relatórios, usuários, e rls estarão importados no Power Embedded.