# Pré-Requisitos para a Instalação

Para agendar a instalação do Power Embedded e iniciar o período de avaliação de 30 dias, por favor, utilize o link abaixo:

[**https://powerembedded.com.br/instalacao**](https://powerembedded.com.br/instalacao)

## O que é o processo de instalação

Para que a instalação seja realizada com sucesso, é necessária a presença de uma pessoa com perfil de **administrador do portal do Azure** (<https://portal.azure.com/>) e de alguém com acesso às **configurações de locatário do Power BI** (<https://app.powerbi.com/admin-portal/tenantSettings>).

Todos os passos descritos abaixo serão realizados em conjunto durante a reunião de instalação. No entanto, para fins de conhecimento, seguem as permissões necessárias e as atividades que serão executadas no **Azure AD**, as quais devem ser realizadas por um usuário com permissão de **Azure Global Administrator:**

1. Criar um aplicativo no AD (Acessar a tela de registros de aplicativos)
2. Criar um novo grupo no AD
3. Adicionar esse usuário neste grupo
4. Criar o recurso do Power BI Embedded ou Fabric pelo Azure (opcional se for utilizar o Trial do Fabric)
5. Adicionar o Service Principal recém-criado na role “Contributor” no recurso criado (opcional se for utilizar o Trial do Fabric ou não quiser que o portal gerencie a capacidade)
6. Adicionar o Service Principal recém-criado como “Power BI Capacity Administrator” do recurso criado  (opcional se for utilizar o Trial do Fabric ou não quiser que o portal gerencie a capacidade)
7. Acessar a área administrativa do Power Embedded ([admin.powerembedded.com.br](https://admin.powerembedded.com.br/)), autorizar o aplicativo na organização (um pop-up será exibido no primeiro acesso solicitando o consentimento) e criar os primeiros usuários com perfil de **Administrador**.
8. Logar no portal de visualização do Power Embedded ([relatorios.powerembedded.com.br](https://relatorios.powerembedded.com.br/)) e autorizar o aplicativo na sua organização (um pop-up será exibido no primeiro acesso solicitando o consentimento).

&#x20;

Seguem as atividades que serão realizadas no **portal de Administração do Power BI**, as quais devem ser executadas por um usuário com permissão de **Fabric Administrator**

:

1. Habilitar as configurações abaixo e permitir o grupo do AD criado a utilizar essas configurações:
   * Inserir conteúdo em aplicativos
   * As entidades de serviço podem usar APIs do Fabric
   * As entidades de serviço podem acessar APIs de administrador somente leitura
   * Aprimorar as respostas das APIs de administração com metadados detalhados
   * Permitir pontos de extremidade XMLA e analisar no Excel com modelos semânticos locais
2. Associar os workspaces ao recurso da **capacidade contratada ou de avaliação (trial)**, ou criar novos workspaces para realizar a migração em paralelo.
3. Adicionar o grupo do AD criado como administrador dos workspaces

## Permissões necessárias do Power Embedded

### Permissões no Entra ID

**Microsoft Graph**:

<table><thead><tr><th width="176">Permissão</th><th width="358">Descrição</th><th width="102">Tipo</th><th>Consentimento</th></tr></thead><tbody><tr><td>User.Read</td><td>Permissão padrão para ler os dados do usuário logado na aplicação</td><td>Delegado</td><td>Não</td></tr><tr><td>User.Read.All <strong>(Opcional)</strong></td><td>Necessário apenas se for importar/sincronizar usuários com Entra ID</td><td>Aplicação</td><td>Sim</td></tr><tr><td>Group.Read.All <strong>(Opcional)</strong></td><td>Necessário apenas se for importar/sincronizar usuários com Entra ID</td><td>Aplicação</td><td>Sim</td></tr><tr><td>Application.Read.All <strong>(Opcional)</strong></td><td>Necessário apenas para monitorar e alertar sobre a validade do secret da aplicação</td><td>Aplicação</td><td>Sim</td></tr></tbody></table>

<figure><img src="https://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2FpOYTMuMUYgQsK2JtQgNX%2Fimage.png?alt=media&#x26;token=d11edad5-dab9-44a2-9ab8-ed49de44ab23" alt=""><figcaption></figcaption></figure>

### Permissões no Portal de Administração do Power BI

Permissões necessárias:

* As entidades de serviço podem usar APIs do Fabric
* As entidades de serviço podem acessar APIs de administrador somente leitura
* Permitir pontos de extremidade XMLA e analisar no Excel com modelos semânticos locais (ativado por padrão)
* Inserir conteúdo em aplicativos (ativado por padrão)

Permissões opcionais:

* Aprimorar as respostas das APIs de administração com metadados detalhados (necessário, caso queira permitir o uso da IA Generativa do portal)
* Aprimorar as respostas das APIs de administração com as expressões DAX e mashup (necessário caso queira permitir o uso da IA Generativa do portal)
* Exportar para Excel (necessário caso queira permitir exportar dados do relatório para Excel pelo portal)
* Exportar para .csv (necessário caso queira permitir exportar dados do relatório para CSV pelo portal)
* Exportar relatório como apresentações em Power Point ou documentos PDF (necessário caso queira permitir exportar relatórios ou criar assinaturas por email no formato PDF ou Power Point)
* Exportar os relatórios como arquivos de imagem (necessário caso queira permitir exportar relatórios no formato de Imagem/PNG)

<figure><img src="https://2938845060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ft2gQSHbraGsYbDGTmWAa%2Fuploads%2Fbx9pVwBvxSMcKBjKVUVI%2Fimage.png?alt=media&#x26;token=7c29aaf2-7959-4c55-a4fa-b78fc584bbd8" alt=""><figcaption></figcaption></figure>

### Permissões na capacidade Fabric ou Power BI Embedded

O Power Embedded possui uma funcionalidade que permite ligar, desligar e alterar o SKU da capacidade manualmente, baseado em agendamento ou por demanda.

Caso queira permitir que os administradores do portal utilizem esse recurso, será necessário realizar as atividades abaixo por meio do **portal do Azure**:

1. Adicionar o Service Principal na role “Contributor” da capacidade (opcional se for utilizar o Trial do Fabric)
2. Adicionar o Service Principal como “Power BI Capacity Administrator” da capacidade (opcional se for utilizar o Trial do Fabric)

## Links úteis

[Documentação técnica da instalação](https://docs.powerembedded.com/power-embedded-documentacao/documentacao-tecnica/instalacao/trial-do-fabric)

[Site principal do Power Embedded](https://powerembedded.com.br)

[Série de vídeos sobre o Power Embedded](https://powerembedded.com.br/videos)

[Calculadora do Power Embedded para estimar o custo da solução para o seu ambiente](https://powerembedded.com.br/calculadora)