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
-
Nube de Jira
Selecciona desde la página de configuración de tarjetas de Jira.- 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 soportamos TLS mutuo para el plan Enterprise.
¿Soportan TLS mutuo?
Sí, aprende más.
¿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 tiempo dura el período de retención y cómo se aseguran los datos?
Para OAuth 1.0. (Servidor de Jira o Centro de Datos), los datos se actualizan si los webhooks están configurados 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 Miro.
¿Podemos restringir la información que se recupera de Miro?
No encontramos ninguna mención en la 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?
Puedes encontrar información detallada en este artículo de Jira Developers. 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 por 5 años a menos que sea revocado (no hay opción de personalización, ya que esta política la define Atlassian. Puedes revocar el token desde Jira usando la interfaz de usuario web). Recuerda que cada nuevo token detiene la integración y requiere reconectarla.
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 token de acceso único para todos los accesos a Jira del cliente?
Cada usuario de Miro que desee importar, crear o editar tarjetas de 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 - crear nueva incidencia
PUT /rest/api/2/issue/id - actualizar incidencia
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. (Servidor de Jira y Datacenter) además, usamos:
POST /rest/webhooks/1.0/webhook
¿Funcionan las tarjetas de Jira con 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é IP usan actualmente para comunicarse con el sistema de Jira?
La lista de nuestras direcciones IP estáticas se puede encontrar aquí.
Ten en cuenta que estas son las direcciones utilizadas solo para comunicarse con el sistema de Jira. Las IP de la aplicación de Miro son dinámicas y, para asegurar que todas las funcionalidades de los tableros de Miro (incluidas algunas de las relacionadas con las tarjetas de Jira) se ejecuten con éxito, pedimos que se agreguen nuestros dominios a la lista de admitidos.
¿Podemos integrar Jira con Miro pero bloquear en Miro esas incidencias de Jira con nivel de seguridad configurado 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?
Como Miro es una herramienta en línea, solo puedes conectar a Jira si tu instancia está abierta al internet público.
¿Podemos conectar múltiples instancias de Jira al mismo tiempo?
Sí. Sin embargo, ten en cuenta que conectar una instancia de Jira se trata de establecer el enlace inicial, mientras que una conexión activa se refiere a la instancia vinculada que está actualmente en uso. Una conexión activa define de 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 usuario dado, solo puede haber una (1) conexión activa a la vez. Con OAuth 2.0, un usuario puede editar cualquier tarjeta de Jira asociada con cualquier instancia vinculada para la que ya esté autenticado. Para cualquier otro protocolo de autenticación, un equipo entero comparte una instancia activa y solo puede importar e interactuar con 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. Por favor, contacta al soporte de Miro para obtener ayuda.
¿Creará Miro un webhook por equipo, por proyecto o por instancia de Miro?
Si habilitas el Webhook Automático en tu configuración de Miro, la creación del webhook ocurre automáticamente. Si utilizas autorización a nivel de equipo con Jira, entonces Miro crea webhooks por equipo. Si utilizas autorización a nivel de organización, entonces Miro crea webhooks por organización.
¿El plugin de tarjetas de 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 de Jira para un proyecto de Next-Gen desde Miro.
¿Son compatibles los campos personalizados de Jira?
Sí, soportamos casi todos los campos personalizados de tipos básicos. 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é pasa 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á nuevos valores y se actualizará automáticamente.
Si un tablero se mueve a otro equipo de Miro, ¿qué pasa con las tarjetas Jira de ese 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 un mensaje: "La tarjeta JIRA se importó 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).
¿Un usuario puede 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 los tableros de Miro son visibles para todos los que tienen acceso al tablero, si alguien no tiene credenciales de Jira o no tiene las credenciales correctas, podrá ver la tarjeta de Jira colapsada en un tablero de Miro (con título y algunos otros campos), pero no podrá expandir la tarjeta para revisarla completamente o modificarla.
¿Ha descontinuado Atlassian el soporte para Jira Server?
Sí, Atlassian ha descontinuado el soporte para Jira Server desde febrero de 2024.
¿Miro Planificador/tarjetas de Jira admiten los campos personalizados de Jira: tipos de incidencia personalizados y dependencias personalizadas?
Sí, ambos son compatibles. Si los campos de tipos de incidencia personalizados y dependencias personalizadas están configurados en Jira y Miro Planificador está autenticado para esa instancia de Jira, entonces estos campos personalizados están disponibles en el planificador.
¿Miro admite OAuth 2.0 para Jira Data Center?
Sí. Consulta Conéctate al Jira Data Center usando OAuth 2.0.
¿Cómo puedo importar incidencias de Jira a Tablas y Cronograma?
Puedes arrastrar y soltar una o varias tarjetas de Jira directamente en una Tabla o Cronograma. Actualmente, esta es la única manera de hacerlo.
¿Qué campos de la Tabla están vinculados a Jira?
Campos del sistema Jira:
- Título
- Descripción
- Fecha de finalización (Fecha de vencimiento en Jira)
- Asignado a
- Estado
Campos personalizados de Jira:
- Fecha de inicio
- Estimación
Haz clic en una celda para ver qué campos se sincronizan con Jira. Cualquier campo que se sincroniza se muestra con un logotipo 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 cronograma de los cinco campos de Jira mencionados anteriormente?
Es posible que el campo no esté presente en la pantalla de edición en Jira.
Un control fácil para saber si el campo está presente en la pantalla de edición o no:
En Miro, abre el panel lateral para la tarjeta de Jira. Verifica si el campo está presente en el panel lateral. Si el campo no está presente, debes agregar el campo a la pantalla de edición en Jira.
Hay algunos casos excepcionales en los que los campos son editables en Jira, pero no están presentes en la pantalla de edición de Jira. En este caso, estos campos no se pueden editar en Miro.
¿Es el campo que no puedes editar Fecha de inicio o Estimación? Si es así:
El campo puede que no esté presente en Jira o falte en la pantalla de edición (consulta el punto anterior)
Puede haber un problema de mapeo para Fecha de inicio o Estimación, ya que estos son campos personalizados de Jira.
Mapeamos estos campos según la siguiente lógica:
- Fecha de inicio: Comprobamos los campos denominados: Start Date, StartDate, Target Start
- Estimación: Comprobamos los campos denominados: Story Points, Story point estimate, Story Point, StoryPoints, StoryPoint
- Si el campo de Fecha de inicio o Estimación no está nombrado como uno de los nombres siguientes, esto podría explicar por qué no funciona la edición.
¿Por qué la edición de la Fecha de inicio o Estimación en Miro Table o Timeline no funciona o actualiza el campo incorrecto en Jira?
Actualmente dependemos de la asignación automatizada para los campos de Fecha de inicio y Estimación en Jira. Dado que estos son personalizados en Jira, puede ocurrir que varios campos en tu configuración de Jira coincidan con los criterios mencionados anteriormente.
Seleccionamos la primera coincidencia de acuerdo al orden de los nombres de los campos mencionados arriba:
Por ejemplo, si un ticket de Jira tiene tanto campos de Puntos de historia como de estimación de puntos de historia, coincidimos con el primero según la lista anterior, que es Puntos de historia. Por lo tanto, cualquier cambio en el campo de Estimación en la tabla actualizará el campo de Puntos de historia en Jira, no el de estimación de puntos de historia.
En este momento, no hay una solución alternativa para esto. Si experimentas este problema, por favor envía comentarios a tu equipo de soporte para que podamos comprender mejor tus necesidades mientras desarrollamos capacidades más avanzadas de asignación de campos.
¿Por qué no puedo importar tarjetas de Jira desde 2 instancias diferentes a una tabla o cronograma?
Actualmente solo se admite una instancia de Jira por tabla/cronograma. Una vez que se importa una tarjeta de Jira a una tabla/cronograma, la tabla/cronograma está vinculada a esa instancia específica de Jira.
Incluso si se eliminan todos los registros de Jira, el enlace a la instancia original de Jira permanece. Para importar tarjetas de una instancia diferente de Jira, necesitas crear una nueva tabla/cronograma.
¿Por qué no puedo ver o editar los campos de Estado y Responsable para mis registros de Jira en una tabla o cronograma?
Actualmente, los campos de Estado y Responsable de Jira no son compatibles en tablas y cronograma. Hemos decidido deshabilitar estos campos en tablas y cronograma para gestionar expectativas, evitar confusiones y posibles pérdidas de datos. Los campos de Estado y Responsable de Jira y sus contenidos existen, pero no aparecen en tablas o cronograma.
Aún puedes editar estos campos directamente en las tarjetas de Jira usando el panel lateral. Simplemente arrastra la fila del cronograma o la tabla al lienzo para que tu tarjeta de Jira vuelva a aparecer.
Más información: