Conectar a Jira usando OAuth 1.0 (Actualizado)

Quién puede hacerlo: Admins de empresa y admins de equipo
¿Qué planes: Starter, Business, Enterprise
¿Qué plataformas? navegador, escritorio

Las organizaciones que no están listas para migrar a OAuth 2.0 pueden usar el siguiente procedimiento para conectar Miro a Jira usando OAuth 1.0.

Atlassian ha declarado obsoleto OAuth 1.0, y el método proporcionado en este artículo es una solución provisional. Para evitar incidencias y alinearte con las mejores prácticas de seguridad y compatibilidad, Miro recomienda encarecidamente que migres a OAuth 2.0 lo antes posible.

✏️ El método de autenticación OAuth 1.0 anterior está obsoleto y será eliminado el 31 de julio de 2025.

Este artículo también explica cómo usar una instancia de Jira para varios equipos de Miro y cómo deshabilitar las tarjetas de Jira a nivel de organización y de equipo.

Requisitos previos

• Asegúrate de tener los siguientes permisos:
  • admin de empresa de Miro Business, Enterprise
    Admin de equipo (Starter) de Miro
  • Admin del sistema Jira

    Para completar el procedimiento, debes poder crear un enlace de aplicación en Jira.

• En Jira, elimina cualquier enlace de aplicación existente a Miro.

Procedimiento

Para conectarte a Jira usando OAuth1.0, sigue estos pasos:

1. Desde tu panel de Miro, selecciona tu avatar en la esquina superior derecha y haz clic en admin Console.
2. En la barra lateral izquierda, ve a Aplicaciones e integraciones > Aplicaciones > pestaña Administrar aplicaciones.
3. Asegúrate de que Permitir solo aplicaciones de la siguiente lista esté habilitado.
4. En la columna App, para tarjetas de Jira selecciona configuración.
5. En la pestaña Ajustes predeterminados, selecciona Agregar nueva conexión.
6. En la configuración de Jira, selecciona Jira Cloud o Centro de datos de Jira.
7. En Método de autenticación, selecciona OAuth 1.0x (Actualizado).
8. Debajo de Jira URL, ingresa la URL de tu instancia de Jira.
9. (Opcional) Para hacer de esta conexión la conexión predeterminada para todos los equipos de tu organización, marca Hacer predeterminada.
10. Bajo Instrucciones de configuración, verifica que tengas las siguientes propiedades:
    • URL
    • Clave de consumidor
    • Nombre del consumidor
    • Clave pública
11. En Jira, crea un enlace de la aplicación.
    1. (Cloud) Ve a Configuración > Productos > Enlaces de aplicación.
       En la configuración de admin de Jira, ve a Productos > Enlaces de aplicación.
    2. Haz clic en Crear enlace.
    3. (Cloud) Para tipo de aplicación, selecciona aplicación directa.
       (Data Center) Para Tipo de aplicación, selecciona Producto de Atlassian.
    4. Para URL de la aplicación, pega la URL de las instrucciones de configuración de Miro. Ver paso 10.
    5. Haz clic en Continuar.
    6. Para nombre de la aplicación, nombra tu aplicación.

       ⚠️ No ingreses datos en ningún otro campo. Proporcionarás datos de Miro en el siguiente paso.

    7. Marca Crear enlace entrante.
    8. Haz clic en Continuar.
    9. Copia y pega tu clave del consumidor, nombre del consumidor y clave pública de las instrucciones de configuración de Miro. Ver el paso 10.
    10. Haz clic en Continuar.
        Has creado tu enlace de la aplicación.
12. En Miro, haz clic en Connect.
    Has conectado Miro a Jira usando OAuth 1.0.

Próximos pasos

Has configurado y conectado tu integración de Jira con Miro usando OAuth1.0 de Jira. Cuando un usuario intenta una acción relacionada con Jira en Miro por primera vez, se le pedirá que autentique. No necesitan volver a autenticarse.

Más información: Consulta Cómo usar tarjetas de Jira.

Una instancia de Jira para varios equipos de Miro

Puedes instalar tarjetas de Jira a nivel de organización o a nivel de equipo. Si tienes varios equipos, puedes especificar configuraciones a nivel de organización para evitar configuraciones repetitivas para cada equipo. El enlace de la aplicación existente se usará para todos los equipos.

No es posible conectar varias instancias de Jira a un equipo de Miro.

Para las solicitudes de actualización, después de que conectes tu organización o equipo a una instancia de Jira, se agrega un webhook a tus webhooks de Jira para esa organización o equipo de Miro.

💡 Asigna un nombre único a cada webhook por equipo. Ve a tu página de webhooks de Jira y edita cada webhook recién creado.

Si especificas configuraciones a nivel de organización, los equipos que ya tienen configuraciones propias de equipo mantienen su configuración. Cualquier equipo con su propia configuración puede cambiar a las configuraciones a nivel de organización en cualquier momento.

Por el contrario, cualquier equipo puede anular las configuraciones a nivel de organización para conectarse a una instancia de Jira separada.

Si estás en un plan Enterprise, contacta a tu equipo de cuenta para migrar varias conexiones a nivel de equipo a las configuraciones de nivel de organización.

Deshabilitar tarjetas de Jira

Nivel de la organización

Para deshabilitar tarjetas de Jira a nivel de la organización, sigue estos pasos:

1. Desde el panel de Miro, haz clic en tu avatar en la esquina superior derecha y selecciona Admin Console.
2. Ir a Aplicaciones e Integraciones > Administrar aplicaciones.
3. Ubicar tarjetas de Jira.
4. Para las tarjetas de Jira, cambia Permitido a la posición de apagado.

⚠️ Si deshabilitas las tarjetas de Jira para la organización, los miembros de todos los equipos Enterprise no podrán usar las tarjetas de Jira. Para obtener más información sobre la gestión de aplicaciones, consulta gestión de aplicaciones.

Nivel del equipo

Para deshabilitar las tarjetas de Jira a nivel de equipo, sigue estos pasos:

1. Desde el panel de Miro, haz clic en tu avatar en la esquina superior derecha y luego en Consola de administración.
2. Ir a Equipos.
3. Haz clic en la fila del equipo que quieras administrar.
   El panel de configuración de equipo se abre.
4. Haz clic en la pestaña Apps.
5. Localiza y haz clic en tarjetas de Jira.
6. Haz clic en Eliminar para el equipo.