Tokens de acesso da análise integrada

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

Consumir conteúdo do Power BI (como relatórios, dashboards e blocos) requer um token de acesso. Dependendo da solução, esse token pode ser um token do Microsoft Entra, um token de inserção ou ambos.

Na solução inserir para seus clientes, o aplicativo gera um token de inserção que concede aos usuários da Web acesso ao conteúdo do Power BI.

Observação

Ao usar a solução inserir para seus clientes, você poderá usar qualquer método de autenticação para permitir o acesso ao seu aplicativo Web.

Na solução inserir para sua organização, os usuários do aplicativo Web são autenticados no Microsoft Entra ID usando credenciais próprias. Seus clientes têm acesso ao conteúdo do Power BI para os quais têm permissão no serviço do Power BI.

Microsoft Entra token

Para as soluções Inserir para seus clientes e Inserir para sua organização, você precisará de um token do Microsoft Entra. O token do Microsoft Entra é necessário para todas as operações da API REST e expira após uma hora.

• No solução inserir para seus clientes, o token do Microsoft Entra é usado para gerar o token de inserção.

• Na solução inserir para sua organização, o token do Microsoft Entra é usado para acessar o Power BI.

Você pode adquirir um token do Microsoft Entra de uma das seguintes maneiras:

• Use uma ferramenta externa, como Bruno, para adquirir um token. O URL da solicitação é https://login.windows.net/{{tenantId}}/oauth2/token. Substitua {tenantID} pela ID do locatário.

• Siga as soluções de exemplo em PowerBI-Developer-Samples. Por exemplo:

  • Para Inserir para seus clientes, confira este arquivo AadService.cs. Localize o authorityUrl e scopeBase em AppOwnsData/Web.config.

  • Para Inserir para sua organização, confira este arquivo OwinOpenIdConnect.cs. Localize authorityUrl em UserOwnsData/Web.config.

  Observação

  Você pode encontrar os valores authorityUrl e scopeBase para algumas nuvens soberanas em Incorporar conteúdos em seu aplicativo para nuvens governamentais e nacionais/regionais.

Token de inserção

Quando você estiver usando a solução inserir para seus clientes, o aplicativo Web precisará saber qual conteúdo do Power BI o usuário pode acessar. Use as APIs REST do token de inserção para gerar um token de inserção, que especifica as seguintes informações:

• O conteúdo que o usuário do aplicativo Web pode acessar

• O nível de acesso do usuário do aplicativo Web (exibir, criar ou editar)

Para obter mais informações, confira Considerações ao gerar um token de inserção.

Fluxos de autenticação

Esta seção descreve os diferentes fluxos de autenticação nas soluções de inserção inserir para seus clientes e inserir para sua organização.

Inserir para seus clientes

A solução Inserir para seus clientes usa um fluxo de autenticação não interativo. Em uma solução inserir para seus clientes, os usuários não entram no Microsoft Entra ID para acessar o Power BI. Em vez disso, seu aplicativo Web usa uma identidade reservada do Microsoft Entra para se autenticar no Microsoft Entra ID e gerar o token de inserção. A identidade reservada pode ser uma entidade de serviço ou um usuário mestre.

• Entidade de serviço Seu aplicativo Web usa o objeto de entidade de serviço do Microsoft Entra para autenticar no Microsoft Entra ID e obter um token do Microsoft Entra somente para aplicativo. Esse método de autenticação somente de aplicativo é recomendado pelo Microsoft Entra ID.

  Ao usar uma entidade de serviço, você precisará habilitar o acesso das APIs do Power BI nas configurações de administrador do serviço do Power BI. Habilitar o acesso permite que o aplicativo Web acesse as APIs REST do Power BI. Para usar operações de API em um workspace, a entidade de serviço precisará ser membro ou administrador do espaço de trabalho.

• Usuário mestre Seu aplicativo Web usa uma conta de usuário para autenticar no Microsoft Entra ID e obter o token do Microsoft Entra. A conta de usuário mestre precisa ter uma licença do Power BI Pro ou PPU (Premium por usuário).

  Ao usar uma conta de usuário mestre, você precisará definir as permissões delegadas do seu aplicativo (também conhecidas como escopos). O usuário mestre ou administrador de locatário deve dar consentimento para usar essas permissões ao usar as APIs REST do Power BI.

Após a autenticação bem-sucedida no Microsoft Entra ID, o aplicativo Web gera um token de inserção para permitir que os usuários acessem o conteúdo específico do Power BI.

Observação

• Para a inserção usando a solução inserir para seus clientes, você precisará ter uma capacidade com um SKU A, EM ou P.
• Para passar para a produção, você precisa de uma capacidade.

O diagrama a seguir mostra o fluxo de autenticação na solução Inserir para seus clientes.

1. O usuário do aplicativo Web se autentica em seu aplicativo Web com seu método de autenticação.

2. Seu aplicativo Web usa uma entidade de serviço ou um usuário mestre para se autenticar no Microsoft Entra ID.

3. Seu aplicativo Web obtém um token do Microsoft Entra do Microsoft Entra ID e o usa para acessar as APIs REST do Power BI. O método de autenticação escolhido dá acesso à APIS REST do Power BI, que depende se o método de autenticação for uma entidade de serviço ou um usuário mestre.

4. Seu aplicativo Web chama uma operação de API REST de Token de Inserção, solicitando o token de inserção. O token de inserção especifica qual conteúdo do Power BI pode ser inserido.

5. A API REST retorna o token de inserção para o aplicativo Web.

6. O aplicativo Web transmite o token de inserção para o navegador da Web do usuário.

7. O usuário do aplicativo Web usa o token de inserção para acessar o Power BI.

Inserir para a organização

A solução Inserir para sua organização usa um fluxo de autenticação interativo. Os usuários do aplicativo Web se autenticam no Microsoft Entra ID usando suas credenciais do Power BI. Eles precisam consentir com as permissões de API definidas durante o registro do aplicativo no Microsoft Entra ID. Uma janela de diálogo Permissões solicitadas da Microsoft pede que os usuários concedam essas permissões. Depois que o consentimento for concedido, o usuário poderá inserir o conteúdo do Power BI ao qual o usuário tem acesso.

Observação

• A solução Inserir para sua organização não dá suporte a SKUs A.

• Para mover para a produção, você precisará de uma das seguintes configurações:

  • Todos os usuários com licenças Pro.
  • Todos os usuários com licenças PPU.
  • Uma capacidade ou capacidade do Fabric F64 ou superior. Essa configuração permite que todos os usuários tenham licenças gratuitas.

Este diagrama mostra um exemplo do fluxo de autenticação na solução Inserir para sua organização.

1. O usuário do aplicativo Web acessa o aplicativo Web.

2. O aplicativo Web redireciona o usuário do aplicativo Web para o Microsoft Entra ID.

3. O usuário do aplicativo Web se autentica no Microsoft Entra ID usando suas credenciais do Power BI.

4. O Microsoft Entra ID redireciona o usuário do aplicativo Web de volta para o aplicativo Web com o token do Microsoft Entra. Em um cenário de concessão implícita, o token de acesso é retornado ao navegador do usuário.

5. O aplicativo Web transmite o token do Microsoft Entra para o navegador da Web do usuário.

6. O aplicativo Web do Power BI usa o token do Microsoft Entra para inserir o conteúdo do Power BI, como relatórios e dashboards, ao qual o usuário do aplicativo Web tem permissão de acesso.

Conteúdo relacionado

• Considerações ao gerar um token de inserção
• Capacidade e SKUs em análises integradas do Power BI

Mais perguntas? Experimente perguntar à Comunidade do Power BI