Pessoas: Admins da empresa
A integração com o Looker permite que usuários incorporem painéis e Explores do Looker em boards da Miro. Este guia aborda a configuração, a implementação técnica da integração, o modelo de segurança e o tratamento de dados para admins que estejam avaliando ou configurando a integração.
Principais funcionalidades
- Incorporação ao vivo: Os usuários podem incorporar um painel ou Explore do Looker em um board da Miro como um iframe ao vivo.
- Seguro: Todo visitante do board é solicitado a fazer login no iframe antes de poder visualizar o conteúdo incorporado.
- Opções de exibição: Usuários podem escolher exibir o conteúdo incorporado como Live Embed ou como marcador.
- Modo foco: Usuários podem expandir um Live Embed ou um marcador para o modo foco e visualizá-lo sem distrações.
- Atalho de ação: Usuários podem adicionar um atalho de ação que abre uma caixa de diálogo para inserir um link do Looker.
- Seletor de ativos: Usuários podem adicionar um gráfico ou bloco específico como imagem estática no board, para que os colaboradores possam ver e consultar exatamente esse conteúdo sem precisar de acesso ao arquivo de origem.
- Controles de admin: Admins podem impedir que usuários usem o seletor de ativos para adicionar conteúdo do Looker como imagens estáticas.
Restrições
- O Looker Studio não é compatível.
- Looker Looks não são compatíveis.
- Não é possível incorporar consultas merge do Looker ou links de board do Looker.
- Imagens adicionadas com o seletor de ativos não podem ser atualizadas.
Problemas conhecidos
Usuários que já estão autenticados em um navegador ou no aplicativo para desktop da Miro podem enfrentar problemas de autenticação ao alternar para outro navegador ou para o aplicativo da Miro. Isso pode interromper o fluxo de autenticação e impedir o acesso ao Looker.
Configurar a integração com o Looker
Pré-requisitos
- Um admin da empresa aprovou o Looker para sua organização na Miro.
- Você tem acesso de admin no Looker para registrar o Miro como um app OAuth no Looker.
Registrar o app OAuth no Looker
- No Marketplace do Looker, localize e selecione Extensão API Explorer, depois selecione Instalar.
- Vá para Início > Aplicativos > API Explorer.
- Na caixa de busca do API Explorer, digite
oauth, em seguida selecione Registrar app OAuth em Auth. - Selecione Run It no canto superior direito da página.
-
No formulário de requisição, insira os seguintes valores:
-
client_guid:
15609152-a12a-4fa1-b364-337e7896d25d -
body:
{ "redirect_uri": "https://integrations.miro.com/api/contenthub/public/oauth/callback", "display_name": "Miro", "description": "Miro Looker Integration", "enabled": true, "group_id": "" } - Deixe fields vazios.
Para opções mais avançadas, por exemplo, restringir a autorização a um grupo específico do Looker com
group_id, consulte a documentação do Looker sobre o registro de um aplicativo OAuth (externo). -
client_guid:
- Selecione Entendo que este endpoint da API alterará dados.
- Selecione Executar. Uma execução bem-sucedida retorna o corpo da requisição e uma resposta HTTP 200.
Se o corpo retornado incluir"enabled": false, execute Update OAuth App com os mesmos valores para ativar o cliente.
Instalar e autorizar a integração na Miro
OBSERVAÇÃO: Somente admins do time da Miro podem instalar o app. Se sua organização da Miro só permite apps aprovados e um usuário comum colar um link do Looker, esse usuário verá, em vez disso, uma caixa de diálogo para solicitar a instalação do app.
- Copie a URL do painel ou do Explore do Looker.
- Cole a URL no seu board da Miro.
- 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 a pré-visualização do link é exibida sem necessidade de ação adicional.
-
Um usuário comum cola o link e a organização permite apenas apps aprovados: Uma caixa de diálogo de solicitação de instalação do app é exibida. Depois que o usuário solicitar permissão, os Admins da empresa podem seguir o artigo Fluxo de solicitação de app para aprovar a solicitação.
Conectar uma conta do Looker
Depois que a integração estiver instalada e autorizada:
- Clique em Connect no widget criado após colar a URL no board. Você será redirecionado para uma página pedindo que conceda à Miro acesso à sua conta do Looker.
- Confirme a autorização no Looker. O conteúdo do Looker é adicionado ao seu board como um iframe.
Implementação técnica
A Miro integra-se ao Looker por meio da Looker REST API. Os usuários autorizam o acesso com OAuth 2.0 e, em seguida, vinculam seus painéis do Looker ou Explores a um board da Miro.
Considerações de segurança
O seletor de ativos da integração permite que usuários anexem um gráfico ou tile do Looker ao canvas como uma imagem estática. Apenas usuários autorizados podem acessar o Live Embed, mas qualquer pessoa com acesso ao board pode ver a imagem estática anexada. A opção de adicionar ativos a partir de incorporações está desabilitada por padrão em boards públicos.
Admins da Empresa podem desabilitar o seletor de ativos para todos os boards:
- Vá para Configurações da Empresa > Aplicativos e integrações > Aplicativos > Unfurl Looker (na guia Gerenciar aplicativos).
- Alterne Impedir que usuários adicionem ativos incorporados ao canvas.
Fluxos de dados
- Um usuário que pertence a um time ou organização com esta funcionalidade ativada cola um link do Looker em um board da Miro.
- 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 do Looker.
- 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 REST API do Looker e recuperar o conteúdo.
Quais dados do Looker a Miro armazena
A Miro busca e armazena os seguintes dados dos links do Looker colados:
- Títulos do painel e do Explore
- Imagens criadas pelo seletor de ativos
Retenção de dados
Os dados incorporados seguem a política de retenção padrão da Miro para todos os dados dos clientes.
Autenticação e autorização
Incorporar um link do Looker em um board requer que o usuário autorize a integração por meio da API OAuth do Looker. Isso também exige que um admin do Looker registre a Miro como um aplicativo OAuth — veja Registrar o aplicativo OAuth no Looker acima.
Escopos de autorização necessários
A integração com o Looker requer o seguinte escopo:
apiO que a Miro armazena e como
A Miro armazena duas categorias de dados para esta integração: dados de autorização e dados de unfurling.
Dados de autorização: A Miro armazena o access token e o refresh token em seu banco de dados por vários dias. Enquanto a autorização estiver ativa, a Miro atualiza automaticamente um access token expirado usando o refresh token, sem exigir que o usuário reautorize. Todos os dados armazenados para esta integração são criptografados em repouso usando AES de 256 bits.
Dados de unfurling: A Miro armazena dois tipos de dados de unfurling: as imagens capturadas pelo asset picker (armazenadas como parte do board) e os títulos e referências de imagem (armazenados de forma criptografada em um serviço interno).
Revogação de token
Os administradores do Looker podem revogar o acesso da integração no console de admin do Looker:
- Vá para Admin > Users.
- Selecione o usuário.
- Role até API Keys e selecione Delete ao lado do token.
Perguntas frequentes
Como desativar a integração?
Excluir o app OAuth da Miro no Looker. Isso não remove os dados do Looker já incorporados nos boards da Miro, mas impede que os usuários incorporem novo conteúdo ou atualizem ativos existentes.
Quais usuários podem incorporar conteúdo do Looker na Miro?
O usuário e o board da Miro devem atender a ambos os critérios:
- O usuário autorizou a integração Miro + Looker.
- O usuário tem acesso ao conteúdo do Looker que está tentando incorporar.
Quais usuários podem visualizar o conteúdo do Looker incorporado?
Qualquer pessoa com acesso ao board da Miro e permissão do titular do conteúdo incorporado, isto é, qualquer pessoa com permissão para visualizar, comentar ou editar o board. Os visualizadores não precisam autorizar a integração nem possuir licença do Looker para visualizar o conteúdo incorporado no board.
Os usuários precisam reautorizar para colar links em outros boards?
Não, desde que a autorização ainda seja válida (a Miro considera a autorização válida por um mês após ser concedida). Os usuários podem colar links do Looker em qualquer board e o conteúdo é importado normalmente.
If the board belongs to a different team or organization where this integration isn't enabled, the user can't use it there.
Can I access Looker content through Miro that I can't access directly in Looker?
No. You can only embed Looker content you already have access to — you can't use the integration to see something you couldn't otherwise open in Looker. That said, if someone with access has already embedded the content as a static image on a board you share with them, you can view that snapshot even without direct access to the source file. The integration doesn't enforce any additional access policies beyond this; use the Miro board's own sharing settings to restrict who can collaborate. Note that a static image snapshot can't be used to explore the underlying data, open the original chart, or change filters.
Where can I find the Miro Data Processing Addendum?
Consulte o Adendo de Processamento de Dados da Miro.
O que não é permitido em boards públicos da Miro?
Por motivos de segurança, boards públicos desabilitam:
- Extração de ativos, suportada pelas 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), suportada pela integração do 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 a arquivos no sistema de origem (Looker), e 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 administração do app (veja Considerações sobre segurança).
Desabilitar o seletor de ativos impede que conteúdo do Looker seja salvo como imagens estáticas em um board da Miro, onde depois poderia ser visto por pessoas que não têm acesso a ele no Looker (por exemplo, se o board for compartilhado publicamente ou com pessoas que não têm acesso ao conteúdo no Looker).