Configurar o Power BI Embedded

APLICA-SE A: App possui dados O usuário possui dados

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 incorporada do Power BI, você precisa registrar um aplicativo Microsoft Entra no Azure. O aplicativo Microsoft Entra estabelece permissões para recursos REST do Power BI e permite acesso às APIs REST do Power BI.

Sugestão

Pode experimentar o Power BI Embedded sem registar uma aplicação. Confira o playground de análise incorporada 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 incorporado do Power BI, você precisa de uma das seguintes opções:

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 os seus clientes
Para a sua organização

Incorporar para os seus clientes

Use a solução incorporar para os seus clientes, também conhecida como aplicação possui dados, se criar uma aplicação desenhada para os seus clientes. Os usuários não precisam entrar no Power BI 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 do Power BI Pro usada para entrar no Power BI) ou uma entidade de serviço.

A solução de incorporação para seus clientes geralmente é usada por fornecedores independentes de software (ISVs) e desenvolvedores que criam aplicativos para terceiros.

Incorporar para a sua organização

Use a solução de incorporação para sua organização , também conhecida como dados de propriedade do usuário, se você criar um aplicativo que exija que os usuários usem suas credenciais para autenticação no Power BI.

A solução de incorporação para sua organização é geralmente usada por empresas e grandes organizações e destina-se a usuários internos.

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

Registar a sua aplicação

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

Um aplicativo de incorporação para sua organização
Um aplicativo de incorporação para seus clientes com uma entidade de serviço

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

Inicie sessão no portal do Azure.
Selecione seu locatário do Microsoft Entra selecionando sua conta no canto superior direito da página.
Selecione Registos de aplicações. Se não vir esta opção, pesquise-a.
Em Registos de aplicações, selecione Novo registo.
Preencha os seguintes campos:
- Nome - Dê um nome ao seu aplicativo.
- Tipo de conta suportado - Selecione quem pode usar o aplicativo. Selecione Contas apenas neste diretório organizacional para aplicativos de inquilino único ou Contas em qualquer diretório organizacional para cenários de diferentes inquilinos.
(Opcional) Na caixa URI de redirecionamento, adicione uma URL de redirecionamento.
Selecione Registar. Depois que seu aplicativo for registrado, você será direcionado para a página de visão geral do aplicativo, onde poderá 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 incorporação do Power BI está pronto para uso.

Criar uma chave secreta (opcional)

Se quiseres usar uma entidade de serviço para autenticar a tua aplicação, precisas criar um segredo de cliente. Um segredo do cliente é uma senha que seu aplicativo usa para autenticar contra o Microsoft Entra ID. 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 deseja que o segredo do cliente expire e selecione Adicionar.
Copie e salve o valor secreto do cliente.

Observação

Depois de salvar o segredo do cliente, o valor do segredo do cliente é exibido. Isso é exibido apenas uma vez, portanto, copie esse valor e armazene-o onde seu aplicativo pode recuperá-lo, geralmente onde seu aplicativo mantém valores como clientId ou autoridade no código-fonte. Você precisa fornecer o valor secreto junto com a ID do cliente da aplicação para autenticar-se como a aplicação. Depois de sair desta janela, o valor secreto do cliente fica oculto e não é possível visualizá-lo ou copiá-lo novamente.