Conexión Jira¶

Introducción¶

Una conexión Jira, creada usando el conector Jira, establece acceso a Jira. Una vez configurada una conexión, puede crear instancias de actividades de Jira asociadas con esa conexión para usarlas como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Crear o Editar una Conexión Jira¶

Se crea una nueva conexión de Jira utilizando el conector de Jira desde una de estas ubicaciones:

• La pestaña extremos y conectores del proyecto de la paleta de componentes de diseño (consulte paleta de componentes de diseño).
• La página Conexiones globales (vea Crear un extremo global en Conexiones globales).

Se puede editar una conexión Jira existente desde estas ubicaciones:

• La pestaña extremos y conectores del proyecto de la paleta de componentes de diseño (consulte paleta de componentes de diseño).
• La pestaña Componentes del panel del proyecto (vea menú de acciones de componentes en la pestaña Componentes del panel Proyecto).
• La página Conexiones globales (vea Editar un extremo global en Conexiones globales).

Configurar una Conexión Jira¶

A continuación se describe cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión de Jira.

La interfaz utilizada en la configuración de la conexión de Jira depende de la opción Mecanismo de autenticación seleccionada:

• Autenticación basada en credenciales: Para esta opción, la conexión se autentica mediante un nombre de usuario y un token API o contraseña.

• OAuth: Para esta opción, la conexión se autentica mediante un OAuth 2.0 de 3 patas aplicación. Esta opción requiere el uso de la versión del agente 10.83/11.21 o posterior.

Autenticación Basada en Credenciales¶

Cuando se selecciona Autenticación basada en credenciales como Mecanismo de autenticación, se presenta esta interfaz:

• Nombre de la conexión: Ingrese un nombre para identificar la conexión. El nombre debe ser único para cada conexión de Jira y no debe contener barras diagonales. /o dos puntos : Este nombre también se utiliza para identificar el extremo de Jira, que hace referencia tanto a una conexión específica como a sus actividades.

• Mecanismo de autenticación: Seleccione Autenticación basada en credenciales para autenticarse usando un nombre de usuario y un token de API o contraseña (descrito a continuación).

• Tipo de instancia: Seleccione un tipo de instancia de la lista, ya sea Jira Cloud o Jira On-premise:

  • Jira Cloud: Conéctese a Jira Software Cloud.

  • Jira On-premise: Conéctese a Jira Server o Jira Data Center.

• Nombre de host: Ingrese el nombre de host de Jira. El nombre puede ir precedido por cualquiera de los siguientes https:// o http://. Si no se proporciona, https:// Se supone.

• Nombre de usuario: Ingrese el nombre de usuario de Jira.

• Versión de Jira Server: Cuando se selecciona Jira On-premise como Tipo de instancia, seleccione versión de Jira Server o Jira Data Center a utilizar, uno de los siguientes: 9.17.2, 9.17.1, 9.17.0, 9.12.12, 9.12.9, 9.12.8, 9.12.7, 9.4.3 o 8.22.3 (no recomendado).

• Tipo de autenticación: Seleccione el tipo de autenticación para la instancia de Jira, ya sea Token de API o Contraseña. Esta opción solo está visible cuando se selecciona Jira On-premise como Tipo de instancia. Si se selecciona Jira Cloud como Tipo de instancia, debe ingresar un token de API para la autenticación.

• Token API: Ingrese el token API para la instancia de Jira.

• Contraseña: Ingrese la contraseña para la instancia de Jira.

• Usar configuración de proxy (solo Agente Privado): Al usar un agente privado, se puede seleccionar esta configuración para usar configuración de proxy del agente privado.

• Configuración opcional: Haga clic para expandir la configuración opcional adicional:

  • Usar SSL: Cuando utilice un agente privado, seleccione autenticar la conexión mediante la capa de sockets seguros (SSL) del cliente.

    Importante

    Al utilizar esta opción, se debe agregar un certificado al Jitterbit Java KeyStore.

  • Habilitar verificador de nombre de host: Cuando se utiliza un certificado autofirmado, seleccione esta opción para evitar que el conector bloquee la solicitud HTTP.

  • Protocolo de seguridad: Cuando se selecciona Usar SSL, utilice el menú para seleccionar el protocolo de seguridad que se utilizará, ya sea TLSv1.2 o TLSv1.3. Para obtener más información sobre estos protocolos, consulte RFC 6347 (TLS v1.2) o 8446 (TLS versión 1.3).

• Prueba: Haz clic para verificar la conexión usando la configuración proporcionada. Cuando se prueba la conexión, los agentes del grupo de agentes asociado con el ambiente actual descargan la última versión del conector. Este conector admite la suspensión de la descarga de la última versión del conector mediante la política de la organización Deshabilitar actualización automática del conector.

• Guardar cambios: Haga clic para guardar y cerrar la configuración de conexión.

• Descartar cambios: Después de realizar cambios en una configuración nueva o existente, haga clic para cerrar la configuración sin guardar. Un mensaje le solicitará que confirme que desea descartar los cambios.

• Eliminar: Después de abrir una configuración de conexión existente, haga clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (consulte Dependencias de componentes, eliminación y remoción). Un mensaje te pedirá que confirmes que deseas eliminar la conexión.

OAuth¶

Cuando se selecciona OAuth como Mecanismo de autenticación, se presenta esta interfaz:

• Nombre de la conexión: Ingrese un nombre para identificar la conexión. El nombre debe ser único para cada conexión de Jira y no debe contener barras diagonales. /o dos puntos : Este nombre también se utiliza para identificar el extremo de Jira, que hace referencia tanto a una conexión específica como a sus actividades.

• Mecanismo de autenticación: Seleccione OAuth para autenticarse usando un OAuth 2.0 de 3 patas aplicación. Cuando se selecciona este mecanismo de autenticación, el campo OAuth Application se vuelve disponible (se describe a continuación). Esta opción requiere el uso de la versión del agente 10.83/11.21 o posterior.

• Tipo de instancia: Seleccione un tipo de instancia de la lista, ya sea Jira Cloud o Jira On-premise:

  • Jira Cloud: Conéctese a Jira Software Cloud.

  • Jira On-premise: Conéctese a Jira Server o Jira Data Center.

• Nombre de host: Cuando se selecciona Jira On-premise como Tipo de instancia, ingrese el nombre de host de Jira. El nombre puede ir precedido por cualquiera de los siguientes https:// o http://. Si no se proporciona, https:// Se supone.

• Versión de Jira Server: Cuando se selecciona Jira On-premise como Tipo de instancia, seleccione la versión de Jira Server o Jira Data Center que desea usar, una de las siguientes: 9.17.2, 9.17.1, 9.17.0, 9.12.12, 9.12.9, 9.12.8, 9.12.7, 9.4.3 o 8.22.3 (no recomendado).

• Aplicación OAuth: Utilice el menú para seleccionar una aplicación OAuth 2.0 de una de estas categorías:

  • Aplicaciones en la nube: La aplicación de esta categoría (Aplicación Jitterbit) es una aplicación OAuth 2.0 proporcionada por Jitterbit. Esta aplicación solo es visible cuando se utiliza un grupo de agentes en la nube y cuando se selecciona Jira Cloud como Tipo de instancia.

  • Aplicaciones privadas: Esta categoría muestra las aplicaciones del conector Jira configuradas en la Management Console Registros de aplicaciones página. Para configurar una aplicación de conector Jira en la página Registros de aplicaciones, primero debe configurar un OAuth 2.0 de 3 vías aplicación para la instancia de Jira.

• Iniciar sesión con Jira: Haga clic para autenticarse con la aplicación OAuth seleccionada. Cuando utilice una aplicación privada, se lo dirigirá a la URL especificada en la URL de autenticación configurada de la aplicación del conector (consulte Registros de aplicaciones). Cuando utilice la Aplicación Jitterbit, se le indicará que permita que la Aplicación Jitterbit acceda a la instancia de Jira. Después de autenticarse correctamente, estos campos estarán disponibles:

  • Recibir notificación de inactividad: Cuando Habilitar vencimiento de inactividad del token de actualización está habilitado en la Política de token del registro de la aplicación pestaña (en Opciones avanzadas), seleccione recibir una notificación correo (y una notificación en todo el portal Harmony ) después de que haya transcurrido la cantidad establecida de días de inactividad del usuario.

    • Días para notificación de inactividad: Ingrese la cantidad de días de inactividad para activar la notificación. El valor predeterminado es 30 días.

  • Recibir notificación de vencimiento: Cuando Habilitar vencimiento de token de actualización está habilitado en la Política de token del registro de la aplicación pestaña (en Opciones avanzadas), seleccione recibir una notificación correo (y una notificación en todo el portal Harmony ) una vez que se haya cumplido la cantidad de días establecida antes del vencimiento de la aplicación OAuth 2.0.

    • Días para notificación de vencimiento: Ingrese la cantidad de días para activar la notificación. El valor predeterminado es 30 días.

    Nota

    Cuando se configura Recibir notificación de inactividad o Recibir notificación de vencimiento, la notificación se envía a los administradores de la organización Harmony (miembros de un rol con el permiso Admin y el usuario que implementó el proyecto por última vez.

• Usar configuración de proxy (solo Agente Privado): Al usar un agente privado, se puede seleccionar esta configuración para usar configuración de proxy del agente privado.

• Configuración opcional: Haga clic para expandir la configuración opcional adicional:

  • Usar SSL: Cuando utilice un agente privado, seleccione autenticar la conexión mediante la capa de sockets seguros (SSL) del cliente.

    Importante

    Al utilizar esta opción, se debe configurar SSL para el cliente JMS y se debe agregar un certificado al Jitterbit Java KeyStore.

  • Habilitar verificador de nombre de host: Cuando se utiliza un certificado autofirmado, seleccione esta opción para evitar que el conector bloquee la solicitud HTTP.

  • Protocolo de seguridad: En el menú, seleccione el protocolo de seguridad que se utilizará, ya sea TLSv1.2 o TLSv1.3. Para obtener más información sobre estos protocolos, consulte RFC 6347 (TLS v1.2) o 8446 (TLS versión 1.3).

• Prueba: Haz clic para verificar la conexión usando la configuración proporcionada. Cuando se prueba la conexión, los agentes del grupo de agentes asociado con el ambiente actual descargan la última versión del conector. Este conector admite la suspensión de la descarga de la última versión del conector mediante la política de la organización Deshabilitar actualización automática del conector.

• Guardar cambios: Haga clic para guardar y cerrar la configuración de conexión.

• Descartar cambios: Después de realizar cambios en una configuración nueva o existente, haga clic para cerrar la configuración sin guardar. Un mensaje le solicitará que confirme que desea descartar los cambios.

• Eliminar: Después de abrir una configuración de conexión existente, haga clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (consulte Dependencias de componentes, eliminación y remoción). Un mensaje te pedirá que confirmes que deseas eliminar la conexión.

Próximos Pasos¶

Después de crear una conexión Jira, coloque un tipo de actividad en el tela de diseño para crear instancias de actividad que se usarán como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Se puede acceder a las acciones del menú de una conexión y sus tipos de actividad desde el panel de proyecto y la paleta de componentes de diseño. Para obtener más información, consulte Menús de acciones en Conceptos básicos del conector.

Estos tipos de actividades están disponibles:

• Buscar: Recupera datos de objetos de un proyecto Jira y está destinado a usarse como fuente en una operación.

• Asunto: Crea, actualiza o elimina un problema en un proyecto de Jira y está destinado a usarse como objetivo en una operación.

• Crear: Crea datos de objetos en un proyecto Jira y está pensado para usarse como objetivo en una operación.

• Actualizar: Actualiza datos de objetos en un proyecto Jira y está pensado para usarse como objetivo en una operación.

• Panel de búsqueda: Recupera datos del panel de Jira y está destinado a usarse como fuente en una operación.

• Borrar: Elimina datos de objetos de Jira y está destinado a usarse como objetivo en una operación.

• Transición: Recupera o actualiza problemas de Jira y está destinado a usarse como objetivo en una operación.

• Filtro de búsqueda: Recupera datos de filtro de Jira y está destinado a usarse como fuente en una operación.