Azure Cards ermöglicht es Nutzern, Arbeitselemente aus Azure Boards in Miro-Boards zu importieren und zu synchronisieren. Diese Anleitung behandelt die technische Implementierung der Integration, das Sicherheitsmodell, die Datenverarbeitung und den Microsoft-Zustimmungsablauf für Admins, die die Integration bewerten oder konfigurieren. Eine ausführliche Funktionsübersicht und die Einrichtungsschritte für Endnutzer findest du in Azure Cards.
Voraussetzungen und Einschränkungen
- Anpassung von Karten (Auswahl der auf einer Karte angezeigten Attribute) wird nicht unterstützt.
- Das Importieren einer Karte durch Einfügen einer Aufgaben-URL aus der Zwischenablage wird nicht unterstützt.
Technische Implementierung
Miro integriert Azure Boards über die Azure DevOps REST-API und abonniert Azure DevOps Service Hooks, um Aktualisierungen von Work Items in Echtzeit zu erhalten.
Datenflüsse
Daten fließen in beide Richtungen zwischen Azure DevOps und Miro.
Azure DevOps → Miro:
- Die Liste der Arbeitselemente, die in der Azure DevOps-Arbeitselementauswahl angezeigt wird. Diese Liste enthält nur Arbeitselemente, auf die der anfragende Nutzer in Azure DevOps zugreifen kann, und zeigt ID, Typ, Titel, zugewiesene Person und Status.
- Details von Arbeitselementen, die auf einer Azure-Karte angezeigt werden: ID, Titel, Projekt, Typ, Status, Beschreibung, übergeordnetes Arbeitselement, zugewiesene Person, Priorität, Bereich, Iteration, Story Points und die URL des Arbeitselements in Azure Boards. Diese Informationen werden bei jeder Aktualisierung des entsprechenden Elements in Azure Boards übermittelt. Azure DevOps sendet neben diesen auch weitere Arbeitselementfelder, aber Miro verwirft alles, was nicht in dieser Liste enthalten ist.
Miro → Azure DevOps:
- Arbeitselementinformationen, die zur Erstellung einer Azure-Karte verwendet werden: Titel, Projekt, Typ, Status, Beschreibung, übergeordnetes Arbeitselement, Zuständiger, Priorität, Bereich, Iteration und Story Points.
- Suchbegriffe, die verwendet werden, um die Ergebnisse des Auswahlfensters zu filtern und beim Erstellen einer Karte Zuständige, Bereiche, Iterationen und übergeordnete Arbeitselemente zu filtern.
Daten während der Übertragung
Zwischen Azure DevOps und Miro ausgetauschte Daten werden mittels TLS verschlüsselt.
Datenaufbewahrung
Miro bewahrt die zum Board hinzugefügten Arbeitselementdaten so lange auf, wie sich die Karte auf dem Board befindet, und hält sie aktualisiert, wenn Service Hooks konfiguriert sind. Für diese Daten gibt es kein festes Aufbewahrungsintervall; es gelten die standardmäßigen Sicherheitsprotokolle des Miro-Kontos.
Authentifizierung und Autorisierung
Nutzer authentifizieren ihr Azure-Konto mit dem OAuth-2.0-Autorisierungscode-Flow, indem sie einen Autorisierungscode gegen ein Zugriffstoken austauschen. Siehe Microsoft-Dokumentation zu OAuth für Details dazu, wie Azure DevOps OAuth funktioniert.
Jeder Miro-Nutzer, der Azure Cards autorisiert, erhält ein eigenes Zugriffstoken — der Zugriff wird nicht zwischen Nutzern geteilt.
Erforderliche Autorisierungs-Scopes
-
vso.identity— Identitäten und Gruppen lesen. -
vso.graph— Informationen zu Nutzern, Gruppen, Berechtigungsbereichen und Gruppenmitgliedschaften lesen. -
vso.memberentitlementmanagement— Nutzer, ihre Lizenzen sowie die Projekte und Erweiterungen lesen, auf die sie zugreifen können. -
vso.project— Projekte und Teams lesen. -
vso.work_full— voller Zugriff auf Work-Items, Abfragen, Backlogs, Pläne und Metadaten der Work-Item-Nachverfolgung; außerdem erforderlich, um Benachrichtigungen über Work-Item-Ereignisse über Service Hooks zu erhalten. Dieser Berechtigungsbereich gewährt einen weitergehenden Zugriff, als Miro benötigt – Azure DevOps bietet keinen engeren Bereich, der nur auf Work-Items beschränkt ist, und Miro liest und schreibt nur Work-Item-Daten.
Siehe Microsofts Übersicht der Scopes für Details.
Was in Miro gespeichert wird und wie
Während des Betriebs der Integration werden nur Access-Token verwendet — Miro speichert keine Request-Token oder andere OAuth‑Geheimnisse über das Access-Token hinaus. Access-Token sind sicher in der Miro-Datenbank gespeichert und werden nur serverseitig verwendet.
Service-Hook-Sicherheit
Miro erstellt für jedes Team, das die Integration einrichtet, eine eindeutige Service-Hook-URL, die einen geheimen Schlüssel enthält. Jede Azure DevOps-Instanz ruft ihre eigene eindeutige Service-Hook-URL auf, um Miro über Änderungen an Work Items zu benachrichtigen.
Anfragen werden über eine verschlüsselte Verbindung gesendet, sodass die URL selbst während der Übertragung nicht offengelegt wird. Der häufigste Weg, wie eine Service-Hook-URL in die Hände Unbefugter gelangen kann, ist, dass ein Azure DevOps-Admin den Schlüssel außerhalb der Organisation weitergibt, absichtlich oder versehentlich.
Zustimmungsszenarien beim Verbinden oder erneuten Verbinden
Das Verbinden oder erneute Verbinden der Azure DevOps-Instanz (z. B. nachdem Miro die registrierte Azure Cards-App aktualisiert hat) führt den Admin durch den Zustimmungsdialog von Microsoft. Was der Admin sieht, hängt von den Zustimmungseinstellungen des Microsoft Entra-Tenants ab (siehe Microsofts Übersicht zu Admin- und Nutzerzustimmung):
- Wenn für Entra Admin-Genehmigung erforderlich ist und der Admin, der die Integration verbindet, die nötigen Berechtigungen hat: kann er auf dem Microsoft-Zustimmungsbildschirm Im Namen deiner Organisation zustimmen aktivieren. Dadurch wird die App für alle Nutzer im Entra-Mandanten gleichzeitig genehmigt.
- Wenn Nutzerzustimmung erlaubt ist: stimmt der Admin, der die Integration verbindet, nur für sich zu. Jeder andere Nutzer stimmt dann beim ersten Verwenden der Integration individuell zu.
- Wenn der Admin, der die Integration verbindet, keine Genehmigungsberechtigung hat: sehen sie Administratorgenehmigung erforderlich und müssen einen Microsoft Entra-Admin um Erteilung der Zustimmung bitten — entweder indem sie vom Zustimmungsbildschirm aus eine Anfrage einreichen (falls ihr Mandant dies zulässt) oder indem sie sich direkt an einen Entra-Admin wenden.
Wiederverbinden auf Enterprise- oder Organisationsebene
Erfordert sowohl Unternehmens-Admin-Rechte in Miro als auch Berechtigungen der Project Collection Admin-Gruppe in Azure Boards.
- Gehe in Miro zu Unternehmenseinstellungen > Apps & Integrationen > Apps > Apps verwalten > Azure Cards > Einstellungen.
- Wähle neben der vorhandenen Azure DevOps-Instanz Trennen.
- Wähle Verbinden, um die Azure DevOps-Instanz erneut zu verbinden. Du wirst zur Anmeldung bei Microsoft weitergeleitet.
- Nach der Anmeldung siehst du den Zustimmungsbildschirm für die Miro Azure Cards-App. Wie es weitergeht, hängt von deinen Entra-Berechtigungen und den Zustimmungsrichtlinien deines Tenants ab — siehe die Szenarien oben.
Erneutes Verbinden auf Enterprise-Team-Ebene oder im Business-Preisplan
Erfordert sowohl Team-Admin-Berechtigungen in Miro als auch Mitgliedschaft in der Project Collection Admin-Gruppe in Azure Boards.
- Gehe in Miro zu Teameinstellungen > Apps > Azure Cards.
- Wähle Trennen neben der Azure-Instanz.
- Wähle Trennen neben dem Microsoft-Konto.
- Wähle Verbinden, um das Microsoft-Konto erneut zu verbinden. Du wirst zu Microsoft weitergeleitet, um dich anzumelden.
- Nach der Anmeldung siehst du die Zustimmungsseite für die Miro Azure Cards-App. Wie es weitergeht, hängt von deinen Entra-Berechtigungen und den Zustimmungseinstellungen deines Mandanten ab – siehe die Szenarien oben.
- Kehre in Miro zurück und wähle neben der Azure-Instanz Verbinden, um sie erneut zu verbinden.
- Wiederhole diese Schritte für jedes Team, das die Integration „Azure Cards“ nutzt.