Este artículo responde a las preguntas más populares sobre cómo se crea la integración de tarjetas de Jira.
¿Cómo funciona la autenticación Jira-Miro?
Consulta los artículos del Centro de Ayuda sobre
- Servidor de Jira (en las instalaciones)
- Centro de datos de Jira (en las instalaciones)
-
Jira Cloud
Selecciona desde la página de configuración de Jira Cards.- OAuth 2.0 (3LO)
¿Los datos están protegidos en tránsito entre Jira y Miro?
Usamos el protocolo de seguridad TLS. Cifra mensajes HTTP antes de la transmisión y los desencripta a su llegada. También tenemos soporte de TLS mutuo para el plan Enterprise.
¿Proveen soporte para TLS mutuo?
Sí, aquí encuentras más información.
¿Conservará Miro alguno de los datos de Jira del cliente?
Sí, Miro conserva los datos de la tarjeta que se añaden al tablero.
¿Cuánto dura el período de retención y cómo se protegerán los datos?
Para OAuth 1.0 (Jira Server o Jira Data Center), los datos también se actualizan si los webhooks se configuran durante el proceso de configuración del complemento de tarjetas de Jira. El período de retención es ilimitado. Solo se aplican los protocolos de seguridad generales de la cuenta de Miro.
¿Podemos restringir la información que se recupera de Miro?
No encontramos ninguna mención en documentación de Atlassian sobre cómo limitar la información a solo algunos campos.
¿Podemos tener un diagrama que muestre el flujo de datos entre Jira y Miro?
La información detallada se puede encontrar en este artículo de desarrolladores de Jira. Implementamos nuestra integración de acuerdo con la documentación de Atlassian.
¿Cómo se maneja el token?
OAuth 1.0: solo se usa el token de acceso. El token de acceso perdura 5 años a menos que se revoque (no hay opción de personalización, ya que esta política la define Atlassian. Puedes revocar el token desde Jira usando la interfaz web). Recuerda que cada nuevo token impide que la integración funcione y requiere volver a conectar la integración.
OAuth 2.0: el token de acceso dura 1 hora. El token de actualización dura 90 días (si pasas 90 días sin usar la integración, tendrás que volver a autenticarte).
¿Se usa un único token de acceso para todo el acceso a Jira del cliente?
Todo usuario de Miro que tenga la intención de importar, crear o editar Tarjetas Jira debe conectar sus credenciales de Jira individuales. Todas las acciones anteriores solo se pueden realizar en nombre de credenciales de Jira individuales.
¿Cómo se aseguran los tokens de solicitud, los tokens de acceso, las claves privadas y otros secretos/credenciales de OAuth?
Durante la integración, solo se usan tokens de acceso. Se almacenan de forma segura dentro de la base de datos y se utilizan solo desde el servidor.
Para OAuth 1.0. (Servidor de Jira y centro de datos) el authToken solo se usa para el webhook. No es el token de autenticación real que utiliza OAuth. Las solicitudes se envían a través de una conexión cifrada. La clave secreta se genera automáticamente y se asocia según el equipo.
¿Qué endpoints usa tu integración?
POST /rest/api/2/issue - create new issue
PUT /rest/api/2/issue/id - update issue
GET /rest/api/2/user/picker?query=xx
GET /rest/api/2/myself
GET /rest/api/2/filter/favourite
GET /rest/api/2/issue/picker
GET /rest/api/2/serverInfo
GET /rest/api/2/issue/$key
GET /rest/api/2/issue/createmeta
GET /rest/api/2/issue/$key/editmeta
GET /rest/api/2/priority
GET /rest/api/2/issuetype
GET /rest/api/2/mypermissions
Para OAuth 1.0. (Jira Server y Jira Data Center) además, usamos:
POST /rest/webhooks/1.0/webhook
¿Funcionan las tarjetas con Jira Datacenter?
Sí. Tenemos la aprobación de Atlassian y muchos de nuestros clientes ya usan tarjetas de Jira con Datacenter de manera exitosa. El procedimiento de instalación es el mismo.
¿Qué IPs usan para comunicarse con el sistema de Jira?
La lista de nuestras direcciones IP estáticas se puede encontrar aquí.
Ten en cuenta que estas direcciones se usan únicamente para comunicarse con el sistema de Jira. Las IP de la aplicación de Miro son dinámicas y, para garantizar que todas las funcionalidades de los tableros de Miro (incluidas algunas de las relacionadas con las tarjetas de Jira) funcionen correctamente, te pedimos que agregues nuestros dominios a tu lista de admitidos.
¿Podemos integrar Jira con Miro, pero bloquear en Miro aquellas incidencias de Jira cuyo nivel de seguridad esté establecido como "Privado"?
No, eso no es posible. Los niveles de seguridad en Jira no se correlacionan con Miro.
¿Podemos conectar Miro a Jira si usamos un servidor de Jira?
Miro es una herramienta en línea, por lo que solo puedes configurar la integración si tu instancia de Jira está abierta al internet público.
¿Podemos conectar múltiples instancias de Jira al mismo tiempo?
Sí. Ten en cuenta, sin embargo, que conectar una instancia de Jira consiste en establecer el vínculo inicial, mientras que una conexión activa se refiere a la instancia vinculada que está actualmente en uso. Una conexión activa determina desde dónde se importan las tarjetas de Jira cuando abres la aplicación de tarjetas de Jira y para qué instancia están autorizados los usuarios. Para un mismo usuario, solo puede haber una (1) conexión activa a la vez. Con OAuth 2.0, un usuario puede editar cualquier tarjeta de Jira asociada a cualquier instancia vinculada para la cual ya esté autenticado. Con cualquier otro protocolo de autenticación, todo el equipo comparte una instancia activa y solo puede importar e interactuar con las tarjetas de esa instancia. Puedes definir múltiples configuraciones a nivel de organización y cambiar entre conexiones activas a nivel de equipo.
¿Qué es el proceso de migración de servidor a nube?
Dado que la URL base de Jira cambiará inevitablemente durante la migración a la nube, la integración se interrumpirá sin cambios por nuestra parte. Comunícate con el equipo de soporte de Miro para obtener ayuda.
¿Creará Miro un webhook por equipo, por proyecto o por instancia de Miro?
Si habilitas Webhook automático en la configuración de Miro, la creación de webhooks se realiza automáticamente. Si usas autorización a nivel de equipo con Jira, Miro crea webhooks por equipo. Si usas autorización a nivel de organización, Miro crea webhooks por organización.
¿El plugin de Tarjetas Jira es compatible con proyectos Next-Gen?
Sí, es compatible.
Ten en cuenta que actualmente no hay enlace/campo Epic cuando se crea una Tarjeta Jira para un proyecto de Next-Gen desde Miro.
¿Son compatibles los campos Jira personalizados?
Sí, ofrecemos casi todos los campos personalizados de tipo básico. Si tienes un campo de tipo de datos complejo, es posible que no sea compatible y cause algún comportamiento inesperado al actualizar o crear tarjetas de Jira en el tablero.
¿Qué pasará con las tarjetas de Jira existentes si cambiamos a otra instancia de Jira?
Actualmente, cuando mueves incidencias de Jira de un proyecto a otro en Jira, dejan de actualizarse en Miro.
Como solución, te recomendamos copiar la URL de la incidencia de Jira (Ctrl/Cmd+C) y pegarla en un tablero de Miro (Ctrl/Cmd+V). Así, una tarjeta de Jira mostrará los nuevos valores y se actualizará automáticamente.
Si un tablero se mueve a otro equipo de Miro, ¿qué pasará con las tarjetas de Jira del tablero?
Las tarjetas de Jira permanecerán en el tablero, pero nadie podrá modificarlas (incluso si la misma instancia de Jira está configurada para el equipo objetivo).
Al hacer clic en una tarjeta, verás el mensaje: "Se importó la tarjeta de Jira desde otra cuenta". Si quieres que las tarjetas sean editables, impórtalas de nuevo al tablero.
¿La integración de las tarjetas de Jira tiene algún costo adicional?
Las tarjetas de Jira están disponibles en todos los planes de pago y Education sin costo adicional (plan Starter, Business, Education y Enterprise).
¿Puede un usuario acceder a todas las tarjetas de Jira en el tablero?
Los permisos para la integración de las tarjetas de Jira aseguran que los usuarios solo pueden crear y editar tarjetas en los proyectos de Jira a los que tengan acceso.
Como todos los widgets de un tablero de Miro son visibles para todos los que tienen acceso al tablero, si alguien no tiene credenciales de Jira o no dispone de las credenciales correctas, podrá ver la tarjeta de Jira colapsada en el tablero (con el título y algunos otros campos), pero no podrá expandirla para revisarla completamente o modificarla.
¿Atlassian dejó de ofrecer soporte para Jira Server?
Sí, Atlassian dejó de ofrecer soporte para Jira Server a partir de febrero de 2024.
¿Miro Planificador/tarjetas de Jira admite los campos personalizados de Jira: Tipos de incidencia personalizados y Dependencias personalizadas?
Sí, ambos son compatibles. Si los campos Tipos de incidencia personalizados y Dependencias personalizadas están configurados en Jira, y Miro Planificador está autenticado en esa instancia de Jira, entonces estos campos personalizados estarán disponibles en el Planificador.
¿Miro admite OAuth 2.0 para Jira Data Center?
Sí. Consulta Conectar con Jira Data Center mediante OAuth 2.0.
¿Cómo puedo importar incidencias de Jira a tablas y cronogramas?
Puedes arrastrar y soltar una o varias tarjetas de Jira directamente a una tabla o a un cronograma. Actualmente, esta es la única forma de hacerlo.
¿Qué campos de la tabla se vinculan con Jira?
Campos del sistema de Jira:
- Título
- Descripción
- Fecha de finalización (Fecha de vencimiento en Jira)
- Persona asignada
- Estado
Campos personalizados de Jira: - Cualquier campo personalizado que agregues usando Agregar campos de Jira, además de los siguientes campos mapeados automáticamente: Fecha de inicio, Estimación. Para agregar campos personalizados a una tabla, haz clic en el botón de más (+) en la parte superior de la tabla y selecciona Agregar campos de Jira. Luego elige cualquier campo personalizado que quieras sincronizar.
¿Qué campos de la Tabla no se sincronizan con Jira?
Haz clic en una celda para ver qué campos se sincronizan con Jira. Cualquier campo que se sincronice aparece con el logo de Jira. Todos los demás campos se almacenan solo en Miro y no se sincronizan con Jira.
¿Por qué no puedo editar un campo en la Tabla o el Cronograma de entre los cinco campos de Jira compatibles mencionados arriba?
Es posible que el campo no esté presente en la pantalla de edición en Jira.
Una forma fácil de comprobar si el campo está presente en la pantalla de edición es:
En Miro, abre el panel lateral de la tarjeta de Jira. Verifica si el campo aparece en el panel lateral. Si el campo no aparece, debes agregarlo a la pantalla de edición en Jira.
En algunos casos raros, los campos son editables en Jira pero no aparecen en la pantalla de edición de Jira. En ese caso, esos campos no se pueden editar desde Miro.
¿El campo que no puedes editar es Start date o Estimate? Si es así:
El campo puede no estar presente en Jira o faltar en la pantalla de edición (consulta el punto anterior)
Puede haber un problema de mapeo con Fecha de inicio o Estimación, ya que son campos personalizados de Jira.
Mapeamos estos campos según esta lógica:
- Fecha de inicio: Comprobamos campos llamados: Start Date , StartDate, Target Start
- Estimación: Comprobamos campos llamados: Story Points, Story point estimate, Story Point, StoryPoints, StoryPoint
- Si el campo Fecha de inicio o Estimación no tiene alguno de los nombres indicados arriba, esto podría explicar por qué no se puede editar.
¿Por qué al editar la Fecha de inicio o la Estimación en la Tabla o el cronograma de Miro no funciona o actualiza el campo equivocado en Jira?
Actualmente dependemos del mapeo automático para los campos Start Date y Estimate en Jira. Como estos son campos personalizados en Jira, puede darse el caso de que varios campos en la configuración de su Jira coincidan con los criterios mencionados anteriormente.
Seleccionamos la primera coincidencia según el orden de los nombres de campo mencionados anteriormente:
Por ejemplo, si una incidencia de Jira tiene tanto los campos Story Points como Story point estimate, emparejamos el primero según la lista anterior, que es Story Points. Por lo tanto, cualquier cambio en el campo Estimate en la Tabla actualizará el campo Story Points en Jira, no el campo Story point estimate.
Por el momento, no hay solución alternativa para esto. Si experimenta este problema, envíe comentarios a su equipo de soporte para que podamos comprender mejor sus necesidades mientras desarrollamos capacidades más avanzadas de mapeo de campos.
¿Por qué no puedo importar tarjetas de Jira desde 2 instancias diferentes en una Tabla o un Cronograma?
Actualmente solo admitimos una instancia de Jira por tabla/cronograma. Una vez que se importa una tarjeta de Jira en una tabla/cronograma, la tabla/cronograma queda vinculada a esa instancia de Jira específica.
Incluso si se eliminan todos los registros de Jira, el vínculo con la instancia original de Jira permanece. Para importar tarjetas desde otra instancia de Jira, debes crear una nueva tabla/cronograma.
¿Por qué no puedo ver o editar los campos Estado y Responsable de mis registros de Jira en una tabla o en el cronograma?
Actualmente, los campos Estado y Responsable de Jira no son compatibles con las tablas y el cronograma. Hemos decidido deshabilitar estos campos en las tablas y el cronograma para gestionar expectativas, evitar confusiones y posibles pérdidas de datos. Los campos Estado y Responsable de Jira y su contenido existen, pero no aparecen en las tablas ni en el cronograma.
Aún puedes editar estos campos directamente en las tarjetas de Jira desde el panel lateral. Simplemente arrastra la fila desde la tabla o el cronograma al lienzo para que la tarjeta de Jira vuelva a aparecer.
Más información: