Azure Cards pozwala użytkownikom importować elementy pracy z Azure Boards i synchronizować je z tablicami Miro. Ten przewodnik opisuje techniczną implementację integracji, model zabezpieczeń, sposób przetwarzania danych oraz przepływ zgody Microsoft dla administratorów oceniających lub konfigurujących integrację. Aby zapoznać się z pełnym przewodnikiem po funkcjach i instrukcjami dla użytkowników końcowych, zobacz Azure Cards.
Wymagania i ograniczenia
- Dostosowywanie kart (wybór atrybutów wyświetlanych na karcie) nie jest obsługiwane.
- Importowanie karty przez wklejenie adresu URL zadania ze schowka nie jest obsługiwane.
Wdrożenie techniczne
Miro integruje się z Azure Boards za pośrednictwem Azure DevOps REST API i subskrybuje service hooks w Azure DevOps, aby otrzymywać aktualizacje elementów pracy w czasie rzeczywistym.
Przepływ danych
Dane przepływają w obu kierunkach między Azure DevOps a Miro.
Azure DevOps → Miro:
- Lista elementów pracy wyświetlana w selektorze elementów pracy Azure DevOps. Lista ta zawiera tylko te elementy pracy, do których użytkownik, który wysłał żądanie, ma dostęp w Azure DevOps, oraz zawiera identyfikator (ID), typ, tytuł, osobę przypisaną i stan.
- Szczegóły elementu pracy wyświetlane na karcie Azure: ID, tytuł, projekt, typ, stan, opis, element nadrzędny, osoba przypisana, priorytet, obszar, iteracja, Story points oraz adres URL elementu pracy w Azure Boards. Informacje te pojawiają się przy każdej aktualizacji odpowiadającego elementu w Azure Boards. Azure DevOps wysyła też inne pola elementu pracy wraz z powyższymi, ale Miro odrzuca wszystko spoza tej listy.
Miro → Azure DevOps:
- Informacje o elemencie roboczym używane do utworzenia karty Azure: tytuł, projekt, typ, stan, opis, element nadrzędny, przypisany użytkownik, priorytet, obszar, iteracja i Story points.
- Ciągi wyszukiwania używane do filtrowania wyników w oknie wyboru oraz do filtrowania przypisanych użytkowników, obszarów, iteracji i elementów nadrzędnych podczas tworzenia karty.
Dane w tranzycie
Dane wymieniane między Azure DevOps a Miro są szyfrowane za pomocą TLS.
Retencja danych
Miro przechowuje dane elementów roboczych dodanych do tablicy tak długo, jak karta znajduje się na tablicy, i aktualizuje je, jeśli są skonfigurowane service hooki. Dla tych danych nie ma ustalonego limitu retencji; obowiązują standardowe protokoły bezpieczeństwa konta Miro.
Uwierzytelnianie i autoryzacja
Użytkownicy uwierzytelniają swoje konto Azure przy użyciu Authorization Code Grant w OAuth 2.0, wymieniając kod autoryzacyjny na token dostępu. Zobacz dokumentację Microsoftu dotyczącą OAuth, aby uzyskać szczegóły dotyczące działania OAuth w Azure DevOps.
Każdy użytkownik Miro, który autoryzuje Azure Cards, otrzymuje własny, odrębny token dostępu — dostęp nie jest współdzielony między użytkownikami.
Wymagane zakresy autoryzacji
-
vso.identity— odczyt tożsamości i grup. -
vso.graph— odczyt informacji o użytkownikach, grupach, zakresach i członkostwie w grupach. -
vso.memberentitlementmanagement— odczyt użytkowników, ich licencji oraz projektów i rozszerzeń, do których mają dostęp. -
vso.project— odczyt projektów i zespołów. -
vso.work_full— pełny dostęp do elementów pracy, zapytań, backlogów, planów i metadanych śledzenia elementów pracy; wymagany także do otrzymywania powiadomień o zdarzeniach elementów pracy przez service hooki. Ten zakres zapewnia szerszy dostęp niż używa Miro — Azure DevOps nie udostępnia węższego zakresu ograniczonego wyłącznie do elementów pracy, a Miro jedynie odczytuje i zapisuje dane elementów pracy.
Zobacz referencję zakresów Microsoft, aby poznać szczegóły.
Co jest przechowywane w Miro i w jaki sposób
W trakcie działania integracji używane są tylko tokeny dostępu — Miro nie przechowuje tokenów żądań ani innych sekretów OAuth poza tokenem dostępu. Tokeny dostępu są bezpiecznie przechowywane w bazie danych Miro i używane wyłącznie po stronie serwera.
Bezpieczeństwo service hooków
Miro generuje unikatowy adres URL service hook zawierający klucz tajny dla każdego zespołu, który skonfigurował integrację. Każda instancja Azure DevOps wywołuje swój unikatowy adres URL service hook, aby powiadomić Miro o zmianach elementów pracy.
Żądania są wysyłane przez zaszyfrowane połączenie, więc sam adres URL nie jest ujawniany w trakcie przesyłania. Główny sposób, w jaki adres URL webhooka usługi mógłby trafić do nieuprawnionej osoby trzeciej, to sytuacja, gdy administrator Azure DevOps udostępni klucz poza organizacją, czy to celowo, czy przez pomyłkę.
Scenariusze zgody podczas łączenia lub ponownego łączenia
Po połączeniu lub ponownym połączeniu instancji Azure DevOps (na przykład po zaktualizowaniu przez Miro zarejestrowanej aplikacji Azure Cards) administrator zostanie poprowadzony przez proces uzyskiwania zgody firmy Microsoft. To, co zobaczy administrator, zależy od ustawień zgody w dzierżawie Microsoft Entra (zobacz przegląd zgód administratora i użytkownika firmy Microsoft):
- Jeśli wymagana jest zgoda administratora Entra, a administrator łączący integrację ma odpowiednie uprawnienia: może zaznaczyć Wyraź zgodę w imieniu Twojej organizacji na ekranie zgody Microsoft. To zatwierdza aplikację dla wszystkich użytkowników w dzierżawie Entra jednocześnie.
- Jeśli zgoda użytkownika jest dozwolona: administrator łączący integrację wyraża zgodę tylko w swoim imieniu. Każdy inny użytkownik wyrazi zgodę indywidualnie przy pierwszym użyciu integracji.
- Jeśli administrator łączący integrację nie ma uprawnień do zatwierdzania: zobaczy komunikat Wymagane zatwierdzenie administratora i będzie musiał poprosić administratora Microsoft Entra o udzielenie zgody — albo wysyłając prośbę z ekranu zgody (jeśli dzierżawa na to pozwala), albo kontaktując się bezpośrednio z administratorem Entra.
Ponowne połączenie na poziomie Enterprise lub organizacji
Wymaga zarówno uprawnień administratora firmy w Miro, jak i uprawnień grupy Project Collection Admin w Azure Boards.
- W Miro przejdź do Ustawienia firmy > Aplikacje i integracje > Aplikacje > Zarządzaj aplikacjami > Azure Cards > Ustawienia.
- Wybierz Odłącz obok istniejącej instancji Azure DevOps.
- Wybierz Połącz, aby ponownie połączyć instancję Azure DevOps. Zostaniesz przekierowany do Microsoft, aby się zalogować.
- Po zalogowaniu zobaczysz ekran zgody dla aplikacji Miro Azure Cards. To, co stanie się dalej, zależy od twoich uprawnień w Entra i ustawień zgody w twoim tenancie — zobacz powyższe scenariusze.
Ponowne połączenie na poziomie zespołu Enterprise lub na planie Business
Wymaga zarówno uprawnień administratora zespołu w Miro, jak i uprawnień członka grupy Project Collection Admin w Azure Boards.
- W Miro przejdź do Ustawienia zespołu > Aplikacje > Azure Cards.
- Wybierz Rozłącz obok instancji Azure.
- Wybierz Rozłącz obok konta Microsoft.
- Wybierz Połącz, aby ponownie połączyć konto Microsoft. Zostaniesz przekierowany do Microsoft, aby się zalogować.
- Po zalogowaniu zobaczysz ekran zgody dla aplikacji Miro Azure Cards. To, co stanie się dalej, zależy od Twoich uprawnień w Entra i ustawień zgody Twojego dzierżawcy — zobacz powyższe scenariusze.
- W Miro wybierz Połącz obok instancji Azure, aby ją ponownie połączyć.
- Powtórz te kroki dla każdego zespołu korzystającego z integracji Karty Azure.