Power BI (guia do admin)

Planos: Free, Starter, Business, Education e Enterprise
Pessoas: Admins da empresa, admins do time
Plataformas: Navegador, Desktop

A integração do Power BI permite que usuários insiram relatórios e painéis do Power BI nos boards da Miro. Este guia cobre a configuração, a implementação técnica da integração, o modelo de segurança e o tratamento de dados para admins que avaliam ou configuram a integração.

Principais funcionalidades

• Live Embed: Os usuários podem inserir um relatório ou painel do Power BI em um board da Miro como um iframe ao vivo.
• Seguro: Cada visitante do board é solicitado a fazer login no iframe antes de poder visualizar o conteúdo inserido.
• Opções de exibição: Os usuários podem optar por exibir o conteúdo inserido como Live Embed ou como marcador.
• Modo foco: Os usuários podem ampliar um Live Embed ou um marcador para o modo foco para visualizá-lo sem distrações.
• Atalho de ação: Os usuários podem adicionar um atalho de ação que abre uma caixa de diálogo para inserir um link do Power BI.
• Seletor de ativos: Os usuários podem adicionar um visual específico de relatório como imagem estática no board, para que os colaboradores possam visualizar e consultar exatamente esse conteúdo sem precisar acessar o arquivo de origem.
• Controles do admin: Os admins podem impedir que usuários usem o seletor de ativos para adicionar conteúdo do Power BI como imagens estáticas.

Requisitos e limitações

Requer uma assinatura do Power BI Cloud. Assinaturas compatíveis:

• SKU do Power BI Premium por capacidade
• SKU de Reserva de Capacidade do Fabric

Restrições:

• Não é possível inserir links de conjuntos de dados.
• Não é possível inserir o tipo "Dashboard".
• Os links do menu Compartilhar são compatíveis apenas com visuais de relatório.
• As imagens adicionadas pelo seletor de ativos não podem ser atualizadas (essa funcionalidade está em desenvolvimento).
• Não é possível inserir em boards públicos.

Configurar a integração do Power BI

Pré-requisitos

• Um admin da empresa aprovou a integração do Power BI para sua organização da Miro.
• Você tem acesso de admin no Microsoft Entra para aprovar a integração no seu tenant da Microsoft.

Aprovar a integração no Microsoft Entra

A versão atual do aplicativo Miro Power BI requer consentimento de admin para ser instalado no tenant da Microsoft do cliente.

1. Faça login no Microsoft Entra como admin e vá para Aplicativos empresariais > Consentimento e permissões.
2. Marque Sim para os usuários poderem solicitar o consentimento do administrador para aplicativos aos quais não podem dar consentimento.
3. Em Quem pode revisar solicitações de consentimento do administrador, selecione os usuários, funções ou grupos que poderão revisar essas solicitações.
4. Depois que isso for configurado, um usuário que não seja admin pode colar um link do Power BI em um board da Miro (em um time habilitado para a integração) para acionar uma solicitação de aprovação.
5. Os admins selecionados no passo 3 podem ir para Aplicativos empresariais > Solicitações de consentimento do administrador para revisar e aprovar a solicitação. Uma vez aprovada, a integração passa a estar disponível para que qualquer usuário no locatário a autorize por conta própria.

Instalar e autorizar a integração na Miro

OBSERVAÇÃO: Apenas admins do time na Miro podem instalar o app. Se sua organização na Miro permite apenas apps aprovados e um usuário regular cola um link do Power BI, esse usuário verá um diálogo de solicitação de instalação do app.

1. Copie a URL do relatório ou painel do Power BI.
2. Cole a URL no seu board da Miro.
3. O que acontece a seguir depende de quem colou o link:
   • Um admin do time da Miro cola o link: O app é autorizado e instalado automaticamente, e o link é exibido sem necessidade de ação adicional.
   • Um usuário comum cola o link, e a organização só permite apps aprovados: Abre-se uma caixa de diálogo de solicitação de instalação do app. Depois que o usuário solicitar permissão, os Admins da empresa podem seguir o artigo Fluxo de solicitação de app para aprovar o pedido.

Conectar uma conta do Power BI

Depois que a integração for instalada e autorizada:

1. Clique em Conectar no widget criado após colar a URL no board. Você será redirecionado para uma página que pedirá que conceda à Miro acesso à sua conta do Power BI.
2. Confirme a autorização no lado da Microsoft. Uma caixa de diálogo será aberta solicitando que você selecione os gráficos a serem inseridos; selecione um gráfico e clique em Adicionar gráfico. O conteúdo será adicionado ao seu board.

Implementação técnica

A Miro se integra ao Power BI por meio da Power BI REST API juntamente com as Power BI embedded analytics client APIs. Os usuários autorizam o acesso com OAuth 2.0 e, em seguida, vinculam seus relatórios ou painéis do Power BI a um board da Miro.

Considerações de segurança

O seletor de ativos da integração permite que os usuários anexem parte de um relatório do Power BI ao canvas como uma imagem estática. Apenas usuários autorizados podem acessar a Live Embed, mas qualquer pessoa com acesso ao board pode visualizar a imagem estática anexada. A opção de adicionar ativos a partir de conteúdos incorporados está desabilitada por padrão em boards públicos.

Admins da empresa podem desabilitar o seletor de ativos para todos os boards:

1. Vá para Configurações da empresa > Aplicativos e integrações > Aplicativos > Power BI (na guia Gerenciar aplicativos).
2. Ative Impedir que os usuários adicionem ativos de itens incorporados ao canvas.

Fluxos de dados

1. Um usuário que faz parte de um time ou de uma organização com essa funcionalidade ativada cola um link do Power BI em um board da Miro.
2. A Miro lê o link. Se o usuário ainda não autorizou a integração, a Miro inicia o fluxo OAuth e redireciona o usuário para a página de autorização da Microsoft.
3. Depois que o usuário concede autorização, o serviço de integração da Miro usa o token de acesso do usuário para chamar a Power BI REST API e recuperar o conteúdo.

Quais dados do Power BI a Miro armazena

A Miro busca e armazena os seguintes dados de links do Power BI colados:

• Imagens de blocos dos painéis do Power BI
• Imagens de elementos visuais dos relatórios do Power BI
• Títulos de painéis, relatórios, elementos visuais e blocos do Power BI
• Nomes das páginas dos relatórios do Power BI
• Nomes e valores de filtros dos relatórios do Power BI
• Imagens criadas pelo seletor de ativos

Retenção de dados

Os dados incorporados seguem a política padrão de retenção de dados da Miro, aplicável a todos os dados dos clientes.

Autenticação e autorização

Incorporar um link do Power BI em um board requer que o usuário autorize a integração por meio da API OAuth da Microsoft. Isso também exige que um admin do Microsoft Entra aprove a integração. Veja Aprovar a integração no Microsoft Entra acima.

Escopos de autorização necessários

A integração do Power BI requer os seguintes escopos:

• offline_access, necessário para atualizar os tokens.
• https://analysis.windows.net/powerbi/api/Dashboard.Read.All, necessário para ler todos os painéis.
• https://analysis.windows.net/powerbi/api/Dataset.Read.All, necessário para ler todos os conjuntos de dados.
• https://analysis.windows.net/powerbi/api/Report.Read.All, necessário para ler todos os relatórios.
• https://analysis.windows.net/powerbi/api/UserState.ReadWrite.All, necessário para filtros persistentes.

O que a Miro armazena e como

A Miro armazena duas categorias de dados para esta integração: dados de autorização e dados de pré-visualização.

Dados de autorização: A Miro armazena o token de acesso e o token de atualização em seu banco de dados por vários dias. Enquanto a autorização estiver ativa, a Miro atualiza automaticamente um token de acesso expirado usando o token de atualização, sem exigir que o usuário reautorize. Todos os dados armazenados para esta integração são criptografados em repouso com AES de 256 bits.

Dados de pré-visualização: A Miro armazena dois tipos de dados de pré-visualização: as imagens capturadas pelo seletor de ativos (armazenadas como parte do board) e os títulos e referências de imagem (armazenados de forma criptografada em um serviço interno).

Revogar um token

Admins do Microsoft Entra podem revogar o acesso da integração: veja o guia da Microsoft para revogar o acesso de aplicativos.

Perguntas frequentes

Como faço para desativar a integração?

Um admin do Microsoft Entra pode revogar as permissões da integração da Miro excluindo o aplicativo: vá para Aplicativos corporativos > Todos os aplicativos, selecione o aplicativo Contenthub Power BI Integration e, em seguida, Propriedades > Excluir.

Quais usuários podem incorporar conteúdo do Power BI no Miro?

O usuário e o board devem atender aos dois critérios a seguir:

• O usuário autorizou a integração Miro com o Power BI.
• O usuário tem acesso ao conteúdo do Power BI que está tentando incorporar.

Quais usuários podem visualizar o conteúdo do Power BI incorporado?

Qualquer pessoa com acesso ao board da Miro e permissão do titular do conteúdo incorporado, ou seja, qualquer pessoa com permissão de visualização, comentário ou edição no board. Visualizadores não precisam autorizar a integração nem ter licença do Power BI para visualizar o conteúdo incorporado no board.

Os usuários precisam autorizar novamente para colar links em outros boards?

Não, desde que a autorização ainda seja válida (a Miro considera uma autorização válida por um mês após ser concedida). Os usuários podem colar links do Power BI em qualquer board, e o conteúdo é importado normalmente.

Se o board pertencer a um time ou organização diferente onde essa integração não estiver ativada, o usuário não poderá usá-la lá.

Posso acessar conteúdo do Power BI pela Miro que eu não consigo acessar diretamente no Power BI?

Não. Só é possível inserir conteúdo do Power BI ao qual você já tem acesso, não é possível usar a integração para ver algo que você não poderia abrir diretamente no Power BI. Dito isso, se alguém com acesso já inseriu o conteúdo como uma imagem estática em um board que você compartilha com essa pessoa, você pode ver esse snapshot mesmo sem acesso direto ao arquivo de origem. A integração não aplica políticas de acesso adicionais além disso; use as próprias configurações de compartilhamento do board da Miro para restringir quem pode colaborar. Observe que um snapshot em imagem estática não pode ser usado para explorar os dados subjacentes, abrir o relatório original nem alterar filtros.

Onde posso encontrar o Adendo de Processamento de Dados da Miro?

Leia o Adendo de Processamento de Dados da Miro.

O que é proibido em boards públicos da Miro?

Por motivos de segurança, os boards públicos desabilitam:

• Extração de ativos, compatível com as integrações do Looker, Google Slides, Figma, Power BI, Microsoft Word, Microsoft Excel e Microsoft PowerPoint.
• Exibição direta de ativos (ativo em vez de Live Embed), compatível com a integração Figma.

Como posso restringir o acesso ao board às mesmas pessoas que têm acesso ao arquivo de origem?

A integração gerencia apenas o acesso aos arquivos no sistema de origem (Power BI), não na Miro. Por padrão, isso não é aplicado, para manter esse nível de segurança os admins da organização da Miro devem desabilitar o seletor de ativos nas configurações de admin do app (veja Considerações de segurança).

Desativar o seletor de ativos evita que o conteúdo do Power BI seja salvo como imagens estáticas em um board da Miro, onde essas imagens poderiam depois ser vistas por pessoas que não têm acesso a esse conteúdo no Power BI (por exemplo, se o board for compartilhado publicamente ou com pessoas sem acesso à fonte).