Box (documentation admin)

Personnes : admins d’entreprise, admins d’équipe
Plateformes : Navigateur, Bureau

L’intégration Box permet aux utilisateurs d’intégrer des fichiers Box dans les tableaux Miro. Ce guide couvre la mise en œuvre technique de l’intégration, son modèle de sécurité et le traitement des données pour les admins qui évaluent ou configurent l’intégration.

Fonctionnalités principales

• Intégration en direct : Les utilisateurs peuvent intégrer du contenu Box dans un tableau Miro sous forme d’un iFrame en direct.
• Sécurisé : Tout visiteur du tableau est invité à se connecter à l’iFrame avant de pouvoir consulter le contenu intégré.
• Options d’affichage : Les utilisateurs peuvent choisir d’afficher le contenu intégré en tant qu’intégration en direct ou en tant que signet.
• Mode immersif : Les utilisateurs peuvent agrandir une intégration en direct ou un signet en mode immersif pour la consulter sans distractions.
• Raccourci d’action : Les utilisateurs peuvent ajouter un raccourci d’action qui ouvre une boîte de dialogue pour intégrer un lien Box.

Restrictions

• Le sélecteur d’éléments n’est pas disponible pour cette intégration.

Implémentation technique

Miro s’intègre à Box via l’API REST de Box. Les utilisateurs autorisent l’accès via OAuth 2.0, puis associent leurs fichiers Box à un tableau Miro.

Flux de données

1. Un utilisateur appartenant à une équipe ou à une organisation pour laquelle cette fonctionnalité est activée colle un lien Box sur un tableau Miro.
2. Miro lit le lien. Si l’utilisateur n’a pas encore autorisé l’intégration, Miro lance le flux OAuth et redirige l’utilisateur vers la page d’autorisation de Box.
3. Après que l’utilisateur a accordé l’autorisation, le service d’intégration de Miro utilise le jeton d’accès de l’utilisateur pour appeler l’API REST de Box et récupérer le contenu.

Quelles données Box Miro stocke

Miro récupère et stocke les données suivantes à partir des liens Box collés :

• Titres des documents et fichiers

Conservation des données

Les données intégrées suivent la politique de conservation standard de Miro pour l’ensemble des données client.

Authentification et autorisation

L’intégration d’un lien Box dans un tableau nécessite que l’utilisateur autorise l’intégration via l’écran de consentement OAuth de Box. Selon la configuration Box du client, un admin Box peut également devoir approuver l’intégration.

Portées d’autorisation requises

L’intégration Box requiert la portée d’autorisation suivante :

• root_readonly — lire tous les fichiers et dossiers stockés dans Box.

Ce qui est stocké dans Miro et comment

Miro stocke deux catégories de données pour cette intégration : les données d’autorisation et les données d’aperçu.

• Données d’autorisation : Miro stocke l’access token et le refresh token dans sa base de données pendant plusieurs jours. Tant que l’autorisation est active, Miro renouvelle automatiquement un access token expiré à l’aide du refresh token, sans que l’utilisateur ait besoin de se réautoriser. Toutes les données stockées pour cette intégration sont chiffrées au repos à l’aide de l’AES 256 bits.
• Données d’aperçu : Miro enregistre les titres des éléments au sein du tableau Miro, et stocke les titres ainsi que les références d’images chiffrés dans un service interne.

Révocation d’un jeton

Les utilisateurs peuvent déconnecter l’intégration Box à tout moment depuis les paramètres de leur compte Box.

Configurer l’intégration Box

REMARQUE : Seuls les admins d’équipe Miro peuvent installer l’application. Si votre organisation Miro n’autorise que les applications approuvées et qu’un utilisateur régulier colle un lien Box, cet utilisateur voit à la place une boîte de dialogue de demande d’installation de l’application.

Pour installer et commencer à utiliser l’intégration :

1. Copiez l’URL du fichier Box.
2. Collez l’URL sur votre tableau Miro.

3. Ce qui se passe ensuite dépend de la personne qui a collé le lien :

   • Un admin d’équipe Miro colle le lien : L’application est autorisée et installée automatiquement et le lien s’affiche en aperçu sans autre action.
   • Un utilisateur colle le lien, et l’organisation n’autorise que les applications approuvées : Une boîte de dialogue de demande d’installation d’application s’ouvre. Après que l’utilisateur a demandé l’autorisation, les admins d’entreprise peuvent suivre l’article Flux de demande d’application pour approuver la demande.

   

Connecter un compte Box

Après l’installation et l’autorisation de l’intégration :

1. Cliquez sur Connecter dans le widget créé après avoir collé l’URL sur le tableau. Vous êtes redirigé vers une page vous demandant d’accorder à Miro l’accès à votre compte Box.
2. Saisissez vos identifiants Box et cliquez sur Autoriser.
3. Cliquez sur Accorder l’accès à Box pour permettre à Miro d’accéder à vos fichiers Box.

Une fois connecté, votre fichier est intégré au tableau avec toutes les fonctionnalités de Box. Vous pouvez commenter, annoter et relire des documents directement dans l’élément intégré, et les modifications sont reflétées en temps réel, ce qui permet à votre équipe de collaborer sans quitter le tableau.

ASTUCE : Ouvrez le contenu intégré en mode immersif pour consulter et interagir avec le document dans une vue plus grande et sans distractions.

FAQ

Quels utilisateurs peuvent intégrer du contenu Box dans Miro ?

L’utilisateur et le tableau Miro doivent satisfaire aux deux critères suivants :

• L’utilisateur a autorisé l’intégration Box pour Miro.
• L’utilisateur dispose d’un accès au contenu Box qu’il souhaite intégrer.

Quels utilisateurs peuvent consulter le contenu Box intégré ?

Toute personne ayant accès au tableau Miro et l’autorisation du propriétaire du contenu intégré — c’est‑à‑dire toute personne disposant des droits de consulter, commenter ou modifier sur le tableau. Les lecteurs n’ont pas besoin d’autoriser l’intégration ni de posséder une licence Box pour consulter le contenu intégré sur le tableau.

Les utilisateurs doivent‑ils se réautoriser pour coller des liens sur d’autres tableaux ?

Non, tant que l’autorisation est toujours valide (Miro considère qu’une autorisation reste valide pendant un mois après son octroi). Les utilisateurs peuvent coller des liens Box sur n’importe quel tableau, et le contenu est importé normalement.

Si le tableau appartient à une autre équipe ou organisation où cette intégration n’est pas activée, l’utilisateur ne peut pas l’utiliser sur ce tableau.

Puis‑je accéder à du contenu Box via Miro que je ne peux pas ouvrir directement dans Box ?

Non. Vous ne pouvez intégrer que le contenu Box auquel vous avez déjà accès — vous ne pouvez pas utiliser l’intégration pour consulter quelque chose que vous ne pourriez pas autrement ouvrir dans Box. Cela dit, si quelqu’un ayant accès a déjà intégré le contenu sous forme d’image statique sur un tableau que vous partagez avec cette personne, vous pouvez consulter cet instantané même sans accès direct au fichier source. L’intégration n’applique pas de politiques d’accès supplémentaires ; utilisez les paramètres de partage du tableau Miro pour restreindre qui peut collaborer. Notez qu’un instantané d’image statique ne permet pas d’explorer les données sous-jacentes, d’ouvrir le fichier original ni de modifier les filtres.

Où puis-je trouver l’Addendum sur le traitement des données de Miro ?

Voir l’Addendum sur le traitement des données de Miro.

Qu’est-ce qui est interdit sur les tableaux publics Miro ?

Pour des raisons de sécurité, les tableaux publics désactivent :

• Extraction d’éléments — prise en charge par les intégrations Looker, Google Slides, Figma, Power BI, Microsoft Word, Microsoft Excel et Microsoft PowerPoint.
• Affichage direct des éléments (élément au lieu d’une intégration en direct) — pris en charge par l’intégration Figma.