Primeros pasos con la integración de Jira
Configurar la integración de Jira es rápido y sencillo. Este documento te guiará a través de la configuración necesaria que permitirá a toda tu organización utilizar esta potente integración.
Conectar a Jira Cloud
Para comenzar, un administrador del Portal de Cuentas de axe debe establecer una conexión autenticada con su instancia de Jira. Esta conexión se usará en toda su organización, por lo que es importante que el usuario que establezca la conexión tenga acceso a cada proyecto al que desees enviar incidencias.
- Navegue al página de "CONFIGURACIÓN" dentro del Portal de Cuentas de axe
- Haz clic en el enlace "Integraciones" dentro de la navegación de "Configuración"
- Haga clic en el botón "Agregar nueva conexión a Jira Cloud"

- Se abrirá una nueva ventana emergente (consentimiento OAuth) en la que se te pedirá iniciar sesión (si ya tienes una sesión activa de Jira, este paso se omite)
- Una vez autenticado con Jira, se te pedirá que elijas una instancia de Jira a la que conectar en la lista selectora "Usar aplicación en"
- Haz clic en "Aceptar" una vez que hayas elegido una instancia de Jira
- La ventana emergente se cerrará y se mostrará un cuadro de diálogo de confirmación
- Confirma la instancia de Jira a la que deseas conectarte en el desplegable
- Haz clic en "Finalizar"
- Aparecerá un mensaje "Conectado exitosamente a Jira" una vez conectado

Conectar a Jira Data Center
- Navegue al página de "CONFIGURACIÓN" dentro del Portal de Cuentas de axe
- Haz clic en el enlace "Integraciones" dentro de la navegación de "Configuración"
- Haz clic en el botón "Añadir nueva conexión a Jira Data Center"
- Haz clic en el botón "Configurar ajustes" (bajo el texto "Conexión no configurada")
- Proporcione su URL del Centro de Datos de Jira (por ejemplo,
https://jira.mycompany.com)
- Proporciona tu Clave de Consumidor (debe coincidir con lo que ingresas en Jira).
- En Jira Data Center...
- Haz clic en el botón "Ajustes" (icono de engranaje en la esquina superior derecha de la página)
- Haz clic en el enlace "Aplicaciones"
- Haz clic en el enlace "Enlaces de Aplicación"
- Ingrese
https://www.deque.comcomo la URL en el campo de texto - Haz clic en el botón "Crear Nuevo Enlace"
- Haz clic en el botón "Continuar"
- Si ves una advertencia similar a "No se recibió respuesta de la URL que ingresaste" o sobre redireccionamientos, puedes ignorarla. La URL no se utiliza para ningún tipo de validación; simplemente es un campo requerido para configurar apropiadamente la conexión
- Proporcione un Nombre de la Aplicación (por ejemplo, "Integración Jira de Deque"; tendrá que proporcionar este mismo valor en la página de configuración del Centro de Datos de Jira)
- Marca la casilla "Crear enlace entrante"
- Haz clic en el botón "Continuar"
- Ingrese un valor en el campo Consumer Key (por ejemplo, "DequeOAuthKey")
- Ingrese un valor en el campo Nombre del Consumidor (por ejemplo, "Integración Jira de Deque")
- Ingrese la clave pública mostrada en la página "Configuración del Centro de Datos de Jira" en el campo Campo de Clave Pública
- De vuelta en la página de Configuración de Jira Data Center en el portal de cuentas de axe...
- ingrese el mismo Consumer Key que ingresó en el Centro de Datos de Jira
- Haga clic en el botón „Guardar“
- Haga clic en el botón „Conectar a Integración“
- En la ventana emergente, inicie sesión en Data Center si aún no lo ha hecho
- Haga clic en „Permitir“
- Cierre la ventana
Requisito previo para la conexión de Jira Cloud desde la instancia de Deque On-Premises
Registrar la aplicación cliente de Jira
- Navegue a https://developer.atlassian.com/console/myapps/
- Haga clic en el botón „Crear“ y elija la integración „OAuth 2.0“
- Proporcione un nombre (por ejemplo, „Acme Corp - axe on-prem - Jira Cloud Integration“)
- Marque la casilla Acepto estar sujeto a los términos para desarrolladores de Atlassian y haga clic en el botón "Crear"
- En la pestaña „Distribución“, haga clic en „Editar“ y seleccione „Compartir“ para „Estado de Distribución“
- Defina „Nombre del proveedor“ como „Deque“
- Configure "Política de privacidad" a "https://www.deque.com/privacy-policy/"
- Defina „¿Su aplicación almacena datos personales?“ como „No“
- Guardar cambios
- En la pestaña „Permisos“, haga clic en el botón „Añadir“ (junto a „Jira API“)
- Una vez listo para la configuración (espere un momento), el botón „Añadir“ será reemplazado por un nuevo botón „Configurar“
- Si el botón „Configurar“ no aparece, intente recargar la página
- Haga clic en „Configurar“
- Haga clic en „Editar Alcances“
- marque las siguientes casillas: „read:jira-work“, „read:jira-user“, „write:jira-work“ y „manage:jira-webhook“
- En la pestaña „Autorización“, haga clic en el botón „Añadir“
- Configure "URL de devolución de llamada" a "https://axe.deque.com/jira-direct/connected"
- Haga clic en el botón „Guardar Cambios“
- Descargue esta imagen (clic derecho > guardar imagen como):

- En la pestaña „Configuración“, haga clic en „Cambiar avatar“ y seleccione el logo de axe que acaba de guardar
- En la sección „Detalles de autenticación“, guarde el „ID de cliente“ y el „Secreto“, ya que se utilizan como parte de su instalación en las instalaciones
- Una vez completada su instalación local de Deque, siga los pasos anteriores para establecer la conexión con Jira cloud
Desconectando una Conexión Activa
Al hacer clic en „Desconectar de Jira“ se invalidará la sesión de autenticación activa previamente establecida con Jira. Además, los usuarios ya no podrán enviar problemas a la instancia de Jira que se desconectó.
Para reconectar una conexión desconectada, haga clic en el botón "Conectar a Jira" que lo guiará por el pasos de conexión nuevamente.
Se debe evitar crear múltiples conexiones activas con la misma instancia de Jira. En su lugar, un usuario con todos los accesos requeridos en Jira (permisos, proyectos, etc.) debería establecer la conexión.
Eliminar una conexión
Una vez que una conexión ha sido desconectada, puede eliminarla haciendo clic en "Eliminar conexión a Jira".
Todavía puede conectarse a una instancia que ha sido previamente desconectada y eliminada. Simplemente siga los pasos para establecer una nueva conexión.
Plantillas
Una vez que un establecido una conexión, se pueden crear plantillas para estandarizar cómo se asignan los problemas de axe a los campos de Jira. Las plantillas ayudan a garantizar una creación de problemas consistente en toda su organización.
Para obtener información detallada sobre la creación, gestión y uso de plantillas, consulte nuestro documentación de Plantillas.
Enviando problemas a Jira
Una vez que haya establecido una conexión con Jira y creado plantillas, puede comenzar a enviar problemas de axe a Jira. El proceso le permite enviar problemas individuales o grupos de problemas para crear tickets en Jira.
