Conexión Jira¶

Introducción¶

Una conexión Jira, creada usando el conector Jira, establece acceso a Jira. Una vez configurada una conexión, puedes 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 Jira utilizando el conector Jira desde una de estas ubicaciones:

• La pestaña Conexiones de la paleta de componentes de diseño (consulte Paleta de Componentes de Diseño).
• La página Conexiones globales (vea Crear una conexión global en Conexiones globales).

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

• La pestaña Conexiones de la paleta de componentes de diseño (consulte Paleta de Componentes de Diseño).
• La pestaña Componentes del panel del proyecto (consulte Menú de acciones de componentes en Pestaña Componentes del panel de proyecto).
• La página Conexiones globales (vea Editar una conexión global en Conexiones globales).

Configurar una Conexión Jira¶

Cada elemento de la interfaz de usuario de la pantalla de configuración de conexión de Jira se describe a continuación.

La interfaz utilizada en la configuración de 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 Autentificación basada en credenciales como Mecanismo de autenticación, se presenta esta interfaz:

• Nombre de la conexión: Introduzca un nombre que se utilizará 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 se refiere tanto a una conexión específica como a sus actividades.

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

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

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

• 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.

• 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, ya sea 8.22.3 o 9.4.3.

• 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 es 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): Cuando se utiliza un Agente Privado, esta configuración se puede seleccionar para usar configuración de proxy del Agente Privado.

• Configuraciones opcionales: Haga clic para expandir configuraciones opcionales adicionales:

  • Usar SSL: Cuando utilice un Agente Privado, seleccione autenticar la conexión utilizando la Capa de sockets seguros (SSL) del cliente.

    Importante

    Al utilizar esta opción, se debe agregar un certificado al almacén de claves Jitterbit Java.

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

  • Protocolo de seguridad: Cuando se selecciona Usar SSL, use el menú para seleccionar el protocolo de seguridad a usar, 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 v1.3).

• Prueba: Haga 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 Desactivar actualización automática del conector política de la organización.

• 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 pide 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 eliminación). Un mensaje le pide que confirme que desea eliminar la conexión.

OAuth¶

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

• Nombre de la conexión: Introduzca un nombre que se utilizará 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 se refiere 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 solicitud. Cuando se selecciona este mecanismo de autenticación, el campo Aplicación OAuth pasa a estar disponible (descrito 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 local como Tipo de instancia, ingrese el nombre de host de Jira. El nombre puede ir precedido de cualquiera de los dos 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, ya sea 8.22.3 o 9.4.3.

• 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 es visible solo cuando se utiliza un Grupo de Agentes en Nube y cuando se selecciona Jira Cloud como Tipo de instancia.

  • Aplicaciones privadas: Esta categoría muestra las aplicaciones del conector Jira configuradas en 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 patas aplicación para la instancia de Jira.

• Inicie sesión con Jira: Haga clic para autenticarse con la Aplicación OAuth seleccionada. Cuando utilice una Aplicación privada, se le 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 exitosamente, 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 (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 el número 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 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 (en todo el Portal Harmony ) una vez que se haya cumplido la cantidad establecida de días antes del vencimiento de la aplicación OAuth 2.0.

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

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

• Configuraciones opcionales: Haga clic para expandir configuraciones opcionales adicionales:

  • Usar SSL: Cuando utilice un Agente Privado, seleccione autenticar la conexión utilizando 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 almacén de claves Jitterbit Java.

  • Habilitar verificador de nombre de host: Cuando utilice 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 desea 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 v1.3).

• Prueba: Haga 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 Desactivar actualización automática del conector política de la organización.

• 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 pide 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 eliminación). Un mensaje le pide que confirme que desea eliminar la conexión.

Próximos Pasos¶

Después de crear una conexión Jira, coloca un tipo de actividad en el tela de diseño para crear instancias de actividad que se utilizará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 de menú para una conexión y sus tipos de actividad desde el panel del 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 de Jira y está diseñado para usarse como fuente en una operación.

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

• Crear: Crea datos de objetos en un proyecto de Jira y está diseñado para usarse como destino en una operación.

• Actualizar: Actualiza los datos del objeto en un proyecto de Jira y está diseñado para usarse como destino en una operación.

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

• Borrar: Elimina datos de objetos de Jira y está diseñado para usarse como objetivo en una operación.

• Transición: Recupera o actualiza problemas de Jira y está diseñado para usarse como objetivo en una operación.

• Filtro de búsqueda: Recupera datos de filtro de Jira y está diseñado para usarse como fuente en una operación.