Disponible para: Jira Cloud, Jira Server (en instalaciones) y Datacenter (protegido por LDAP también)
Configurado por: admin de equipo de Miro y admin de sistema de Jira con permisos administrativos de proyecto.
⚠️ Si surge algún problema técnico consulta nuestro artículo sobre Posibles problemas y cómo resolverlos.
💡 Obtén más información sobre las tarjetas de Jira en los artículos Preguntas frecuentes sobre las tarjetas de Jira y Cómo configurar webhooks para tarjetas de Jira.
Configurar Miro en Jira
✏️ Ten presente que los menús de Jira pueden diferir dependiendo de la versión de Jira que estés usando. Sin embargo, el flujo general debería ser el mismo. Las siguientes instrucciones también se pueden encontrar en el Soporte de Atlassian.
Paso 1: enlace de la aplicación
Primero, crea un enlace de la aplicación y configúralo.
- Ve a Jira Settings (configuración de Jira) > Products (productos) > Integrations (integraciones) > Application links (enlaces de aplicación) > Create link (crear enlace):
Ten en cuenta que la interfaz de Jira podría verse diferente según la versión de Jira
- Elige Enlace directo de la aplicación y escribe https://miro.com/ en el campo URL de la aplicación.
Importante: debes escribir la URL en este formato exacto. Haz clic en Continuar.
Crear el enlace
- En el siguiente menú, simplemente haz clic en Continuar nuevamente.
- En el menú Revisar enlace, comprueba que la URL siga siendo exactamente https://miro.com/ y escribe el Nombre de la aplicación que elijas. Desplázate hacia abajo y, en la parte inferior, marca la casilla Crear enlace entrante. Omite el resto de los campos y haz clic en Continue (continuar).
- Aquí verás los campos de los valores de Miro. Para obtener los valores, inicia sesión en Miro y ve a Configuración de equipo > Aplicaciones e integraciones > Tarjetas de Jira.
Si no tienes tarjetas de Jira en tu lista de aplicaciones, desplázate hasta la parte superior de la sección, haz clic en Instalar aplicaciones y procede a instalar la aplicación desde el Marketplace de Miro. Después de que veas la opción tarjetas de Jira en la lista, haz clic para abrirla.
Se abrirá la pestaña del plugin y verás el Paso 1 para obtener los valores necesarios:Valores de las tarjetas de Jira
Copia los valores y agrégalos al menú Review link (revisar enlace) de Atlassian. - Verás el mensaje de procesamiento durante algunos segundos:
El último paso de la creación del enlace
Con esto, finalizan los pasos en Atlassian. El enlace aparecerá en la lista de enlaces de tu aplicación.
Paso 2: conexión
Vuelve a la Configuración de tarjetas de Jira en Miro y elige una de las dos opciones: crear un webhook manualmente o automáticamente. Si eliges hacerlo manualmente, desmarca la opción. Consulta más información en este artículo. Recomendamos usar el webhook automático para que no tengas que restablecerlo en caso de que apliquen grandes actualizaciones al plugin.
Por último, ingresa tu URL de Jira y haz clic en Conectar:
Conectar tarjetas de Jira
Para obtener la URL de Jira, copia el URL base de tu instancia de Jira. Aceptamos los siguientes formatos:
https://name.domain/
https://name.domain:port/
https://IPaddress/
https://IPaddress:port/
Si tu URL de Jira no es aceptada, consulta este artículo. Comprueba también que Miro tenga suficiente acceso a tu Jira para establecer la conexión.
Ya tienes conectada tu instancia de Jira a tu equipo de Miro.
⚠️ Ten en cuenta que Jira Server se descontinuará en febrero de 2024. Sin embargo, los pasos a continuación funcionarán de manera similar con Jira Data Center.
- Ve a https://your-jira-server/plugins/servlet/applinks/listApplicationLinks. Si no está seleccionado "Application links" (enlaces de aplicación), haz clic en esa opción.
Enlaces de aplicación de Jira
- Haz clic en Create link (crear enlace). Selecciona "Atlassian product (producto de Atlassian) y proporciona la URL de la aplicación, https://miro.com. Haz clic en Continue (continuar).
Configurar la URL de la aplicación
- Se te dirigirá al cuadro de diálogo "Link applications" (vincular aplicaciones). Añade un nombre para la aplicación en Application Name (por ejemplo, tarjeta de Jira en Miro) y selecciona Generic Application (aplicación genérica) para Application Type (tipo de aplicación).
Deberías ver la URL de tu aplicación de Jira debajo de "You are creating a link from:" (estás creando un vínculo de:) y deberías ver https://miro.com debajo de "To this application:" (a esta aplicación:). Haz clic en Continue (continuar).Configurar los detalles de vinculación de las aplicaciones
- Se procesará la configuración del enlace. Cuando termine, verás tu nuevo enlace en el área de "Vínculos de la aplicación" de Jira Server.
Tu aplicación configurada en Jira Server
- A continuación, tendrás que configurar los detalles de la aplicación. Haz clic en el ícono de lápiz de la aplicación para editar sus detalles.
- En el cuadro de diálogo Configure (configurar), haz clic en la opción Incoming authentication (autenticación entrante). Completa los campos Consumer Key, Consumer Name y Public Key (clave de consumidor, nombre de consumidor, clave pública) y, opcionalmente, agrega una descripción. Esta información se encuentra en Miro en la Configuración de equipo, bajo Aplicaciones e integraciones.Article-360019501754.json+html
Configurar los detalles de autenticación entrante en Jira Server
Detalles de vinculación de la aplicación de Jira en Miro
- Desplázate hasta el final de las opciones de Incoming authentication (autenticación entrante) y haz clic en Save (guardar). El estado de la verificación debería estar confirmado. Luego, podrás usar este Jira Server dentro de Miro con tarjetas de Jira. Asegúrate de elegir "Jira Server" y "OAuth 1.0" en Miro
.
Autorización del usuario
Después de que se conecte la integración, cada uno de tus usuarios finales debe conectar su perfil personal de Jira para establecer los permisos correspondientes; de esta manera, te aseguras de que el acceso de cada usuario del lado de Miro sea exactamente el mismo que el del lado de tu instancia de Jira. Cuando los usuarios finales intenten importar o editar una tarjeta de Jira por primera vez, se les pedirá que inicien sesión en Jira con sus credenciales de usuario individuales.
Después de hacer esto, los usuarios pueden agregar tareas como tarjetas en la pizarra. Todos los cambios realizados en Jira se reflejan en las tarjetas de Jira en el tablero.
✏️ Si un usuario no tiene las credenciales de Jira y tiene acceso al tablero al que se agregó la tarjeta, podrá ver el título de la tarjeta, el tipo de problema, la prioridad, la persona asignada y los atributos configurados para aparecer en la tarjeta de Jira. Sin embargo, no podrá expandir la tarjeta para ver otros atributos ni editarla, a menos que se le autorice. Si el usuario no conecta sus credenciales de Jira, no verá el avatar de la persona asignada y la apariencia general de la tarjeta será diferente.
Usar una instancia de Jira para varios equipos de Miro (opcional)
Ten en cuenta que las tarjetas se instalan en equipo, por lo que, si estás usando nuestro plan Enterprise y tienes varios equipos, deberás repetir el paso 2 para cada uno de los equipos que quieras conectar. El enlace de la aplicación existente se usará para todos ellos.
Después de que conectes tu equipo a una instancia de Jira, se crea un nuevo WebHook en tus WebHooks de Jira, para el equipo de Miro específico con el que te conectaste. Crear un webhook es establecer el canal para las solicitudes de actualización.
⚠️ Si planeas conectar varios equipos, te recomendamos firmemente que vayas a tu página de WebHooks de Jira y que edites cada WebHook que hayas creado recientemente para que tenga un nombre único; de lo contrario, podrías confundirte.
No es posible conectar varias instancias de Jira a un equipo de Miro.
Cómo desinstalar el plugin
Ve a Configuración de equipo > Aplicaciones e integraciones > Tarjetas de Jira y deshabilita tu URL de Jira en el Paso 2. Luego, haz clic en Desinstalar para el equipo.
Desinstalar tarjetas de Jira
💡 ¡No olvides mirar el artículo principal sobre cómo usar las tarjetas de Jira!