Disponible para: Jira Cloud, Jira Server (en las instalaciones) y Datacenter (también protegido por LDAP)
Configurado por: Admin de equipo de Miro y admin de sistema de Jira con permisos administrativos de proyecto
✏️ El siguiente método de autenticación OAuth1.0 dejará de ser compatible en Miro a partir del 1 de julio de 2025. OAuth1.0 es un protocolo de autenticación en desuso en Jira y no debe ser usado. Este cambio es parte de una transición más amplia hacia OAuth2.0, que se recomienda de acuerdo con las mejores prácticas de seguridad. Se recomienda a los usuarios migrar a OAuth2.0 para garantizar el soporte continuo y la compatibilidad con los servicios de Miro.
Configurar Miro en Jira
⚠️ 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 webHook para tarjetas de Jira.
✏️ Ten en cuenta 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 instrucciones a continuación también se pueden encontrar en Soporte de Atlassian.
Paso 1: enlace de la aplicación
Primero, crea un enlace de la aplicación y configúralo.
- Ve a Configuración de Jira > Productos > Integraciones > Enlaces de aplicación > Crear enlace:
Ten en cuenta que la interfaz de Jira puede variar dependiendo de tu 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 ingresar 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, al final, marca la casilla Crear enlace entrante. Omite el resto de los campos y haz clic en Continuar.
Solo debes completar el campo Nombre de la aplicación
- Aquí verás los campos de los valores de Miro. Para obtener los valores, inicia sesión en Miro.
- Para la integración a nivel de equipo, ve a Configuración del equipo > Aplicaciones e Integraciones > Tarjetas Jira.
- Para la integración a nivel organizacional, ve a Configuración de la compañía > Aplicaciones > Gestionar aplicaciones > Tarjetas de Jira > Configuración.
Si no tienes Tarjetas Jira en tu lista de Apps, 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 las Tarjetas Jira en la lista, haz clic para abrirla.
La pestaña del plugin se abrirá y podrás ver el Paso 1 para obtener los valores necesarios:Valores de las cartas de Jira
Copia los valores y agrégalos al menú Revisar enlace de Atlassian.
- Verás el mensaje de procesamiento durante uno o dos momentos:
El último paso de la creación del enlace
Ya no hay más pasos que seguir desde Atlassian. El enlace aparecerá en la lista de enlaces de tu aplicación.
Paso 2: conexión
Vuelve a la configuración de tus tarjetas Jira en Miro y elige una de las dos opciones: crear un webhook de forma manual o automática. Si eliges manualmente, desmarca la opción. Consulta más información en este artículo. Recomendamos encarecidamente usar el webhook automático para que no tengas que restablecerlo en caso de grandes actualizaciones al plugin.
Por último, ingresa tu URL de Jira y haz clic en Conectar:
Conectando 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.
⚠️ Aunque Atlassian dejará de dar soporte a Jira Server a partir de febrero de 2024, Miro seguirá apoyando la integración de Tarjetas Jira para Jira Server en el futuro previsible.
- Ve a https://your-jira-server/plugins/servlet/applinks/listApplicationLinks. Si "Application links" no está seleccionado, haz clic en él.
Enlaces de aplicaciones del servidor Jira
- Haz clic en Crear enlace. Selecciona "Producto de Atlassian" y proporciona la URL de la aplicación, "https://miro.com". Haz clic en Continuar.
Configurar la URL de la Aplicación
- Serás llevado al cuadro de diálogo "Vincular aplicaciones". Añade un nombre de la aplicación (por ejemplo, Miro Jira Card) y selecciona "Aplicación genérica" para el tipo de aplicación.
Deberías ver la URL de tu aplicación de Jira bajo "Estás creando un enlace desde:", y deberías ver https://miro.com bajo "Para esta aplicación:". Haz clic en Continuar.Configurando detalles de aplicaciones del enlace
- La configuración del enlace se procesará. Cuando termine, verás tu nuevo enlace en el área de "Enlaces de la aplicación" de Jira Server.
Tu aplicación configurada en Jira Server
- A continuación, necesitarás configurar los detalles de tu aplicación. Haz clic en el ícono de lápiz de tu aplicación para editar los detalles de la aplicación.
- En el cuadro de diálogo Configurar, haz clic en la opción Autenticación entrante. Rellena la Clave del Consumidor, Nombre del Consumidor, Clave Pública y opcionalmente una descripción.
- Para la integración a nivel de equipo, esta información está disponible en Configuración de equipo > Aplicaciones e integraciones > Tarjetas Jira.
- Para la integración a nivel de organización, esta información está disponible en Configuración de la compañía > Aplicaciones > Gestionar aplicaciones > Tarjetas de Jira > Configuración.
Configurando los detalles de autenticación entrante en Jira Server
Detalles del enlace de la aplicación Jira en Miro
- Desplázate hasta el final de las opciones de autenticación entrante y haz clic en Guardar.</span> Tu estado de verificación debería estar confirmado ahora, y este Servidor Jira ya puede ser utilizado dentro de Miro para usar con Tarjetas Jira. Asegúrate de elegir "Jira Server" y "OAuth 1.0" en el lado de 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 adecuados. Esto asegura que el acceso de cada usuario del lado de Miro sea exactamente el mismo que en 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 credenciales de Jira pero tiene acceso al tablero donde se agregó la tarjeta, podrá ver el título de la tarjeta, el tipo de problema, la prioridad, el asignado y todos los atributos que estén configurados para mostrarse en la Tarjeta Jira. Sin embargo, no podrán expandir la tarjeta para ver otros atributos ni editarla, a menos que se autoricen. Si el usuario no conecta sus credenciales de Jira, no verá el avatar del asignado y la apariencia general de la tarjeta será diferente.
Usar una instancia de Jira para varios equipos de Miro
Puedes instalar Tarjetas a nivel del equipo o a nivel de la organización. Si tienes múltiples equipos, puedes aprovechar la configuración a nivel de organización para evitar repetir el procedimiento de configuración para cada equipo. El enlace de la aplicación existente se usa para todos los equipos.
Después de que conectes tu equipo u organización a una instancia de Jira, se crea un nuevo WebHook en tus WebHooks de Jira para ese equipo u organización de Miro. Crear un WebHook establece un canal para las solicitudes de actualización.
Si especificas configuraciones a nivel de organización, los equipos que ya están conectados mantienen sus configuraciones actuales. Sin embargo, pueden cambiar a los ajustes a nivel organizacional en cualquier momento.
Además, si es necesario, los equipos pueden anular la configuración a nivel de organización para conectarse a una instancia diferente de Jira.
Si eres cliente Enterprise y deseas migrar múltiples conexiones a nivel de equipo a la conexión predeterminada a nivel de organización, ponte en contacto con tu equipo de cuenta.
⚠️ Si deseas conectar varios equipos por separado, te recomendamos darle a cada webhook un nombre único. Ve a tu página de WebHooks de Jira y edita cada webhook recién creado.
No es posible conectar varias instancias de Jira a un equipo de Miro.
Cómo deshabilitar el plugin
Para la integración a nivel de equipo, ve a Configuración de equipo > Aplicaciones e integraciones > Tarjetas de Jira. Luego, selecciona Eliminar para el equipo.
Para la integración a nivel de organización, para restringir el uso de la aplicación Jira, ve a Configuración de la empresa > Aplicaciones > Gestionar aplicaciones > Tarjetas de Jira. Luego, mueve el interruptor a la posición de apagado.
⚠️ Si desactivas Jira para la organización, los usuarios de todos los equipos Enterprise no podrán usar las tarjetas de Jira. Para obtener más información sobre la gestión y restricción de aplicaciones, consulta Gestión de aplicaciones.
Para más información: Consulta Cómo usar las tarjetas de Jira.