Azure Cards permite a los usuarios importar y sincronizar elementos de trabajo de Azure Boards con tableros de Miro. Esta guía abarca la implementación técnica de la integración, el modelo de seguridad, el manejo de datos y el flujo de consentimiento de Microsoft para admins que evalúan o configuran la integración. Para ver la guía completa de funciones y los pasos de configuración para el usuario final, consulta Azure Cards.
Requisitos y limitaciones
- La personalización de tarjetas (elegir qué atributos se muestran en una tarjeta) no es compatible.
- No se admite importar una tarjeta pegando la URL de una tarea desde el portapapeles.
Implementación técnica
Miro se integra con Azure Boards mediante la API REST de Azure DevOps y se suscribe a los service hooks de Azure DevOps para recibir actualizaciones de elementos de trabajo en tiempo real.
Flujos de datos
Los datos fluyen en ambas direcciones entre Azure DevOps y Miro.
Azure DevOps → Miro:
- La lista de elementos de trabajo que se muestra en el selector de elementos de trabajo de Azure DevOps. Esta lista solo incluye los elementos de trabajo a los que el usuario solicitante puede acceder en Azure DevOps, y contiene el ID, tipo, título, asignado y estado.
- Detalles del elemento de trabajo que se muestran en una tarjeta de Azure: ID, título, proyecto, tipo, estado, descripción, elemento de trabajo padre, asignado, prioridad, área, iteración, puntos de historia y la URL del elemento de trabajo en Azure Boards. Esto llega con cada actualización del elemento correspondiente en Azure Boards. Azure DevOps envía otros campos del elemento de trabajo junto con estos, pero Miro descarta todo lo que esté fuera de esta lista.
Miro → Azure DevOps:
- Información del elemento de trabajo usada para crear una tarjeta de Azure: título, proyecto, tipo, estado, descripción, elemento de trabajo padre, asignado, prioridad, área, iteración y puntos de historia.
- Cadenas de búsqueda usadas para filtrar los resultados del selector y para filtrar asignados, áreas, iteraciones y elementos de trabajo padre al crear una tarjeta.
Datos en tránsito
Los datos intercambiados entre Azure DevOps y Miro se cifran mediante TLS.
Retención de datos
Miro conserva los datos del elemento de trabajo añadidos a un tablero mientras la tarjeta permanezca en el tablero, y los mantiene actualizados si se configuran ganchos de servicio. No existe un límite de retención fijo para estos datos; se aplican los protocolos de seguridad estándar de la cuenta de Miro.
Autenticación y autorización
Los usuarios autentican su cuenta de Azure mediante el flujo OAuth 2.0 de autorización con código, intercambiando un código de autorización por un token de acceso. Consulta la documentación de OAuth de Microsoft para obtener detalles sobre cómo funciona OAuth de Azure DevOps.
Cada usuario de Miro que autoriza Azure Cards obtiene su propio token de acceso — el acceso no se comparte entre los usuarios.
Alcances de autorización requeridos
-
vso.identity— leer identidades y grupos. -
vso.graph— leer información sobre usuarios, grupos, alcances y pertenencia a grupos. -
vso.memberentitlementmanagement— leer usuarios, sus licencias y los proyectos y extensiones a los que pueden acceder. -
vso.project— leer proyectos y equipos. -
vso.work_full— acceso completo a elementos de trabajo, consultas, backlogs, planes y metadatos de seguimiento de elementos de trabajo; también se requiere para recibir notificaciones de eventos de elementos de trabajo a través de service hooks. Este alcance concede un acceso más amplio del que usa Miro — Azure DevOps no ofrece un alcance más reducido limitado solo a elementos de trabajo, y Miro solo lee y escribe datos de elementos de trabajo.
Consulta la referencia de ámbitos de Microsoft para más detalles.
Qué se almacena en Miro y cómo
Solo se usan tokens de acceso durante el funcionamiento de la integración — Miro no conserva tokens de solicitud ni otros secretos de OAuth más allá del token de acceso. Los tokens de acceso se almacenan de forma segura en la base de datos de Miro y se usan únicamente del lado del servidor.
Seguridad de los hooks de servicio
Miro genera una URL única de hook de servicio, que contiene una clave secreta, para cada equipo que configura la integración. Cada instancia de Azure DevOps llama a su propia URL única de hook de servicio para notificar a Miro los cambios en los elementos de trabajo.
Las solicitudes se envían a través de una conexión cifrada, por lo que la propia URL no queda expuesta en tránsito. La forma principal en que una URL del service hook podría llegar a un tercero no autorizado es si un admin de Azure DevOps comparte la clave fuera de la organización, ya sea de forma intencional o por error.
Escenarios de consentimiento al conectar o reconectar
Conectar o reconectar la instancia de Azure DevOps (por ejemplo, después de que Miro actualice la aplicación Azure Cards registrada) lleva al admin a través del flujo de consentimiento de Microsoft. Lo que el admin vea depende de la configuración de consentimiento del tenant de Microsoft Entra (consulta la descripción general del consentimiento para administradores y usuarios de Microsoft):
- Si se requiere la aprobación del admin de Entra y el admin que conecta la integración tiene los permisos adecuados: puede marcar Consentir en nombre de tu organización en la pantalla de consentimiento de Microsoft. Esto aprueba la aplicación para todos los usuarios del tenant de Entra a la vez
- Si se permite el consentimiento de usuarios: el admin que conecta la integración da su consentimiento solo para sí mismo. Cada usuario, en cambio, da su consentimiento de forma individual la primera vez que use la integración.
- Si el admin que conecta la integración no tiene permiso para aprobar: verá Se necesita aprobación del admin y deberá pedir a un admin de Microsoft Entra que otorgue el consentimiento — ya sea enviando una solicitud desde la pantalla de consentimiento (si su tenant lo permite) o contactando directamente a un admin de Microsoft Entra.
Reconectar a nivel Enterprise u organización
Requiere tanto permisos de admin de empresa en Miro como permisos del grupo Project Collection Admin en Azure Boards.
- En Miro, ve a Configuración de empresa > Aplicaciones e integraciones > Aplicaciones > Administrar aplicaciones > Tarjetas Azure > Configuración.
- Selecciona Desconectar junto a la instancia existente de Azure DevOps.
- Selecciona Conectar para volver a conectar la instancia de Azure DevOps. Serás redirigido a Microsoft para iniciar sesión.
- Después de iniciar sesión, verás la pantalla de consentimiento de la aplicación Tarjetas Azure de Miro. Lo que ocurra después depende de tus permisos en Entra y de la configuración de consentimiento de tu tenant — consulta los escenarios anteriores.
Reconectar a nivel de equipo Enterprise o en el plan Business
Requiere tanto permisos de admin de equipo en Miro como permisos del grupo Project Collection Admin en Azure Boards.
- En Miro, ve a Configuración de equipo > Aplicaciones > Tarjetas Azure.
- Selecciona Desconectar junto a la instancia de Azure.
- Selecciona Desconectar junto a la cuenta de Microsoft.
- Selecciona Conectar para reconectar la cuenta de Microsoft. Serás redirigido a Microsoft para iniciar sesión.
- Después de iniciar sesión, verás la pantalla de consentimiento de la aplicación Miro Azure Cards. Lo que ocurra después depende de tus permisos en Entra y de la configuración de consentimiento de tu tenant; consulta los escenarios anteriores.
- De vuelta en Miro, selecciona Conectar junto a la instancia de Azure para reconectarla.
- Repite estos pasos para cada equipo que use la integración de Azure Cards.