Pessoas: Admins da empresa, admins do time
Plataformas: Navegador, Desktop
A integração do Google Workspace permite que os usuários incorporem conteúdo do Google Docs, Sheets e Slides em boards da Miro. Este guia cobre a implementação técnica da integração, o modelo de segurança e o tratamento de dados para admins que estão avaliando ou configurando a integração.
Principais funcionalidades
- Live Embed: Os usuários podem incorporar conteúdo de Documentos, Planilhas ou Slides do Google 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: Os usuários podem escolher exibir o conteúdo incorporado como Live Embed ou como marcador.
- Modo foco: Os usuários podem expandir um Live Embed ou um marcador em modo foco para visualizá-lo sem distrações.
- Atalho de ação: Os usuários podem adicionar um atalho que abre um diálogo para incorporar um link de Documentos, Planilhas ou Slides do Google.
- Seletor de ativos: Os usuários podem adicionar um slide específico como imagem estática no board, para que os colaboradores possam visualizar e consultar esse conteúdo exato sem precisar ter acesso ao arquivo de origem.
- Controles do admin: Os admins podem impedir que os usuários usem o seletor de ativos para adicionar conteúdo do Google Slides como imagens estáticas.
Restrições
- O seletor de ativos está disponível apenas para Google Slides. Não está disponível para Google Docs nem para Google Sheets.
Implementação técnica
A Miro integra-se ao Google Workspace por meio da API REST do Google. Os usuários autorizam o acesso com OAuth 2.0 e, em seguida, vinculam seus arquivos do Google Docs, Google Sheets ou Google Slides a um board da Miro.
Considerações de segurança
O seletor de ativos da integração permite que usuários anexem parte de um arquivo do Google Slides ao canvas como uma imagem estática. Apenas usuários autorizados podem acessar o Live Embed, mas qualquer usuário com acesso ao board pode visualizar a imagem estática anexada. A adição de ativos a partir de incorporações é 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 > Apps e integrações > Apps > Google Office Integration App (na guia Gerenciar apps).
- Alterne Impedir que usuários adicionem ativos a partir de incorporações ao canvas.
Fluxos de dados
- Um usuário que pertence a um time ou organização com essa funcionalidade ativada cola um link do Google Documentos, Planilhas ou Slides 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 Google.
- 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 API REST do Google e recuperar o conteúdo.
Quais dados do Google a Miro armazena
A Miro busca e armazena os seguintes dados de links do Google Workspace colados:
- Títulos de documentos e arquivos
- 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 aplicada a todos os dados dos clientes.
Autenticação e autorização
Incorporar um link do Google Documentos, Planilhas ou Slides em um board requer que o usuário autorize a integração pela tela de consentimento do OAuth do Google. Dependendo da configuração do Google Workspace do cliente, isso também pode exigir que um admin do Google Workspace aprove a integração.
Escopos de autorização necessários
A integração com o Google Workspace requer os seguintes escopos:
https://www.googleapis.com/auth/presentations.readonly https://www.googleapis.com/auth/spreadsheets.readonly https://www.googleapis.com/auth/documents.readonly
O que é armazenado na Miro 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 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 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).
Revogação de token
Os usuários podem revogar o acesso da integração a qualquer momento na conta do Google, seguindo o Guia do Google Identity.
Configurar a integração com o Google Workspace
Nota: Somente os admins do time da Miro podem instalar o aplicativo. Se a sua organização na Miro permite apenas aplicativos aprovados e um usuário comum colar um link do Google Workspace, esse usuário verá um diálogo de solicitação de instalação do aplicativo.
Para instalar e começar a usar a integração:
- Copie a URL do arquivo do Google Docs, Google Sheets ou Google Slides.
- 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 o link é expandido sem ação adicional.
- Um usuário cola o link e a organização permite apenas apps aprovados: Abre uma caixa de diálogo de solicitação de instalação do app. Após o usuário solicitar permissão, os Admins da empresa podem seguir o artigo fluxo de solicitação do app para aprovar a solicitação.
Conectar uma conta do Google
Após a integração ser instalada e autorizada:
- Clique em Conectar no widget criado após colar a URL no board. Você será redirecionado para uma página do Google pedindo que conceda à Miro acesso à sua conta.
- Confirme a autorização no Google. O conteúdo do Google é adicionado ao seu board como um iframe.
Perguntas frequentes
Quais usuários podem incorporar conteúdo do Google na Miro?
O usuário e o board devem atender a ambos os critérios:
- O usuário autorizou a integração do Google Workspace com a Miro.
- O usuário tem acesso ao conteúdo do Google que está tentando incorporar.
Quais usuários podem visualizar o conteúdo do Google incorporado?
Qualquer pessoa com acesso ao board da Miro e permissão do titular do conteúdo incorporado, isto é, qualquer pessoa com permissões de visualização, de comentário ou de edição no board. Visualizadores não precisam autorizar a integração nem ter licença do Google 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 uma autorização válida por um mês após sua concessão). Os usuários podem colar links do Google Workspace em qualquer board, e o conteúdo é importado normalmente.
Se o board pertencer a um time ou organização diferente onde esta integração não estiver ativada, o usuário não poderá usá-la lá.
Posso acessar pela Miro conteúdo do Google que não consigo acessar diretamente no Google?
Não. Você só pode incorporar conteúdo do Google ao qual já tem acesso; não é possível usar a integração para ver algo que você não poderia abrir diretamente no Google. Dito isso, se alguém com acesso já tiver incorporado o conteúdo como uma imagem estática em um board que você compartilha com essa pessoa, você poderá ver esse snapshot mesmo sem acesso direto ao arquivo de origem. A integração não aplica políticas de acesso adicionais além desta; use as configurações de compartilhamento do board para restringir quem pode colaborar. Observe que um snapshot de imagem estática não pode ser usado para explorar os dados subjacentes, abrir o arquivo original ou alterar filtros.
Onde posso encontrar o Adendo de Processamento de Dados da Miro?
Consulte o Adendo de Processamento de Dados da Miro.
O que é proibido em boards públicos da Miro?
Por motivos de segurança, em boards públicos ficam desabilitados:
- 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 aos arquivos no sistema de origem (Google), 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 asset picker nas configurações de admin do app.
Desabilitar o asset picker impede que conteúdo do Google seja salvo como imagens estáticas em um board da Miro, onde mais tarde poderia ser visto por pessoas que não têm acesso a ele no Google (por exemplo, se o board for compartilhado publicamente ou com pessoas que não têm acesso ao arquivo de origem).