Configurar o Power BI Embedded

APLICA-SE A: Os dados pertencem ao aplicativo Os dados pertencem ao usuário

Este artigo mostra como começar a usar o Power BI Embedded para compartilhar seus relatórios com outras pessoas. Para usar a análise integrada do Power BI, você precisa registrar um aplicativo do Microsoft Entra no Azure. O aplicativo do Microsoft Entra estabelece permissões para os recursos REST do Power BI e permite o acesso às APIs REST do Power BI.

Dica

Você pode experimentar o Power BI Embedded sem registrar um aplicativo. Confira o playground de análise integrada do Power BI para começar a desenvolver e acompanhar todos os novos recursos e atualizações do Power BI Embedded.

Pré-requisito

Para configurar um ambiente de análise integrada do Power BI, você precisa de um dos seguintes itens:

Locatário do Microsoft Entra e um usuário organizacional (mestre)
Conta do Power BI Pro

Antes de começar

Antes de registrar seu aplicativo, decida qual das seguintes soluções melhor atende às suas necessidades:

Para seus clientes
Para sua organização

Inserir para seus clientes

Use a solução embed-for-your-customers, também conhecida como o app é proprietário dos dados ao criar um app projetado para os clientes. Os usuários não precisam entrar ou ter uma licença do Power BI para usar seu aplicativo. Seu aplicativo é autenticado no Power BI usando uma conta de usuário mestre (uma licença de Power BI Pro usada para fazer login nele) ou uma entidade de serviço.

Geralmente, a solução de inserção para seus clientes é usada por ISVs (fornecedores independentes de software) e por desenvolvedores criando aplicativos para terceiros.

Inserir para a organização

Use a solução inserir a sua organização, também conhecida como o usuário tem dados, se criar um aplicativo que exigirá que os usuários usem suas credenciais para autenticação no Power BI.

Geralmente, a solução de inserção para a organização é usada por empresas e grandes organizações e é destinada a usuários internos.

Para obter mais informações sobre as duas soluções, confira O que são as soluções de análise integrada do Power BI?.

Registrar seu aplicativo

Para registrar um aplicativo do Microsoft Entra, use o procedimento a seguir nesta seção. Execute estas etapas somente se estiver criando uma das seguintes soluções:

Um aplicativo inserir para a organização
Um aplicativo inserir para os clientes com uma entidade de serviço

Para obter mais informações sobre como registrar aplicativos no Microsoft Entra ID, confira Registrar um aplicativo com a plataforma de identidade da Microsoft.

Entre no portal do Azure.
Selecione o locatário do Microsoft Entra selecionando sua conta no canto superior direito da página.
Selecione Registros do Aplicativo. Se não vir essa opção, pesquise por ela.
Em Registros de aplicativo, selecione Novo registro.
Preencha os campos a seguir:
- Nome – dê um nome ao aplicativo.
- Tipo de conta com suporte – selecione quem pode usar o aplicativo. Selecione Contas apenas neste diretório organizacional para aplicativos de locatário único ou Contas em qualquer diretório organizacional para cenários de locatários múltiplos.
(Opcional) Na caixa URI de redirecionamento, adicione uma URL de redirecionamento.
Selecione Registrar. Após o aplicativo ser registrado, você é direcionado para a página de visão geral dele, em que pode obter a ID do Aplicativo. Copie e salve a ID do aplicativo e todas as informações na caixa Resumo para uso posterior. Seu ambiente de inserção do Power BI está pronto para uso.

Criar uma chave secreta (opcional)

Se você quiser usar uma entidade de serviço para autenticar seu aplicativo, precisará criar um segredo de cliente. Um segredo do cliente é uma senha que seu aplicativo utiliza para se autenticar na Identidade Microsoft Entra. Você pode criar um segredo do cliente no portal do Azure.

Selecione Certificados e segredos.
Selecione Novo segredo do cliente.
Na janela Adicionar um segredo do cliente , insira uma descrição, especifique quando quiser que o segredo do cliente expire e selecione Adicionar.
Copie e salve o valor do segredo do cliente.

Observação

Depois de salvar o segredo do cliente, o valor do segredo do cliente será exibido. Isso só é exibido uma vez, portanto, copie esse valor e armazene-o onde seu aplicativo possa recuperá-lo, geralmente onde seu aplicativo mantém valores como clientId ou autoridade no código-fonte. Você precisa fornecer a senha secreta junto com a ID do cliente do aplicativo para acessar o aplicativo. Depois de sair dessa janela, o valor do segredo do cliente ficará oculto e você não poderá exibi-lo ou copiá-lo novamente.