Personnes: admins d’entreprise
L’intégration Looker permet aux utilisateurs d’intégrer des tableaux de bord et des Explores Looker dans des tableaux Miro. Ce guide couvre la configuration, la mise en œuvre technique de l’intégration, le modèle de sécurité et la gestion 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 un tableau de bord ou un Explore Looker dans un tableau Miro sous forme d’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é sous forme d’intégration en direct ou sous forme de signet.
- Mode immersif : Les utilisateurs peuvent ouvrir 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 ouvrant une boîte de dialogue pour intégrer un lien Looker.
- Sélecteur d’éléments : Les utilisateurs peuvent ajouter un graphique ou une tuile spécifique en tant qu’image statique sur le tableau, afin que les collaborateurs puissent consulter et se référer à ce contenu exact sans avoir besoin d’accéder au fichier source.
- Contrôles admin : Les admins peuvent empêcher les utilisateurs d’utiliser le sélecteur d’éléments pour ajouter du contenu Looker sous forme d’images statiques.
Restrictions
- Looker Studio n’est pas pris en charge.
- Les Looks de Looker ne sont pas pris en charge.
- L’intégration de requêtes fusionnées Looker ou de liens vers des tableaux Looker n’est pas prise en charge.
- Les images ajoutées avec le sélecteur d’éléments ne peuvent pas être actualisées.
Problèmes connus
Les utilisateurs déjà authentifiés dans un navigateur ou dans l’application de bureau Miro peuvent rencontrer des problèmes d’authentification lorsqu’ils passent à un autre navigateur ou à l’application Miro. Cela peut interrompre le flux d’authentification et empêcher l’accès à Looker.
Configurer l’intégration Looker
Prérequis
- Un admin d’entreprise a approuvé Looker pour votre organisation Miro.
- Vous disposez de l’accès admin Looker nécessaire pour enregistrer Miro en tant qu’application OAuth dans Looker.
Enregistrer l’application OAuth dans Looker
- Dans le Marketplace Looker, trouvez et sélectionnez API Explorer extension, puis cliquez sur Install.
- Allez dans Home > Applications > API Explorer.
- Dans la zone de recherche d’API Explorer, tapez
oauth, puis sélectionnez Register OAuth App sous Auth. - Sélectionnez Exécuter en haut à droite de la page.
-
Dans le formulaire de requête, saisissez les valeurs suivantes :
-
client_guid :
15609152-a12a-4fa1-b364-337e7896d25d -
Corps :
{ "redirect_uri": "https://integrations.miro.com/api/contenthub/public/oauth/callback", "display_name": "Miro", "description": "Miro Looker Integration", "enabled": true, "group_id": "" } - Laissez les champs vides.
Pour des options plus avancées — par exemple, pour restreindre l’autorisation à un groupe Looker spécifique avec
group_id— consultez la documentation Looker sur l’enregistrement d’une application OAuth (externe). -
client_guid :
- Sélectionnez Je comprends que ce point de terminaison de l’API modifiera des données.
- Sélectionnez Exécuter. Une exécution réussie renvoie le corps de la requête et une réponse HTTP 200.
Si le corps renvoyé inclut"enabled": false, exécutez Mettre à jour l’application OAuth avec les mêmes valeurs pour activer le client.
Installer et autoriser l’intégration dans Miro
REMARQUE : Seuls les admins d’équipe Miro peuvent installer l’application. Si votre organisation Miro n’autorise que les applications approuvées, lorsqu’un utilisateur régulier colle un lien Looker, il voit à la place une boîte de dialogue pour demander l’installation de l’application.
- Copiez l’URL du tableau de bord ou de l’Explore Looker.
- Collez l’URL sur votre tableau Miro.
- La suite dépend de la personne qui a collé le lien :
- Un admin d’équipe colle le lien : L’application est autorisée et installée automatiquement, et l’aperçu du lien s’affiche 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 s’ouvre. Une fois 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 Looker
Après l’installation et l’autorisation de l’intégration :
- Cliquez sur Connecter sur 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 Looker.
- Confirmez l’autorisation depuis Looker. Le contenu Looker est ajouté à votre tableau sous forme d’une iFrame.
Implémentation technique
Miro s’intègre à Looker via l’API REST de Looker. Les utilisateurs autorisent l’accès avec OAuth 2.0, puis lient leurs tableaux de bord Looker ou leurs Explores à un tableau Miro.
Considérations de sécurité
Le sélecteur d’éléments de l’intégration permet aux utilisateurs d’attacher un graphique ou une tuile Looker au canevas sous forme d’image statique. Seuls les utilisateurs autorisés peuvent accéder à l’intégration en direct, mais toute personne ayant accès au tableau peut consulter l’image statique jointe. Par défaut, l’ajout d’éléments depuis des contenus intégrés est désactivé sur les tableaux publics.
Les admins d’entreprise peuvent désactiver le sélecteur d’éléments pour tous les tableaux :
- Accédez à Paramètres de l’entreprise > Applications et intégrations > Applications > Unfurl Looker (sous l’onglet Gérer les applications).
- Activez/désactivez Empêcher les utilisateurs d’ajouter des éléments provenant des contenus intégrés au canevas.
Flux de données
- Un utilisateur appartenant à une équipe ou une organisation pour laquelle cette fonctionnalité est activée colle un lien Looker sur un tableau Miro.
- 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 Looker.
- Une fois l’autorisation accordée, le service d’intégration de Miro utilise le jeton d’accès de l’utilisateur pour appeler l’API REST de Looker et récupérer le contenu.
Données Looker stockées par Miro
Miro récupère et stocke les données suivantes à partir des liens Looker collés :
- Titres des tableaux de bord et des Explores
- Images créées par l’asset picker
Conservation des données
Les données intégrées sont soumises à la politique de conservation standard de Miro pour l’ensemble des données clients.
Authentification et autorisation
L’insertion d’un lien Looker dans un tableau exige que l’utilisateur autorise l’intégration via l’API OAuth de Looker. Cela nécessite également qu’un admin Looker enregistre Miro en tant qu’application OAuth — voir Enregistrer l’application OAuth dans Looker ci‑dessus.
Étendues d’autorisation requises
L’intégration Looker nécessite l’étendue d’autorisation suivante :
apiCe 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 le jeton d’accès et le jeton d’actualisation dans sa base de données pendant plusieurs jours. Tant que l’autorisation est active, Miro renouvelle automatiquement un jeton d’accès expiré en utilisant le jeton d’actualisation, sans que l’utilisateur ait à 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 stocke deux types de données d’aperçu : les images capturées par le sélecteur d’éléments (stockées dans le tableau) et les titres ainsi que les références d’images (stockés chiffrés dans un service interne).
Révocation d’un jeton
Les administrateurs Looker peuvent révoquer l’accès de l’intégration depuis la console d’admin Looker :
- Accédez à Administration > Utilisateurs.
- Sélectionnez l’utilisateur.
- Faites défiler jusqu’à Clés API et sélectionnez Supprimer à côté du jeton.
Foire aux questions
Comment désactiver l’intégration ?
Supprimez l’application OAuth Miro de Looker. Cela ne supprime pas les données Looker déjà intégrées dans les tableaux Miro, mais empêche les utilisateurs d’intégrer de nouveaux contenus ou de rafraîchir les éléments existants.
Quels utilisateurs peuvent intégrer du contenu Looker dans Miro ?
L’utilisateur et le tableau Miro doivent répondre aux deux critères suivants :
- L’utilisateur a autorisé l’intégration Looker dans Miro.
- L’utilisateur a accès au contenu Looker qu’il tente d’intégrer.
Quels utilisateurs peuvent consulter le contenu Looker 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 autorisations de consultation, de commentaire ou de modification sur le tableau. Les lecteurs n’ont pas besoin d’autoriser l’intégration ni de posséder une licence Looker 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 une autorisation comme valide pendant un mois après son octroi). Les utilisateurs peuvent coller des liens Looker sur n’importe quel tableau, et le contenu s’importe 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.
Puis-je accéder via Miro à du contenu Looker auquel je n’ai pas accès directement dans Looker ?
Non. Vous ne pouvez intégrer que du contenu Looker auquel vous avez déjà accès — l’intégration ne vous permet pas de voir quelque chose que vous ne pourriez pas ouvrir directement dans Looker. Cela dit, si une personne disposant des droits a déjà intégré ce contenu sous la forme d’une image statique sur un tableau que vous partagez avec elle, vous pouvez consulter cette image statique même sans accès direct au fichier source. L’intégration n’applique pas d’autres règles d’accès ; utilisez les paramètres de partage du tableau Miro pour restreindre qui peut collaborer. Notez qu’une image statique ne permet pas d’explorer les données sous-jacentes, d’ouvrir le graphique d’origine ni de modifier les filtres.
Où puis-je trouver le Miro Data Processing Addendum ?
Consultez l’Addendum relatif au traitement des données de Miro.
Qu’est‑ce qui est interdit sur les tableaux Miro publics ?
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.
- Prévisualisation directe d’éléments (prévisualisation de l’élément au lieu d’une intégration en direct) — prise en charge par l’intégration Figma.
Comment puis-je restreindre l’accès au tableau aux mêmes personnes qui ont accès au fichier source ?
L’intégration gère uniquement l’accès aux fichiers depuis le système source (Looker), et non depuis Miro. Par défaut, cela n’est pas appliqué — pour garantir ce niveau de sécurité, les admins d’organisation Miro doivent désactiver le sélecteur d’assets dans les paramètres d’administration de l’application (voir Considérations de sécurité).
La désactivation du sélecteur d’assets empêche que le contenu Looker soit enregistré sous forme d’images statiques sur un tableau Miro, où il pourrait ensuite être consulté par des personnes n’ayant pas accès à ce contenu dans Looker (par exemple si le tableau est partagé publiquement ou avec des personnes dépourvues d’accès à la source).