Azure Cards permet aux utilisateurs d’importer et de synchroniser les éléments de travail d’Azure Boards avec des tableaux Miro. Ce guide présente l’implémentation technique de l’intégration, son modèle de sécurité, la gestion des données et le flux de consentement Microsoft pour les admins qui évaluent ou configurent l’intégration. Pour le tutoriel complet des fonctionnalités et les étapes de configuration pour les utilisateurs finaux, voir Azure Cards.
Exigences et limites
- La personnalisation des cartes (choix des attributs à afficher sur une carte) n’est pas prise en charge.
- L’importation d’une carte en collant l’URL d’une tâche depuis le presse-papiers n’est pas prise en charge.
Implémentation technique
Miro s’intègre à Azure Boards via l’API REST d’Azure DevOps et s’abonne aux hooks de service d’Azure DevOps pour recevoir les mises à jour des éléments de travail en temps réel.
Flux de données
Les flux de données circulent dans les deux sens entre Azure DevOps et Miro.
Azure DevOps → Miro :
- La liste d’éléments de travail affichée dans le sélecteur d’éléments de travail d’Azure DevOps. Cette liste n’inclut que les éléments de travail auxquels l’utilisateur demandeur peut accéder dans Azure DevOps, et contient l’ID, le type, le titre, la personne assignée et l’état.
- Détails de l’élément de travail affichés sur une carte Azure : ID, titre, projet, type, état, description, élément de travail parent, personne assignée, priorité, zone, itération, story points et l’URL de l’élément de travail dans Azure Boards. Ces informations sont reçues à chaque mise à jour de l’élément correspondant dans Azure Boards. Azure DevOps envoie d’autres champs d’éléments de travail en plus de ceux-ci, mais Miro ignore tout ce qui n’est pas dans cette liste.
Miro → Azure DevOps :
- Informations sur l’élément de travail utilisées pour créer une carte Azure : titre, projet, type, état, description, élément de travail parent, personne assignée, priorité, zone, itération et story points.
- Chaînes de recherche utilisées pour filtrer les résultats du sélecteur, ainsi que pour filtrer les personnes assignées, les zones, les itérations et les éléments de travail parents lors de la création d’une carte.
Données en transit
Les données échangées entre Azure DevOps et Miro sont chiffrées à l’aide de TLS.
Conservation des données
Miro conserve les données des éléments de travail ajoutées à un tableau tant que la carte reste sur le tableau, et les met à jour si des hooks de service sont configurés. Il n’y a pas de limite de conservation fixe pour ces données ; seuls les protocoles de sécurité standard des comptes Miro s’appliquent.
Authentification et autorisation
Les utilisateurs authentifient leur compte Azure en utilisant le flux d’autorisation OAuth 2.0 par code d’autorisation, échangeant un code d’autorisation contre un jeton d’accès. Voir la documentation OAuth de Microsoft pour plus de détails sur le fonctionnement de l’OAuth d’Azure DevOps.
Chaque utilisateur Miro qui autorise Azure Cards reçoit son propre jeton d’accès — l’accès n’est pas partagé entre les utilisateurs.
Portées d’autorisation requises
-
vso.identity— lire les identités et les groupes. -
vso.graph— lire les informations sur les utilisateurs, les groupes, les portées et les appartenances aux groupes. -
vso.memberentitlementmanagement— lire les utilisateurs, leurs licences et les projets et extensions auxquels ils ont accès. -
vso.project— lire les projets et les équipes. -
vso.work_full— accès complet aux éléments de travail, aux requêtes, aux backlogs, aux plans et aux métadonnées de suivi des éléments de travail ; requis également pour recevoir des notifications d’événements d’éléments de travail via les hooks de service. Cette portée accorde un accès plus large que celui utilisé par Miro — Azure DevOps n’offre pas de portée plus restreinte limitée aux seuls éléments de travail, et Miro ne fait que lire et écrire des données d’éléments de travail.
Consultez la référence des autorisations de Microsoft pour plus de détails.
Ce qui est stocké dans Miro et comment
Seuls les jetons d’accès sont utilisés pendant le fonctionnement de l’intégration — Miro ne conserve pas les jetons de requête ni d’autres secrets OAuth au-delà du jeton d’accès. Les jetons d’accès sont stockés de manière sécurisée dans la base de données de Miro et ne sont utilisés que côté serveur.
Sécurité des hooks de service
Miro génère une URL de hook de service unique, contenant une clé secrète, pour chaque équipe qui configure l’intégration. Chaque instance Azure DevOps appelle sa propre URL de hook de service pour notifier Miro des modifications des éléments de travail.
Les requêtes sont envoyées par l’intermédiaire d’une connexion cryptée, ainsi l’URL elle‑même n’est pas exposée en transit. Le principal moyen par lequel l’URL d’un service hook pourrait parvenir à un tiers non autorisé est qu’un admin Azure DevOps partage la clé en dehors de l’organisation, intentionnellement ou par erreur.
Scénarios de consentement lors de la connexion ou de la reconnexion
La connexion ou la reconnexion de l’instance Azure DevOps (par exemple après que Miro a mis à jour l’application Azure Cards enregistrée) soumet l’admin au flux de consentement de Microsoft. Ce que l’admin voit dépend des paramètres de consentement du locataire Microsoft Entra (voir Présentation du consentement des administrateurs et des utilisateurs Microsoft):
- Si l’approbation d’un admin Entra est requise, et que l’admin qui connecte l’intégration dispose des permissions adéquates : il peut cocher Consentir au nom de votre organisation sur l’écran de consentement Microsoft. Cela approuve l’application pour tous les utilisateurs du locataire Microsoft Entra en une seule fois.
- Si le consentement des utilisateurs est autorisé : l’admin qui connecte l’intégration consent uniquement pour son compte. Chaque autre utilisateur donne ensuite son consentement individuellement la première fois qu’il utilise l’intégration.
- Si l’admin qui connecte l’intégration n’a pas l’autorisation d’approuver : ils voient Approbation de l’admin requise et doivent demander à un admin Microsoft Entra d’accorder le consentement — soit en soumettant une demande depuis l’écran de consentement (si leur locataire le permet), soit en contactant directement un admin Entra.
Reconnexion au niveau Enterprise ou organisation
Cette opération nécessite à la fois les autorisations d’admin d’entreprise dans Miro et les autorisations du groupe Project Collection Admin dans Azure Boards.
- Dans Miro, accédez à Paramètres de l’entreprise > Applications et intégrations > Applications > Gérer les applications > Azure Cards > Paramètres.
- Sélectionnez Déconnecter à côté de l’instance Azure DevOps existante.
- Sélectionnez Connecter pour reconnecter l’instance Azure DevOps. Vous êtes redirigé vers Microsoft pour vous connecter.
- Après vous être connecté, vous voyez l’écran de consentement pour l’application Miro Azure Cards. Ce qui se passe ensuite dépend de vos autorisations Entra et des paramètres de consentement de votre locataire — voir les scénarios ci‑dessus.
Se reconnecter au niveau de l’équipe Enterprise, ou sur le forfait Business
Nécessite à la fois les autorisations d’admin d’équipe dans Miro et celles du groupe Project Collection Admin dans Azure Boards.
- Dans Miro, rendez-vous sur Paramètres de l’équipe > Applications > Cartes Azure.
- Sélectionnez Déconnecter à côté de l’instance Azure.
- Sélectionnez Déconnecter à côté du compte Microsoft.
- Sélectionnez Connecter pour reconnecter le compte Microsoft. Vous êtes redirigé vers Microsoft pour vous connecter.
- Après la connexion, vous verrez l’écran de consentement pour l’application Cartes Azure de Miro. La suite dépend de vos autorisations Entra et des paramètres de consentement de votre locataire — voir les scénarios ci‑dessus.
- De retour dans Miro, sélectionnez Connecter à côté de l’instance Azure pour la reconnecter.
- Répétez ces étapes pour chaque équipe qui utilise l’intégration Azure Cards.