Integrar Jira

Integre con Jira para hacer un seguimiento de los problemas y obtener actualizaciones automatizadas sobre las tareas en cualquier dispositivo, intranet o aplicación de mensajería.

Utilice el siguiente proceso para habilitar la integración con Jira. Después de completar este proceso, el nivel existente de registros de auditoría persiste, incluidas las acciones llevadas a cabo por el uso de microaplicaciones de Citrix.

Para obtener una lista completa de las microaplicaciones de Jira de uso inmediato, consulte Usar microaplicaciones de Jira.

Revisar requisitos previos

Todas las cuentas de usuario que quiera utilizar a través de esta integración deben tener visibilidad para su correo electrónico en la configuración de la cuenta, establecida en Anyone. Esto implica cuentas de servicio y cuentas con las que los usuarios inician sesión en Citrix Workspace a través de OAuth. Vaya a https://id.atlassian.com/manage-profile/profile-and-visibility e inicie sesión si es necesario. Diríjase a la sección Contact y, junto a la cuenta de correo electrónico, seleccione Anyone en el menú Who can see this?

Después de preparar esta integración en Jira, necesitará estos artefactos para agregar la integración en las microaplicaciones de Citrix Workspace:

  • dirección URL
  • Nombre de usuario
  • Contraseña: Deberá introducir el token de API como contraseña cuando agregue la integración a las microaplicaciones de Citrix Workspace
  • Método de autenticación (credenciales u OAuth2)

Para OAuth 2.0 también necesitará:

  • ID de cliente
  • Secreto del cliente

Nota: Se recomienda utilizar OAuth 2.0 como método de autenticación del servicio siempre que esté disponible. OAuth 2.0 garantiza que la integración es conforme a los requisitos de seguridad más estrictos con la microaplicación configurada.

Se deben cumplir los siguientes requisitos previos antes de comenzar el proceso de integración:

Habilitación de OAuth 2.0 (3LO)

Antes de implementar OAuth 2.0 (3LO), necesitará habilitarlo para su aplicación en la administración de aplicaciones de Jira.

  1. Vaya a Administración de aplicaciones.
  2. Cree una nueva aplicación seleccionando Crear nueva aplicación, introduzca un nombre, acepte los términos y seleccione Crear.
  3. Copie el ID y el **secreto del cliente** para su uso posterior
  4. En la sección API Y CARACTERÍSTICAS de la sección de navegación lateral, haga clic en +Agregar
  5. En la sección Características de la página API y características, busque OAuth 2.0 (3LO) y seleccione Agregar y, a continuación, Configurar.
  6. Introduzca la URL de respuesta. Establezca esta URL en cualquier URL a la que pueda acceder la aplicación. Cuando implemente OAuth 2.0 (3LO) en su aplicación (consulte la sección siguiente), el URI de redirección debe coincidir con esta URL.
  7. Haga clic en Guardar cambios.

Su pantalla tendrá un aspecto similar al siguiente: OAuth2 para Jira

Crear token de API

Un script u otro proceso puede usar un token de API para realizar la autenticación básica con aplicaciones de Jira Cloud o con Confluence Cloud. Si la cuenta de Atlassian con la que se autentica tiene habilitada la verificación en dos pasos, deberá usar un token de API. Vaya directamente a la página de tokens de API y al paso 3 si ha iniciado sesión con Tokens de API.

  1. Haga clic en su perfil de usuario en la sección inferior izquierda.
  2. Seleccione Perfil > Administrar su cuenta > Seguridad > Crear y administrar tokens de API.
  3. Seleccione Crear token de API e introduzca un nombre para el token en el campo Etiqueta.
  4. Copie en el portapapeles y guárdelo para su uso posterior.

Al agregar la integración a las microaplicaciones de Citrix Workspace, deberá introducir el token de API como su contraseña.

Agregar la API REST de la plataforma Jira

Si aún no ha agregado la API REST de la plataforma Jira, hágalo ahora.

  1. En la sección API Y CARACTERÍSTICAS de la sección de navegación lateral, haga clic en +Agregar.
  2. En la sección API de la página API y características, busque OAuth 2.0 (3LO) y seleccione Agregar y, a continuación, Configurar.
  3. Agregue los ámbitos deseados para su aplicación.

Establecer duración para obtener incidencias

Establezca el plazo para el que desea recuperar incidencias en Jira. Al agregar la integración a las microaplicaciones de Citrix Workspace, la cantidad de datos que la integración obtiene de Jira puede limitarse mediante un filtro de carga.

  1. Inicie sesión en Jira con su cuenta de usuario dedicada y contraseña.

    Nota:

    Si está utilizando una cuenta existente, el nombre de usuario no es la dirección de correo electrónico de la cuenta. Para encontrar el nombre de usuario de una cuenta, inicie sesión en su instancia de Jira, seleccione la miniatura del perfil y seleccione Perfil.

  2. Introduzca el número de días de incidencias que se van a obtener.

    Valor predeterminado: 90 días.

Agregar dirección URL de respuesta

Agregue una URL personalizada a la configuración de la instancia para dar acceso a datos privados y habilitar acciones de usuarios autenticados por OAuth. Inicie sesión en Jira como administrador y agregue la siguiente URL de redirección autorizada para esta integración:

https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback

Agregar la integración a las microaplicaciones de Citrix Workspace

Agregue la integración de Jira a las microaplicaciones de Citrix Workspace para conectarse a su aplicación. Esto proporciona microaplicaciones de uso inmediato con notificaciones y acciones preconfiguradas que se pueden usar desde ya en su espacio de trabajo.

Siga estos pasos:

  1. En la página de descripción general, seleccione Introducción.

    Se abrirá la página Administrar integraciones.

  2. Seleccione Agregar nueva integración y Agregar una nueva integración a partir de plantillas proporcionadas por Citrix.
  3. Elija el mosaico Jira que desea agregar.
  4. Introduzca un nombre para la integración.

    Parámetros del conector de Jira, URL, nombre de usuario, contraseña, autenticación de usuario

  5. Introduzca los parámetros del conector que recopiló como requisitos previos.
    • Introduzca su URL.
    • Introduzca su nombre de usuario y contraseña para autenticación de servicio.

      Nota:

      Introduzca el token de API que recopiló en un paso anterior como contraseña cuando agregue la integración a las microaplicaciones de Citrix Workspace.

  6. Seleccione un método de autenticación. Utilice el protocolo de seguridad de OAuth 2.0 para generar tokens de solicitud/autorización para el acceso delegado.
    • Credenciales: Se utilizan las credenciales del cliente.
    • Oauth 2.0: Introduzca el ID de cliente de OAuth y el secreto de cliente de OAuth que recopiló en el procedimiento de requisitos previos.
  7. Seleccione el número de semanas de tíquets con modificaciones por cargar.
  8. Seleccione Agregar.

Se abrirá la página Integraciones de microaplicaciones con la integración agregada y sus microaplicaciones. Desde aquí, puede agregar otra integración, seguir configurando sus microaplicaciones de uso inmediato o crear una nueva microaplicación para esta integración.

Ya tiene todo listo para configurar y llevar a cabo su primera sincronización de datos. Como se puede extraer una gran cantidad de datos de la aplicación integrada y transferirla a la plataforma de microaplicaciones, le recomendamos utilizar la página Tabla para filtrar entidades relacionadas con la primera sincronización de datos y, así, acelerar la sincronización.

Para obtener más información, consulte Verificar las entidades necesarias y Establecer sincronización de datos en el artículo Configurar la integración.

Para obtener información detallada sobre los dispositivos de punto final de las API y las entidades de tabla, consulte Especificaciones del conector de Jira.

Usar microaplicaciones de Jira

Las integraciones de las aplicaciones existentes vienen con microaplicaciones de uso inmediato. Comience con estas microaplicaciones y personalícelas conforme a sus exigencias.

Microaplicaciones de Jira

Nuestra integración de Jira incluye las siguientes microaplicaciones preconfiguradas de uso inmediato:

Crear tíquet: Crea un nuevo tíquet de Jira con información detallada.

Notificación o página Flujos de trabajo por caso de uso
Página Crear tíquet Proporciona un formulario para crear un tíquet de Jira, que incluye la selección de un tipo de problema, un proyecto y opcionalmente un usuario asignado, así como un campo para agregar una descripción.

Tíquets: Sirve para consultar tíquets, agregar comentarios, crear subtareas y cambiar estado o usuario asignado.

Notificación o página Flujos de trabajo por caso de uso
Notificación Comentario modificado (tíquet asignado) Cuando se modifica un comentario en un tíquet existente asignado a un usuario, este recibe, en Workspace, una notificación del comentario modificado.
Notificación Comentario modificado (enviado) Cuando se modifica un comentario en un tíquet existente que haya enviado un usuario, este recibe, en Workspace, una notificación de comentario modificado.
Notificación Nuevo comentario (tíquet asignado) Cuando se agrega un comentario nuevo a un tíquet existente asignado a un usuario, este recibe una notificación.
Notificación Nuevo comentario (tíquet enviado) Cuando se agrega un comentario nuevo a un tíquet existente que haya enviado un usuario, este recibe una notificación.
Notificación Se le ha asignado un tíquet (cambio) Cuando un tíquet existente se asigna a un usuario, este recibe una notificación.
Notificación Se le ha asignado un tíquet (nuevo) Cuando se asigna un tíquet nuevo a un usuario, este recibe una notificación.
Notificación Cambio de usuario asignado a tíquet (env.) Cuando se reasigna un tíquet, el usuario que haya enviado el tíquet recibe una notificación.
Notificación Cambio de estado de tíquet (tíquet asignado) Cuando se cambia el estado de un tíquet, el usuario asignado del tíquet recibe una notificación.
Notificación Cambio de estado de tíquet (tíquet enviado) Cuando se cambia el estado de un tíquet, el usuario que haya enviado el tíquet recibe una notificación.
Página Agregar comentario Proporciona un formulario para agregar un comentario a un tíquet de Jira.
Página Cambiar usuario asignado Proporciona un formulario para cambiar al usuario asignado de un tíquet de Jira.
Página Cambiar estado Proporciona un formulario para cambiar el estado de un tíquet de Jira.
Página Detalles del comentario Proporciona una vista de solo lectura de un comentario con detalles.
Página Crear subtarea Proporciona un formulario para crear una subtarea de un tíquet de Jira.
Página Detalles del tíquet Proporciona una vista de solo lectura de un tíquet de Jira con detalles.
Página Tíquets Permite a los usuarios buscar tíquets de Jira que hayan enviado, que hayan comentado o que se les hayan asignado.