Personen: Unternehmens-Admins, Team-Admins
Plattformen: Browser, Desktop
Die Integration von Google Workspace ermöglicht es Nutzern, Inhalte aus Google Docs, Sheets und Slides in Miro-Boards einzubetten. Dieses Handbuch behandelt die technische Implementierung der Integration, das Sicherheitsmodell und die Datenverarbeitung für Admins, die die Integration bewerten oder konfigurieren.
Wichtige Funktionen
- Live-Einbettung: Nutzer können Inhalte aus Google Docs, Google Sheets oder Google Slides als Live-iFrame in ein Miro-Board einbetten.
- Sicher: Jeder Board-Besucher wird im iFrame zur Anmeldung aufgefordert, bevor er die eingebetteten Inhalte ansehen kann.
- 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 sie ablenkungsfrei anzusehen.
- Aktions-Shortcut: Nutzer können einen Aktions-Shortcut hinzufügen, der ein Dialogfeld öffnet, um einen Link zu Google Docs, Google Sheets oder Google Slides einzubetten.
- Asset-Picker: Nutzer können eine bestimmte Folie als statisches Bild auf dem Board hinzufügen, sodass Mitwirkende genau diesen Inhalt ansehen und darauf Bezug nehmen können, ohne Zugriff auf die Quelldatei zu benötigen.
- Admin-Kontrollen: Admins können verhindern, dass Nutzer den Asset-Picker verwenden, um Inhalte aus Google Slides als statische Bilder hinzuzufügen.
Einschränkungen
- Der Asset-Picker ist nur für Google Slides verfügbar. Für Google Docs oder Google Sheets ist er nicht verfügbar.
Technische Implementierung
Miro integriert sich mit Google Workspace über die Google REST API. Nutzer autorisieren den Zugriff mit OAuth 2.0 und verknüpfen dann ihre Dateien aus Google Docs, Google Sheets oder Google Slides mit einem Board in Miro.
Sicherheitsüberlegungen
Der Asset Picker der Integration ermöglicht es Nutzern, einen Teil einer Google Präsentation als statisches Bild auf dem Canvas zu platzieren. Nur autorisierte Nutzer können auf die Live-Einbettung zugreifen, aber alle, die Zugriff auf das Board haben, können das angehängte statische Bild ansehen. Das Hinzufügen von Assets aus Einbettungen ist auf öffentlichen Boards standardmäßig deaktiviert.
Unternehmens-Admins können den Asset Picker für alle Boards deaktivieren:
- Gehe zu Unternehmenseinstellungen > Apps und Integrationen > Apps > Google Office Integration App (unter dem Apps verwalten-Tab).
- Schalte Nutzer daran hindern, Assets aus Einbettungen zum Canvas hinzuzufügen um.
Datenflüsse
- Ein Nutzer, der zu einem Team oder einer Organisation gehört, bei dem diese Funktion aktiviert ist, fügt einen Link zu Google Dokumenten, Google Tabellen oder Google Präsentationen in ein Miro-Board ein.
- Miro liest den Link. Falls der Nutzer die Integration noch nicht autorisiert hat, startet Miro den OAuth-Flow und leitet den Nutzer zur Autorisierungsseite von Google weiter.
- Nachdem der Nutzer die Autorisierung erteilt hat, verwendet der Integrationsdienst von Miro das Access-Token des Nutzers, um die Google REST API aufzurufen und die Inhalte abzuholen.
Welche Google-Daten Miro speichert
Miro ruft von eingefügten Google Workspace-Links die folgenden Daten ab und speichert sie:
- Titel von Dokumenten und Dateien
- Bilder, die vom Asset Picker erstellt wurden
Datenaufbewahrung
Eingebettete Daten unterliegen der standardmäßigen Datenaufbewahrungsrichtlinie von Miro für alle Kundendaten.
Authentifizierung und Autorisierung
Um einen Google Docs-, Sheets- oder Slides-Link in ein Board einzubetten, muss der Nutzer die Integration über den OAuth-Zustimmungsbildschirm von Google autorisieren. Je nach Konfiguration des Google Workspace des Kunden kann es außerdem erforderlich sein, dass ein Google Workspace-Admin die Integration genehmigt.
Erforderliche Autorisierungsbereiche
Die Google Workspace-Integration benötigt die folgenden Berechtigungsbereiche:
https://www.googleapis.com/auth/presentations.readonly https://www.googleapis.com/auth/spreadsheets.readonly https://www.googleapis.com/auth/documents.readonly
Was Miro speichert und wie
Miro speichert für diese Integration zwei Datenkategorien: Autorisierungsdaten und Unfurling-Daten.
- Autorisierungsdaten: Miro speichert das Access-Token und das Refresh-Token in seiner Datenbank für mehrere Tage. Solange die Autorisierung aktiv ist, erneuert Miro automatisch ein abgelaufenes Access-Token mithilfe des Refresh-Tokens, ohne dass der Nutzer sich 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 erfassten Bilder (als Teil des Boards gespeichert) sowie die Titel und Bildreferenzen (verschlüsselt in einem internen Dienst gespeichert).
Token widerrufen
Nutzer können den Zugriff der Integration jederzeit in ihrem Google-Konto widerrufen, gemäß der Google Identity-Anleitung.
Google Workspace-Integration einrichten
Hinweis: Nur Miro-Team-Admins können die App installieren. Wenn deine Miro-Organisation nur genehmigte Apps zulässt und ein normaler Nutzer einen Google Workspace-Link einfügt, sieht dieser Nutzer stattdessen ein Dialogfeld zur App-Installationsanfrage.
So installierst du und nutzt die Integration:
- Kopiere die URL der Google-Dokument-, Google-Tabellen- oder Google-Präsentationsdatei.
- Füge die URL in dein Miro-Board ein.
-
Was als Nächstes passiert, hängt davon ab, wer den Link eingefügt hat:
- Ein Team-Admin von Miro fügt den Link ein: Die App wird automatisch autorisiert und installiert, und der Link wird automatisch als Vorschau angezeigt.
- Ein normaler Nutzer fügt den Link ein, und die Organisation erlaubt nur genehmigte Apps: Ein Dialogfeld zur Installationsanfrage für die App öffnet sich. Nachdem der Nutzer um Erlaubnis gebeten hat, können Unternehmens-Admins dem Artikel App request flow folgen, um die Anfrage zu genehmigen.
Google-Konto verbinden
Nachdem die Integration installiert und autorisiert wurde:
- Klicke auf Verbinden im Widget, das nach dem Einfügen der URL auf dem Board erstellt wurde. Du wirst auf eine Google-Seite weitergeleitet, auf der du Miro Zugriff auf dein Konto gewähren sollst.
- Bestätige die Autorisierung bei Google. Der Google-Inhalt wird als iFrame auf dein Board eingefügt.
Häufige Fragen
Welche Nutzer können Google-Inhalte in Miro einbetten?
Sowohl der Nutzer als auch das Miro-Board müssen die beiden folgenden Kriterien erfüllen:
- Der Nutzer hat die Miro Google Workspace-Integration autorisiert.
- Der Nutzer hat Zugriff auf die Google-Inhalte, die er einbetten möchte.
Welche Nutzer können die eingebetteten Google-Inhalte ansehen?
Alle, die Zugriff auf das Miro-Board und die Erlaubnis des Eigentümers der eingebetteten Inhalte haben – also alle, die das Board ansehen, kommentieren oder bearbeiten dürfen. Betrachter müssen die Integration nicht autorisieren oder über eine Google-Lizenz verfügen, um die eingebetteten Inhalte auf dem Board anzusehen.
Müssen Nutzer die Integration erneut autorisieren, um Links auf anderen Boards einzufügen?
Nein – solange die Autorisierung noch gültig ist (Miro betrachtet eine Autorisierung ab ihrer Erteilung für einen Monat als gültig). Nutzer können Google-Workspace-Links auf jedem Board einfügen, und die Inhalte werden wie gewohnt importiert.
Ist ein Board Teil eines anderen Teams oder einer anderen Organisation, in der diese Integration nicht aktiviert ist, kann ein Nutzer sie dort nicht nutzen.
Kann ich über Miro auf Google-Inhalte zugreifen, die ich in Google selbst nicht öffnen kann?
Nein. Du kannst nur Google-Inhalte einbetten, auf die du bereits Zugriff hast — die Integration ermöglicht es nicht, etwas anzusehen, das du in Google nicht öffnen könntest. Wenn jedoch jemand mit Zugriff den Inhalt bereits als statisches Bild auf einem Board eingebettet hat, das du mit ihnen teilst, kannst du diesen Schnappschuss auch ohne direkten Zugriff auf die Quelldatei ansehen. Die Integration erzwingt darüber hinaus keine zusätzlichen Zugangsbeschränkungen; nutze die Freigabeeinstellungen des Boards, um einzuschränken, wer zusammenarbeiten darf. Beachte, dass ein statisches Bild nicht dazu verwendet werden kann, die zugrunde liegenden Daten zu erkunden, die Originaldatei zu öffnen oder Filter zu ändern.
Wo finde ich das Miro Data Processing Addendum?
Sieh dir den Zusatz zur Datenverarbeitung bei Miro an.
Was ist auf öffentlichen Miro-Boards nicht erlaubt?
Aus Sicherheitsgründen deaktivieren öffentliche Boards:
- Extrahieren von Assets — wird von den Integrationen Looker, Google Slides, Figma, Power BI, Microsoft Word, Microsoft Excel und Microsoft PowerPoint unterstützt.
- Direktes Auflösen von Assets (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 auch Zugriff auf die Quelldatei haben?
Die Integration verwaltet nur den Dateizugriff im Quellsystem (Google), nicht in Miro. Standardmäßig wird dies nicht durchgesetzt — damit dieses Sicherheitsniveau erhalten bleibt, müssen die Admins der Miro-Organisation in den Admin-Einstellungen der App den Asset Picker deaktivieren.
Das Deaktivieren des Asset Pickers verhindert, dass Google-Inhalte als statische Bilder auf einem Miro-Board gespeichert werden, wo sie später von Personen gesehen werden könnten, die in Google keinen Zugriff darauf haben (z. B., wenn das Board öffentlich freigegeben wird oder mit Personen geteilt wird, die keinen Zugriff auf die Quelle haben).