A integração com Microsoft 365 permite que os usuários incorporem arquivos do Microsoft Word, Excel e PowerPoint (armazenados no SharePoint ou no OneDrive de contas de trabalho ou escola) 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
- Live Embed: Usuários podem incorporar um arquivo do Word, Excel ou PowerPoint em um board da Miro como um iframe ao vivo.
- Secure: Todos os visitantes do board são solicitados a fazer login no iframe antes de poderem visualizar o conteúdo incorporado.
- Display options: Usuários podem optar por exibir o conteúdo incorporado como Live Embed ou como marcador.
- Focus mode: Usuários podem expandir um Live Embed ou marcador para o modo foco e visualizá-lo sem distrações.
- Action shortcut: Usuários podem adicionar um atalho de ação que abre um diálogo para incorporar um link do Microsoft 365.
- Seletor de ativos: Os usuários podem adicionar uma página, planilha ou slide específicos como imagem estática no board, para que os colaboradores possam visualizar e consultar exatamente esse conteúdo sem precisar de 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 Microsoft 365 como imagens estáticas.
Requisitos e limitações
- Requer uma conta Microsoft 365 empresarial (baseada em SharePoint) com Word, Excel ou PowerPoint. Contas pessoais da Microsoft não são compatíveis.
Configurar a integração do Microsoft 365
Pré-requisitos
- Um Admin da empresa aprovou a integração do Microsoft 365 na sua organização da Miro.
- Você tem acesso de admin no Microsoft Entra para aprovar a integração no tenant Microsoft da sua organização.
Aprovar a integração no Microsoft Entra
A versão atual do aplicativo Miro Microsoft 365 exige consentimento de administrador para ser instalada no tenant Microsoft do cliente.
- Faça login no Microsoft Entra como admin e vá até Aplicativos empresariais > Consentimento e permissões.
- Selecione Sim para Os usuários podem solicitar o consentimento do admin para aplicativos aos quais não podem dar consentimento.
- Em Quem pode revisar as solicitações de consentimento do admin, escolha os usuários, funções ou grupos que devem poder revisar essas solicitações.
- Depois de configurado, um usuário não admin pode colar um link do Microsoft 365 em um board da Miro (em um time com a integração ativada) para acionar uma solicitação de aprovação.
- Os admins selecionados no passo 3 podem ir para Enterprise applications > Admin consent requests para revisar e aprovar a solicitação. Uma vez aprovada, a integração fica disponível para qualquer usuário do locatário autorizar por conta própria.
Instalar e autorizar a integração na Miro
Observação: Somente admins do time da Miro podem instalar o app. Se a sua organização da Miro permite apenas apps aprovados, e um usuário comum colar um link do Microsoft 365, esse usuário verá, em vez disso, uma caixa de diálogo de solicitação de instalação do app.
- Copie a URL do arquivo do Word, Excel ou PowerPoint.
- 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 é exibido sem ação adicional.
-
Um usuário comum cola o link, e a organização permite apenas apps aprovados: Abre-se um 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 de apps para aprovar a solicitação.
Conectar uma conta do Microsoft 365
Após a integração ser 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 Microsoft 365.
- Confirme a autorização no lado da Microsoft. O conteúdo do arquivo é adicionado ao seu board como um iframe.
Implementação técnica
A Miro integra-se ao Microsoft 365 por meio do Microsoft Graph REST API. Os usuários autorizam o acesso via OAuth 2.0 e, em seguida, vinculam seus arquivos do Word, Excel ou PowerPoint 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 Microsoft 365 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 adição de ativos a partir de incorporações vem 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 > Integração de documentos Microsoft (na guia Gerenciar apps).
- Alternar Impedir que usuários adicionem ativos de incorporações ao canvas.
Fluxo de dados
- Um usuário que pertence a um time ou a uma organização com essa funcionalidade ativada cola um link do Microsoft 365 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 da Microsoft.
- 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 Microsoft Graph REST API e recuperar o conteúdo.
Quais dados do Microsoft 365 a Miro armazena
A Miro busca e armazena os seguintes dados a partir de links do Microsoft 365 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 para todos os dados dos clientes.
Autenticação e autorização
Incorporar um link do Microsoft 365 em um board requer que o usuário autorize a integração por meio da API OAuth da Microsoft. Também é necessário 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 Microsoft 365 requer os seguintes escopos:
-
offline_access— necessário para renovar tokens. -
Files.ReadWrite— permite que o app leia, crie, atualize e exclua os arquivos do usuário que iniciou sessão. -
Files.ReadWrite.All— permite que o app leia, crie, atualize e exclua todos os arquivos aos quais o usuário que iniciou sessão tem acesso. -
Sites.ReadWrite.All— permite que o app edite ou exclua documentos e itens de lista em todas as coleções de sites em nome do usuário que iniciou sessão.
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 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 criptografados em um serviço interno).
Revogação de token
Admins do Microsoft Entra podem revogar o acesso da integração — consulte o guia da Microsoft para revogar o acesso de aplicativos (externo).
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 Enterprise applications > All applications, selecione o aplicativo Contenthub Microsoft Integration, em seguida Properties > Delete.
Quais usuários podem inserir conteúdo do Microsoft 365 em um board da Miro?
O usuário e o board da Miro devem atender a ambos os critérios:
- O usuário autorizou a integração da Miro com o Microsoft 365.
- O usuário tem acesso ao conteúdo do Microsoft 365 que está tentando inserir.
Quais usuários podem visualizar o conteúdo do Microsoft 365 incorporado?
Qualquer pessoa com acesso ao board da Miro e permissão do titular do conteúdo incorporado, isto é, quem tem permissão para visualizar, comentar ou editar no board. Visualizadores não precisam autorizar a integração nem possuir licença do Microsoft 365 para ver 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). Usuários podem colar links do Microsoft 365 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, por meio da Miro, conteúdo do Microsoft 365 que não consigo abrir diretamente no Microsoft?
Não. Você só pode inserir conteúdo do Microsoft 365 ao qual já tem acesso; não é possível usar a integração para ver algo que você não poderia abrir diretamente no Microsoft. No entanto, se alguém com acesso já tiver inserido 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 impõe políticas de acesso adicionais além disso; use as configurações de compartilhamento do próprio board da Miro para restringir quem pode colaborar. Observe que um snapshot de imagem estática não pode ser usado para explorar o documento subjacente, 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, boards públicos desabilitam:
- Extração de ativos: suportado 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): suportado 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 (Microsoft 365), não o acesso no 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 (veja Considerações de segurança).
Desativar o asset picker impede que conteúdo do Microsoft 365 seja salvo como imagens estáticas em um board da Miro, onde pode depois ser visualizado por pessoas que não têm acesso a ele no Microsoft 365 (por exemplo, se o board for compartilhado publicamente ou com pessoas que não têm acesso à fonte).