Tutorial de Instalação

Para facilitar a instalação do Power Embedded, elaboramos este tutorial com o passo a passo necessário para configurar o ambiente e realizar a integração com o Azure.

Criando o Aplicativo do Power Embedded no Azure AD

Nesta etapa, será criado no Azure AD o aplicativo que será utilizado pelo Power Embedded para realizar a integração com o ambiente da organização.

Para iniciar, acesse o Microsoft Entra ID no portal do Azure e navegue até App Registrations ( registro de aplicativos)

1. Definição do nome do Aplicativo: Na tela de registros de aplicativo, clique em "Novo Registro"

1. ID do Aplicativo: Na tela de registro, informe um nome para o aplicativo, de acordo com o padrão de identificação utilizado pela organização. Como sugestão, utilizamos o nome PowerEmbedde-App. Após informar o nome, clique em Registrar, localizado na parte inferior da página.

1. Após a criação, você será direcionado para a tela de visão geral (Overview) do aplicativo.

   Localize o campo ID do Aplicativo (cliente) e copie o valor apresentado. Recomendamos salvá-lo temporariamente em um local seguro, pois ele será utilizado posteriormente na configuração do Power Embedded.

Esse valor deverá ser informado no campo ID do Cliente do Power BI, disponível nas configurações da organização no Power Embedded.

1. Criando Segredo do Aplicativo: No menu lateral do aplicativo, acesse Certificados e Segredos e, em seguida, clique em Novo Segredo do Cliente.

Na tela de criação do segredo:

• Informe uma descrição para identificar o segredo.

• Selecione o período de validade desejado.

• Clique em Add para criar o segredo.

OBS: Recomendamos utilizar uma validade de 24 meses, reduzindo a necessidade de renovação frequente.

Importante: o client secret possui uma data de expiração. Quando o segredo expirar, a autenticação utilizada pelo Power Embedded deixará de funcionar. Nesse caso, será necessário criar um novo segredo e atualizar a chave nas configurações do Power Embedded.

1. Valor do Segredo: Após clicar em Add, o segredo será criado e aparecerá na lista de Client secrets.

   Localize o campo Valor e copie o valor utilizando o botão de cópia ao lado.

Atenção: o valor do segredo é exibido apenas no momento da criação. Depois que essa tela for fechada, o valor não poderá ser consultado novamente no Azure. Caso a chave seja perdida, será necessário criar um novo Client Secret.

Após copiar o valor, armazene-o temporariamente em um local seguro.

Esse valor deverá ser informado no campo Chave de Acesso do Cliente do Power BI, disponível na tela de configuração do Power Embedded.

Importante: o Application (client) ID e o Client Secret Value são informações diferentes e ambos serão necessários para configurar a integração. O primeiro identifica o aplicativo; o segundo é utilizado como credencial para autenticação.

Sincronizar usuários e grupos do Azure AD (Entra ID)

Para permitir que o Power Embedded consulte e importe usuários e grupos do ambiente da organização, é necessário configurar as permissões do aplicativo no Microsoft Graph.

Na mesma tela de Registro de aplicativo, siga as etapas abaixo.

1. Acessar as permissões da API: No menu lateral, clique em Permissão de APIs e, em seguida, em Add a permissão.

1. Selecionar o Microsoft Graph: Na tela de seleção de APIs, clique em Microsoft Graph. Em seguida, selecione Adicionar uma permissão

1. Adicionar a permissão de diretório: Na lista de permissões, pesquise por Directory e selecione Directory.Read.All. Essa permissão permite que o aplicativo consulte informações do diretório, incluindo usuários e grupos. Após selecionar a permissão, clique em Adicionar permissão.

Caso queira utilizar uma permissão menos privilegiada, pode liberar apenas as permissões "User.Read.All" e "Group.Read.All".

Alternativa de menor privilégio: caso a organização prefira conceder apenas as permissões necessárias para consulta de usuários e grupos, é possível utilizar User.Read.All e Group.Read.All em vez de Directory.Read.All.

1. Conceder o consentimento do administrador: Após adicionar as permissões, é necessário conceder o consentimento de administrador para que o aplicativo possa utilizá-las.

   Para isso, clique em Grant admin consent for.

Após concluir essa configuração e as demais etapas da instalação, o Power Embedded estará autorizado a consultar o diretório do Microsoft Entra ID, permitindo a importação de usuários e grupos para o portal.

Importante: o consentimento de administrador deve ser concedido por um usuário que possua as permissões necessárias no Microsoft Entra ID

Adicionando o usuário do Power Embedded a um novo grupo do AD

Para conceder permissões no Portal de Administração do Power BI ao Service Principal que você acabou de criar, é obrigatório que ele faça parte de um grupo de segurança do Azure AD (Entra ID).

1. Pesquise por "Grupos" na barra de pesquisas e recursos na parte superior central.

2. Clique no botão " Novo Grupo"

1. No campo tipo de grupo, selecione Segurança.

   Em seguida, informe um nome para o grupo "PowerEmbedded-Group". O nome fica a critério da organização e pode seguir o padrão utilizado para identificação de grupos no ambiente.

2. Abaixo, no campo Membro, sclique em "nenhum membro selecionado".

   Na tela de seleção, pesquise pelo nome do Service Principal criado anteriormente "PowerEmbedded-App"

   Selecione o aplicativo na lista e clique em Selecionar.

Após adicionar o Service Principal, revise as configurações do grupo e clique em Criar.

Importante: o grupo criado nesta etapa será utilizado nas configurações do Portal de Administração do Power BI para limitar a aplicação das permissões ao Service Principal do Power Embedded.