Personen: Unternehmens-Admins
Die Looker-Integration ermöglicht es Nutzern, Looker-Dashboards und Explores in Miro-Boards einzubetten. Diese Anleitung behandelt die Einrichtung, die technische Umsetzung der Integration, das Sicherheitsmodell und die Datenverarbeitung für Unternehmens-Admins, die die Integration bewerten oder konfigurieren.
Wichtige Funktionen
- Live-Einbettung: Nutzer können ein Looker-Dashboard oder Explore als Live-iFrame in ein Miro-Board einbetten.
- Sicher: Board-Besucher werden aufgefordert, sich im iFrame anzumelden, bevor sie den eingebetteten Inhalt ansehen können.
- Anzeigeoptionen: Nutzer können eingebettete Inhalte als Live-Einbettung oder als Lesezeichen anzeigen.
- Fokusmodus: Nutzer können eine Live-Einbettung oder ein Lesezeichen in den Fokusmodus erweitern, um das Element ohne Ablenkungen anzusehen.
- Schnellaktion: Nutzer können eine Schnellaktion hinzufügen, die ein Dialogfeld öffnet, um einen Looker-Link einzubetten.
- Asset-Picker: Nutzer können ein bestimmtes Diagramm oder eine Kachel als statisches Bild auf dem Board hinzufügen, damit Mitwirkende genau diesen Inhalt ansehen und darauf Bezug nehmen können, ohne Zugriff auf die Quelle zu benötigen.
- Admin-Einstellungen: Admins können verhindern, dass Nutzer den Asset-Picker verwenden, um Looker-Inhalte als statische Bilder hinzuzufügen.
Einschränkungen
- Looker Studio wird nicht unterstützt.
- Looker Looks werden nicht unterstützt.
- Das Einbetten von Looker-Merge-Abfragen oder Looker-Board-Links wird nicht unterstützt.
- Mit dem Asset Picker hinzugefügte Bilder lassen sich nicht aktualisieren.
Bekannte Probleme
Benutzer, die bereits in einem Browser oder in der Miro-Desktop-App authentifiziert sind, können beim Wechsel zu einem anderen Browser oder zur Miro-App auf Authentifizierungsprobleme stoßen. Das kann den Authentifizierungsablauf unterbrechen und den Zugriff auf Looker verhindern.
Looker-Integration einrichten
Voraussetzungen
- Ein Company Admin hat Looker für deine Miro-Organisation genehmigt.
- Du hast Looker-Adminrechte, um Miro in Looker als OAuth-App zu registrieren.
OAuth-App in Looker registrieren
- Suche im Looker Marketplace die API Explorer extension und wähle dann Install aus.
- Gehe zu Home > Applications > API Explorer.
- Gib im Suchfeld des API Explorer
oauthein und wähle dann unter Auth Register OAuth App aus. - Wähle oben rechts auf der Seite Ausführen aus.
-
Gib im Anfrageformular die folgenden Werte ein:
-
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": "" } - Lass fields leer.
Für erweiterte Optionen — zum Beispiel, um die Autorisierung auf eine bestimmte Looker-Gruppe mit
group_idzu beschränken — siehe die Looker-Dokumentation zur Registrierung einer OAuth-App (extern). -
client_guid:
- Wähle Ich verstehe, dass dieser API-Endpunkt Daten ändern wird aus.
- Wähle Ausführen aus. Bei erfolgreichem Ausführen werden der Request-Body und eine HTTP-200-Antwort zurückgegeben.
Wenn der zurückgegebene Body"enabled": falseenthält, führe OAuth-App aktualisieren mit denselben Werten aus, um den Client zu aktivieren.
Integration in Miro installieren und autorisieren
HINWEIS: Nur Team-Admins von Miro können die App installieren. Wenn deine Miro-Organisation nur genehmigte Apps zulässt und ein normaler Nutzer einen Looker-Link einfügt, sieht dieser stattdessen ein Dialogfeld für eine App-Installationsanfrage.
- Kopiere die URL des Looker-Dashboards oder von Explore.
- Füge die URL in dein Miro-Board ein.
- Wie es weitergeht, hängt davon ab, wer den Link eingefügt hat:
- Ein Miro-Team-Admin fügt den Link ein: Die App wird automatisch autorisiert und installiert, und der Link wird ohne weiteres Zutun als Vorschau angezeigt.
-
Ein regulärer Nutzer fügt den Link ein, und die Organisation erlaubt nur genehmigte Apps: Es öffnet sich ein Dialogfeld für eine App-Installationsanfrage. Nachdem der Nutzer die Erlaubnis angefordert hat, können Unternehmens-Admins dem Artikel Ablauf der App-Anfrage folgen, um die Anfrage zu genehmigen.
Looker-Konto verbinden
Nachdem die Integration installiert und autorisiert wurde:
- Klicke im Widget, das nach dem Einfügen der URL auf dem Board erstellt wurde, auf Verbinden. Du wirst zu einer Seite weitergeleitet, auf der du Miro Zugriff auf dein Looker-Konto gewähren sollst.
- Bestätige die Autorisierung auf der Looker-Seite. Der Looker-Inhalt wird als iFrame in dein Board eingefügt.
Technische Implementierung
Miro integriert Looker über die Looker REST API. Nutzer autorisieren den Zugriff mittels OAuth 2.0 und verknüpfen anschließend ihre Looker-Dashboards oder Explores mit einem Miro-Board.
Sicherheitsüberlegungen
Der Asset-Picker der Integration erlaubt es Nutzern, ein Looker-Diagramm oder eine Kachel als statisches Bild auf dem Canvas anzuhängen. Nur autorisierte Nutzer können die Live-Einbettung ansehen, aber jeder mit Zugriff auf das Board kann das angehängte statische Bild ansehen. Das Hinzufügen von Assets aus Einbettungen ist auf öffentlichen Boards standardmäßig deaktiviert.
Company-Admins können den Asset-Picker für alle Boards deaktivieren:
- Gehe zu Einstellungen für das Unternehmen > Apps und Integrationen > Apps > Unfurl Looker (unter dem Tab Apps verwalten).
- Schalte Verhindern, dass Nutzer Assets aus Einbettungen zum Canvas hinzufügen um.
Datenflüsse
- Ein Nutzer, der zu einem Team oder einer Organisation gehört, in der diese Funktion aktiviert ist, fügt einen Looker-Link in ein Miro-Board ein.
- Miro liest den Link. Wenn der Nutzer die Integration noch nicht autorisiert hat, startet Miro den OAuth-Ablauf und leitet den Nutzer zur Autorisierungsseite von Looker weiter.
- Nachdem der Nutzer die Autorisierung erteilt hat, verwendet der Integrationsdienst von Miro das Access-Token des Nutzers, um die Looker REST API aufzurufen und die Inhalte abzurufen.
Welche Looker-Daten Miro speichert
Miro ruft die folgenden Daten von eingefügten Looker-Links ab und speichert sie:
- Dashboard- und Explore-Titel
- Vom Asset-Picker erstellte Bilder
Datenaufbewahrung
Eingebettete Daten unterliegen der Standard-Datenaufbewahrungsrichtlinie von Miro für alle Kundendaten.
Authentifizierung und Autorisierung
Das Einbetten eines Looker-Links auf einem Board erfordert, dass der Nutzer die Integration über die OAuth-API von Looker autorisiert. Dafür muss außerdem ein Looker-Admin Miro als OAuth-App registrieren — siehe OAuth-App in Looker registrieren weiter oben.
Erforderliche Autorisierungsbereiche
Die Looker-Integration benötigt folgenden Scope:
apiWas in Miro gespeichert ist und wie
Miro speichert für diese Integration zwei Arten von Daten: Autorisierungsdaten und Unfurling-Daten.
Autorisierungsdaten: Miro speichert Access-Token und Refresh-Token für mehrere Tage in seiner Datenbank. Solange die Autorisierung aktiv ist, erneuert Miro abgelaufene Access-Token automatisch mithilfe des Refresh-Tokens, ohne dass sich der Nutzer erneut autorisieren muss. Alle für diese Integration gespeicherten Daten sind im Ruhezustand mit 256‑Bit‑AES verschlüsselt.
Unfurling-Daten: Miro speichert zwei Arten von Unfurling-Daten: die vom Asset Picker erstellten Bilder (als Teil des Boards gespeichert) sowie die Titel und Bildreferenzen (verschlüsselt in einem internen Dienst gespeichert).
Token widerrufen
Looker-Admins können den Zugriff der Integration über die Looker-Admin-Konsole widerrufen:
- Gehe zu Admin > Nutzer.
- Wähle den Nutzer aus.
- Scrolle zu API-Schlüssel und wähle neben dem Token Löschen aus.
Häufige Fragen
Wie deaktiviere ich die Integration?
Die Miro-OAuth-App in Looker löschen. Das entfernt keine Looker-Daten, die bereits auf Miro-Boards eingebettet sind, verhindert jedoch, dass Nutzer neue Inhalte einbetten oder vorhandene Assets aktualisieren.
Welche Nutzer können Looker-Inhalte in Miro einbetten?
Der Nutzer und das Miro-Board müssen beide folgende Kriterien erfüllen:
- Der Nutzer hat die Miro-Looker-Integration autorisiert.
- Der Nutzer hat Zugriff auf die Looker-Inhalte, die er einbetten möchte.
Welche Nutzer können den eingebetteten Looker-Inhalt ansehen?
Jeder, der Zugriff auf das Miro-Board hat und die Erlaubnis des Eigentümers des eingebetteten Inhalts — also alle, die das Board ansehen, kommentieren oder bearbeiten dürfen.
Müssen Nutzer die Autorisierung erneut durchführen, um Links auf anderen Boards einzufügen?
Nein, solange die Autorisierung noch gültig ist (Miro betrachtet eine Autorisierung ab Erteilung für einen Monat als gültig). Nutzer können Looker-Links auf jedem Board einfügen, und der Inhalt wird wie gewohnt importiert.
Wenn das Board zu einem anderen Team oder einer anderen Organisation gehört, in der diese Integration nicht aktiviert ist, kannst du sie dort nicht verwenden.
Kann ich über Miro auf Looker-Inhalte zugreifen, auf die ich in Looker selbst keinen Zugriff habe?
Nein. Du kannst nur Looker-Inhalte einbetten, auf die du bereits Zugriff hast — du kannst die Integration nicht nutzen, um etwas zu sehen, das du in Looker sonst nicht öffnen könntest. Wenn jedoch jemand mit Zugriff den Inhalt bereits als statisches Bild auf einem Board eingebettet hat, das du mit dieser Person teilst, kannst du dieses statische Bild auch ohne direkten Zugriff auf die Quelldatei ansehen. Die Integration erzwingt darüber hinaus keine zusätzlichen Zugriffsrichtlinien; verwende die Freigabeeinstellungen des Miro-Boards, um einzuschränken, wer zusammenarbeiten kann. Beachte, dass ein statisches Bild nicht dazu verwendet werden kann, die zugrunde liegenden Daten zu untersuchen, das Originaldiagramm zu öffnen oder Filter zu ändern.
Wo finde ich den Zusatz zur Datenverarbeitung bei Miro?
Siehe den Zusatz zur Datenverarbeitung bei Miro.
Was ist auf öffentlichen Miro-Boards nicht erlaubt?
Aus Sicherheitsgründen sind auf öffentlichen Miro-Boards folgende Funktionen deaktiviert:
- Asset-Extraktion — wird von den Integrationen Looker, Google Slides, Figma, Power BI, Microsoft Word, Microsoft Excel und Microsoft PowerPoint unterstützt.
- Direktes Asset-Unfurling (Asset statt Live-Einbettung) — wird von der Figma-Integration unterstützt.
Wie kann ich den Zugriff auf ein Board auf dieselben Personen beschränken, die Zugriff auf die Quelldatei haben?
Die Integration verwaltet ausschließlich den Dateizugriff im Quellsystem (Looker), nicht in Miro. Standardmäßig wird dies nicht durchgesetzt – um dieses Sicherheitsniveau aufrechtzuerhalten, müssen die Admins der Miro-Organisation den Asset-Picker in den Admin-Einstellungen der App deaktivieren (siehe Sicherheitsüberlegungen).
Wenn der Asset-Picker deaktiviert ist, wird verhindert, dass Looker-Inhalte als statische Bilder auf einem Miro-Board gespeichert werden, wo sie später von Personen gesehen werden könnten, die in Looker keinen Zugriff darauf haben (z. B., wenn das Board öffentlich freigegeben oder mit Personen geteilt wird, die keinen Zugriff auf die Quelle haben).