Die Integration von Microsoft 365 ermöglicht es Nutzern, Microsoft Word, Excel und PowerPoint-Dateien (in SharePoint oder OneDrive für Arbeits- oder Schulkonten gespeichert) in Miro-Boards einzubetten. Diese Anleitung beschreibt die Einrichtung, 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 eine Word-, Excel- oder PowerPoint-Datei als Live-iFrame in ein Miro Board einbetten.
- Sicher: Jeder Besucher des Boards wird aufgefordert, sich im iFrame anzumelden, bevor er die eingebetteten Inhalte ansehen kann.
- Anzeigeoptionen: Nutzer können wählen, ob eingebettete Inhalte als Live-Einbettung oder als Lesezeichen angezeigt werden.
- Fokusmodus: Nutzer können eine Live-Einbettung oder ein Lesezeichen in den Fokusmodus erweitern, um sie ohne Ablenkungen anzusehen.
- Aktion-Shortcut: Nutzer können einen Aktion-Shortcut hinzufügen, der ein Dialogfeld zum Einbetten eines Microsoft 365-Links öffnet.
- Asset-Picker: Nutzer können eine bestimmte Seite, ein bestimmtes Arbeitsblatt oder 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-Steuerung: Admins können verhindern, dass Nutzer den Asset-Picker verwenden, um Microsoft-365-Inhalte als statische Bilder hinzuzufügen.
Anforderungen und Einschränkungen
- Erfordert ein Microsoft-365-Geschäftskonto (auf SharePoint basierend) mit Word, Excel oder PowerPoint. Persönliche Microsoft-Konten werden nicht unterstützt.
Microsoft-365-Integration einrichten
Voraussetzungen
- Ein Company Admin hat die Microsoft 365-Integration für deine Miro-Organisation genehmigt.
- Du hast Admin-Zugriff in Microsoft Entra, um die Integration für deinen Microsoft-Tenant zu genehmigen.
Integration in Microsoft Entra genehmigen
Die aktuelle Version der Miro Microsoft 365-App erfordert Admin-Zustimmung, damit sie in einem Microsoft-Tenant eines Kunden installiert werden kann.
- Melde dich bei Microsoft Entra als Admin an und gehe zu Enterprise-Apps > Einwilligung und Berechtigungen.
- Stelle Ja für Nutzer können Admin-Zustimmung für Apps anfordern, denen sie nicht zustimmen können ein.
- Unter Wer kann Admin-Zustimmungsanfragen überprüfen, wähle die Nutzer, Rollen oder Gruppen aus, die diese Anfragen überprüfen dürfen.
- Sobald dies konfiguriert ist, kann ein Nicht-Admin-Nutzer einen Microsoft 365-Link in ein Miro-Board (in einem Team, in dem die Integration aktiviert ist) einfügen, um eine Admin-Zustimmungsanfrage auszulösen.
- Die in Schritt 3 ausgewählten Admins können zu Enterprise-Anwendungen > Anfragen zur Admin-Zustimmung gehen, um die Anfrage zu prüfen und zu genehmigen. Sobald sie genehmigt ist, steht die Integration jedem Nutzer im Tenant zur Verfügung, damit er sie selbst autorisieren kann.
Integration in Miro installieren und autorisieren
Hinweis: Nur Team-Admins können die App installieren. Wenn deine Miro-Organisation nur genehmigte Apps zulässt und ein normaler Nutzer einen Microsoft-365-Link einfügt, sieht dieser stattdessen ein Dialogfeld zur Anfrage zur App-Installation.
- Kopiere die URL der Word-, Excel- oder PowerPoint-Datei.
- 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 entfaltet sich ohne weitere Schritte.
-
Ein regulärer Nutzer fügt den Link ein und die Organisation erlaubt nur genehmigte Apps: Es öffnet sich ein Dialogfeld zur App-Installationsanfrage. Nachdem der Nutzer die Erlaubnis angefordert hat, können Unternehmens-Admins dem Artikel App request flow folgen, um die Anfrage zu genehmigen.
Microsoft 365-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, die dich darum bittet, Miro Zugriff auf dein Microsoft 365-Konto zu gewähren.
- Bestätige die Autorisierung bei Microsoft. Der Inhalt der Datei wird als iFrame in dein Board eingefügt.
Technische Implementierung
Miro integriert sich mit Microsoft 365 über die Microsoft Graph REST API. Nutzer autorisieren den Zugriff mit OAuth 2.0 und verknüpfen dann ihre Word-, Excel- oder PowerPoint-Dateien mit einem Miro-Board.
Sicherheitsüberlegungen
Der Asset Picker der Integration ermöglicht Nutzern, einen Teil einer Microsoft-365-Datei als statisches Bild an den Canvas anzuhängen. Nur autorisierte Nutzer können auf die Live-Einbettung zugreifen, aber alle, die Zugriff auf das Board haben, können ein angehängtes statisches Bild ansehen. Das Hinzufügen von Assets aus Einbettungen ist standardmäßig für öffentliche Boards deaktiviert.
Unternehmens-Admins können den Asset Picker für alle Boards deaktivieren:
- Gehe zu Unternehmenseinstellungen > Apps und Integrationen > Apps > Microsoft-Dokumentintegration (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, für die diese Funktion aktiviert ist, fügt einen Microsoft-365-Link auf 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 Microsoft weiter.
- Nachdem der Nutzer die Autorisierung erteilt hat, verwendet der Integrationsdienst von Miro das Access-Token des Nutzers, um die Microsoft Graph REST API aufzurufen und den Inhalt abzurufen.
Welche Microsoft-365-Daten Miro speichert
Miro ruft aus eingefügten Microsoft-365-Links die folgenden Daten ab und speichert sie:
- Dokumenten- und Dateititel
- Vom Asset-Picker erstellte Bilder
Datenaufbewahrung
Eingebettete Daten unterliegen der Standard-Datenaufbewahrungsrichtlinie von Miro für alle Kundendaten.
Authentifizierung und Autorisierung
Das Einbetten eines Microsoft 365-Links auf einem Board erfordert, dass der Nutzer die Integration über Microsofts OAuth-API autorisiert. Dies erfordert außerdem, dass ein Microsoft Entra-Admin die Integration genehmigt — siehe Integration in Microsoft Entra genehmigen oben.
Erforderliche Berechtigungen
Die Microsoft 365-Integration benötigt die folgenden Berechtigungen:
-
offline_access— erforderlich, um Tokens zu erneuern. -
Files.ReadWrite— ermöglicht der App, die Dateien des angemeldeten Nutzers zu lesen, zu erstellen, zu aktualisieren und zu löschen. -
Files.ReadWrite.All— ermöglicht der App, alle Dateien zu lesen, zu erstellen, zu aktualisieren und zu löschen, auf die der angemeldete Nutzer zugreifen kann. -
Sites.ReadWrite.All— ermöglicht der App, Dokumente und Listenelemente in allen Site-Sammlungen im Namen des angemeldeten Nutzers zu bearbeiten oder zu löschen.
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 für mehrere Tage in seiner Datenbank. Solange die Autorisierung aktiv ist, aktualisiert Miro ein abgelaufenes Access-Token automatisch mit dem Refresh-Token, 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 erfassten Bilder (als Teil des Boards gespeichert) sowie die Titel und Bildreferenzen (verschlüsselt in einem internen Dienst gespeichert).
Token widerrufen
Microsoft Entra-Admins können der Integration den Zugriff entziehen — siehe Microsofts Anleitung zum Widerrufen des Anwendungszugriffs (extern).
häufige Fragen
Wie schalte ich die Integration aus?
Ein Microsoft Entra-Admin kann die Berechtigungen der Miro-Integration widerrufen, indem er die App löscht: Gehe zu Enterprise applications > All applications, wähle die App Contenthub Microsoft Integration aus und klicke dann auf Properties > Delete.
Welche Nutzer können Microsoft 365-Inhalte in Miro einbetten?
Sowohl der Nutzer als auch das Miro-Board müssen die folgenden Kriterien erfüllen:
- Der Nutzer hat die Microsoft‑365‑Integration von Miro autorisiert.
- Der Nutzer hat Zugriff auf die Microsoft‑365‑Inhalte, die er einbetten möchte.
Welche Nutzer können die eingebetteten Microsoft‑365‑Inhalte ansehen?
Jeder, der Zugriff auf das Miro Board und die Erlaubnis des Eigentümers des eingebetteten Inhalts hat — also jede Person mit Rechten zum Ansehen, Kommentieren oder Bearbeiten des Boards. Betrachter müssen die Integration nicht autorisieren und benötigen keine Microsoft 365‑Lizenz, um den eingebetteten Inhalt auf dem Board anzusehen.
Müssen Nutzer die Autorisierung erneuern, 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 Microsoft 365-Links auf jedem Board einfügen, und der Inhalt wird normal importiert.
Wenn das Board zu einem anderen Team oder einer anderen Organisation gehört, in der diese Integration nicht aktiviert ist, kann der Nutzer sie dort nicht verwenden.
Kann ich über Miro auf Microsoft 365-Inhalte zugreifen, auf die ich direkt in Microsoft keinen Zugriff habe?
Nein. Du kannst nur Microsoft-365-Inhalte einbetten, auf die du bereits Zugriff hast — die Integration erlaubt dir nicht, etwas zu sehen, das du in Microsoft sonst nicht öffnen könntest. Wenn jedoch jemand mit Zugriff die Inhalte bereits als statisches Bild (Snapshot) auf einem Board, das du mit ihnen teilst, eingebettet hat, kannst du diesen Snapshot 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 (Snapshot) nicht dazu verwendet werden kann, das zugrundeliegende Dokument zu erkunden, die Originaldatei zu öffnen oder Filter zu ändern.
Wo finde ich den Zusatz zur Datenverarbeitung bei Miro?
Hier findest du den Zusatz zur Datenverarbeitung bei Miro.
Was ist auf öffentlichen Miro-Boards nicht erlaubt?
Bei öffentlichen Miro-Boards sind aus Sicherheitsgründen folgende Funktionen deaktiviert:
- Asset-Extraktion — wird von den Integrationen für Looker, Google Slides, Figma, Power BI, Microsoft Word, Microsoft Excel und Microsoft PowerPoint unterstützt.
- Direktes Anzeigen als Asset (Asset statt Live-Einbettung) — wird von der Figma-Integration unterstützt.
Wie kann ich den Boardzugriff auf dieselben Personen beschränken, die Zugriff auf die Quelldatei haben?
Die Integration verwaltet nur den Dateizugriff im Quellsystem (Microsoft 365), nicht in Miro. Standardmäßig wird das nicht durchgesetzt — um dieses Sicherheitsniveau aufrechtzuerhalten, müssen Admins der Miro-Organisation den Asset-Picker in den Admin-Einstellungen der App deaktivieren (siehe Sicherheitsaspekte).
Wenn du den Asset-Picker deaktivierst, verhinderst du, dass Microsoft 365-Inhalte als statische Bilder auf einem Miro-Board gespeichert werden, wo sie später von Personen gesehen werden könnten, die in Microsoft 365 keinen Zugriff darauf haben (z. B. wenn das Board öffentlich freigegeben wird oder mit Personen geteilt wird, die keinen Zugriff auf die Quelldatei haben).