Saltar al contenido

Conexión de Jira

Introducción

Una conexión de Jira, creada utilizando el conector de Jira, establece acceso a Jira. Una vez que se configura una conexión, se pueden crear instancias de actividades de Jira asociadas con esa conexión para ser utilizadas 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 de Jira

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

Una conexión de Jira existente se puede editar desde estas ubicaciones:

Configurar una conexión de Jira

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

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 utilizando un nombre de usuario y un token de API o contraseña.

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

Nota

Autenticación basada en credenciales debe ser utilizada para configurar un punto final global.

Autenticación basada en credenciales

Cuando se selecciona Autenticación basada en credenciales como el Mecanismo de Autenticación, se presenta la interfaz descrita a continuación.

Consejo

Los campos con un ícono de variable admiten el uso de variables globales, variables de proyecto y variables de Jitterbit. Comienza escribiendo un corchete cuadrado abierto [ en el campo o haciendo clic en el ícono de variable para mostrar un menú con las variables existentes de las que elegir.

  • Nombre de la conexión: Ingresa 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 punto final de Jira, que se refiere tanto a una conexión específica como a sus actividades.

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

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

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

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

  • Nombre de host: Ingresa el nombre de host de Jira. El nombre puede ir precedido por https:// o http://. Si no se proporciona, se asume https://.

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

  • Versión de Jira Server: Cuando se selecciona Jira On-premise como el Tipo de instancia, selecciona la versión de Jira Server o Jira Data Center que se utilizará, una de 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: Selecciona el tipo de autenticación para la instancia de Jira, ya sea Token de API o Contraseña. Esta opción es visible solo cuando se selecciona Jira On-premise como el Tipo de Instancia. Si se selecciona Jira Cloud como el Tipo de Instancia, debes ingresar un token de API para la autenticación.

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

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

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

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

    • Usar SSL: Al usar un agente privado, selecciona para autenticar la conexión utilizando el Capa de Conexión Segura (SSL) del cliente.

      Importante

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

    • Habilitar Verificador de Nombre de Host: Al usar un certificado autofirmado, selecciona para evitar que la solicitud HTTP sea bloqueada por el conector.

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

  • Probar: Haz clic para verificar la conexión utilizando la configuración proporcionada. Cuando se prueba la conexión, la última versión del conector es descargada por el(los) agente(s) en el grupo de agentes asociado con el entorno actual. Este conector admite suspender la descarga de la última versión del conector utilizando la política de organización Deshabilitar Actualización Automática del Conector.

  • Guardar Cambios: Haz clic para guardar y cerrar la configuración de la conexión.

  • Descartar Cambios: Después de realizar cambios en una configuración nueva o existente, haz clic para cerrar la configuración sin guardar. Un mensaje te pide que confirmes que deseas 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 le pide que confirme que desea eliminar la conexión.

OAuth

Cuando se selecciona OAuth como el Mecanismo de Autenticación, se presenta la interfaz descrita a continuación.

Consejo

Los campos con un ícono de variable admiten el uso de variables globales, variables de proyecto y variables de Jitterbit. Comience escribiendo un corchete cuadrado abierto [ en el campo o haciendo clic en el ícono de variable para mostrar un menú que enumera las variables existentes de las que elegir.

  • 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 / ni dos puntos :. Este nombre también se utiliza para identificar el punto final de Jira, que se refiere tanto a una conexión específica como a sus actividades.

  • Mecanismo de autenticación: Seleccione OAuth para autenticar utilizando una aplicación de OAuth 2.0 de 3 patas. Cuando se selecciona este mecanismo de autenticación, el campo Aplicación OAuth se vuelve 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 On-premise como el Tipo de instancia, ingrese el nombre de host de Jira. El nombre puede ir precedido por https:// o http://. Si no se proporciona, se asume https://.

  • Versión de Jira Server: Cuando se selecciona Jira On-premise como el Tipo de instancia, selecciona la versión de Jira Server o Jira Data Center a utilizar, una de 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: Usa el menú para seleccionar una aplicación OAuth 2.0 de una de estas categorías:

    • Aplicaciones en la Nube: La aplicación en esta categoría (Jitterbit App) 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 el Tipo de instancia.

    • Aplicaciones Privadas: Esta categoría muestra las aplicaciones de conector de Jira configuradas en la página de Registros de Aplicaciones de la Consola de Administración. Para configurar una aplicación de conector de Jira en la página de Registros de Aplicaciones, primero debes configurar una aplicación de OAuth 2.0 de 3 patas para la instancia de Jira.

  • Iniciar sesión con Jira: Haz clic para autenticarte con la aplicación OAuth seleccionada. Al usar una Aplicación Privada, serás dirigido a la URL especificada en la URL de Autenticación configurada de la aplicación de conector (ver Registros de Aplicaciones). Al usar la Jitterbit App, serás dirigido a permitir que la Jitterbit App acceda a la instancia de Jira. Después de autenticarte con éxito, estos campos estarán disponibles:

    • Recibir Notificación de Inactividad: Cuando Habilitar la expiración de inactividad del token de actualización está habilitado en la pestaña de Política de Tokens del registro de la aplicación (bajo Opciones Avanzadas), selecciona recibir una notificación por correo electrónico (y una notificación a través del portal Harmony) después de que haya pasado la cantidad establecida de días de inactividad del usuario.

      • Días para Notificación de Inactividad: Ingresa el número de días inactivos para activar la notificación. El valor predeterminado es 30 días.

    • Recibir Notificación de Expiración: Cuando Habilitar expiración del token de actualización está habilitado en la pestaña Política de token del registro de la aplicación (bajo Opciones avanzadas), selecciona recibir una notificación por correo electrónico (y una notificación a través del portal Harmony) una vez que se haya alcanzado la cantidad establecida de días antes de la expiración de la aplicación OAuth 2.0.

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

      Nota

      Cuando se establece la Recibir Notificación de Inactividad o Recibir Notificación de Expiración, la notificación se envía a los administradores de la organización Harmony (miembros de un rol con el permiso Admin y al usuario que desplegó el proyecto por última vez.

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

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

    • Usar SSL: Al usar un agente privado, selecciona autenticar la conexión utilizando Secure Sockets Layer (SSL) del cliente.

      Importante

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

    • Habilitar Verificador de Nombre de Host: Al usar un certificado autofirmado, selecciona prevenir que la solicitud HTTP sea bloqueada por el conector.

    • Protocolo de Seguridad: Desde el menú, selecciona el protocolo de seguridad a utilizar, ya sea TLSv1.2 o TLSv1.3. Para más información sobre estos protocolos, consulta los RFC's 6347 (TLS v1.2) o 8446 (TLS v1.3).

  • Prueba: Haz clic para verificar la conexión utilizando la configuración proporcionada. Cuando se prueba la conexión, la última versión del conector es descargada por el(los) agente(s) en el grupo de agentes asociado con el entorno actual. Este conector admite suspender la descarga de la última versión del conector utilizando la Desactivar actualización automática del conector política de organización.

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

  • Descartar cambios: Después de realizar cambios en una configuración nueva o existente, haz clic para cerrar la configuración sin guardar. Un mensaje te pide que confirmes que deseas descartar los cambios.

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

Próximos pasos

Después de que se ha creado una conexión de Jira, colocas un tipo de actividad en el lienzo 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).

Las acciones del menú para una conexión y sus tipos de actividad son accesibles desde el panel del proyecto y la paleta de componentes de diseño. Para más detalles, consulta Menús de acciones en Conceptos básicos del conector.

Estos tipos de actividad están disponibles:

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

  • Problema: Crea, actualiza o elimina un problema en un proyecto de Jira y está destinado a ser utilizado como destino en una operación.

  • Crear: Crea datos de objetos en un proyecto de Jira y está destinado a ser utilizado como destino en una operación.

  • Actualizar: Actualiza los datos de objetos en un proyecto de Jira y está destinado a ser utilizado como un objetivo en una operación.

  • Buscar Tablero: Recupera datos del tablero de Jira y está destinado a ser utilizado como una fuente en una operación.

  • Eliminar: Elimina los datos de objetos de Jira y está destinado a ser utilizado como un objetivo en una operación.

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

  • Buscar Filtro: Recupera datos de filtros de Jira y está destinado a ser utilizado como una fuente en una operación.