Administración y configuración del conector de Jira de Smartsheet

El conector de Jira de Smartsheet sincroniza la información entre Smartsheet y una o más instancias de Jira mediante la creación de flujos de trabajo.

El conector Jira de Smartsheet está disponible como servicio premium. Contacte a nuestro equipo de ventas para obtener información sobre los precios.

Si adquirió el conector Jira de Smartsheet en su plan, inicie sesión para crear flujos de trabajo entre Smartsheet y Jira.

Inicie sesión en el conector de Jira de Smartsheet

Terminología y tipos de permisos

• Conexión es el enlace entre Smartsheet y una instancia específica de Jira.
• Flujo de trabajo es el enlace dentro del conector de Jira que asocia elementos de Jira a una hoja de Smartsheet.

Los usuarios pueden tener tres permisos diferentes para interactuar con el conector de Jira de Smartsheet:

• Administrador del sistema de Smartsheet: Gestiona a los administradores y usuarios del conector de Jira desde la aplicación de Smartsheet. Los Administradores del sistema también pueden habilitar una configuración para restringir el acceso al conector.
• Administrador del conector de Jira: Establece la conexión entre una instancia de Jira y el conector de Jira de Smartsheet.
• Usuario del conector de Jira: Puede crear flujos de trabajo para sincronizar la información entre Smartsheet y Jira.

Funciones según el tipo de permiso

En la siguiente tabla, se muestran los permisos necesarios para completar tareas específicas con el conector de Jira.

 * Los Administradores del sistema de Smartsheet y los Administradores del conector pueden crear y editar sus propios flujos de trabajo si la función de la lista de acceso restringido está habilitada. Si el administrador del sistema activa la configuración para restringir usuarios en el conector de Jira, también debe mantener la función de usuario de Jira en Smartsheet. Obtenga más información sobre la restricción del acceso.

Configuración de la conexión

Primero, debe configurar la conexión entre Smartsheet y la instancia de Jira, de modo que los usuarios puedan crear flujos de trabajo para conectar elementos en Smartsheet y Jira. El conector Jira de Smartsheet es compatible con Jira Cloud y Jira Data Center v6.x a v10.x.

Establezca la conexión con una cuenta de correo electrónico con licencia genérica (p. ej., smartsheet-jira@sudominio.com) tanto en Smartsheet como en Jira. Esto evita la necesidad de rehacer conexiones o flujos de trabajo si la persona que administra el enlace de Jira abandona la organización, ya que no se puede cambiar la propiedad de la conexión.

Requisitos previos

Para configurar la conexión entre Smartsheet y Jira, debe tener los siguientes permisos:

En Jira:

• Administrador del sistema de Jira (administrador del producto o de la organización)

En Smartsheet:

• Usuario con licencia de Smartsheet (modelo heredado) o miembro (modelo de usuario)
• Función de administrador del sistema de Smartsheet o de administrador del conector de Jira de Smartsheet

Si bien solo se requiere la función de administrador del sistema o del conector Jira de Smartsheet, Smartsheet recomienda tener ambas para configurar el conector.

Dado que el conector Jira de Smartsheet habilita flujos de trabajo automáticos, la aplicación debe tener credenciales de administrador del sistema de Jira para crear o configurar un webhook a través de la API REST de Jira. Las credenciales del administrador del sistema de Jira se utilizan solo para crear y configurar webhooks.

La cuenta utilizada para realizar la configuración debe permanecer activa con derechos de administrador tanto en Jira como en Smartsheet. Si elimina el estado de administrador de este usuario, se genera un error: Faltan credenciales de usuario para este punto de conexión. Si se restauran los permisos de administrador, se soluciona la conexión y se reanuda la sincronización normal de los flujos de trabajo. Si se eliminan las credenciales del administrador de Jira, debe volver a generar el enlace de la aplicación debido a cambios en los tokens.

Pasos de configuración

Los pasos para establecer una conexión varían según el tipo de implementación de Jira y la versión de OAuth que esté utilizando. Siga la ruta que coincida con sus condiciones:

Debe tener permisos de administrador de Jira para configurar una conexión.

Puede crear hasta tres conexiones por instancia de Jira Cloud con OAuth2.0.

Jira Cloud OAuth 1.0, OAuth 2.0 o Jira Data Center OAuth 1.0

Paso 1: Registrar un nuevo servidor Jira en el conector Jira de Smartsheet

Defina los ajustes del firewall y la configuración general antes de establecer esta conexión.

1. Inicie sesión en el conector de Jira de Smartsheet. Si se le solicita que permita el acceso a su cuenta de Smartsheet, seleccione Permitir.
2. Seleccione el menú de la esquina superior izquierda de la página y, luego, Administración de la cuenta.
3. Seleccione Registrar nuevo servidor de Jira.
4. En la página Configuración, realice lo siguiente:
   1. Ingrese la URL del host de JIRA del entorno de Jira que desea conectar a su entorno de Smartsheet (https://mbfcorp.atlassian.net/). 
   2. Es probable que la URL de la API de JIRA sea la misma que la del host de Jira. 
   3. En Nombre, acepte el nombre predeterminado o cámbielo por uno más útil. 
   4. Seleccione su versión de JIRA: Jira Server 7 o Cloud para instancias en la nube de Jira.

Brandfolder Image

5. Luego de completar estos elementos en la página Configuración, seleccione Continuar.
6. En la página Configuración, visualice la Clave de consumidor, el Nombre de consumidor y la Clave pública. Cópielos, ya que los utilizará en los siguientes pasos.
7. Seleccione Continuar para pasar a la página siguiente.

Paso 2: Crear un enlace de la aplicación (AppLink) a Smartsheet en Jira

Omita este paso si utiliza OAuth 2.0.

1. Inicie sesión en Jira (debe tener permisos de administrador de Jira).

2. Vaya a Configuración de Jira> Productos.
    

   Brandfolder Image

   

3. En la barra lateral de Productos, en la sección Integraciones, seleccione Enlaces de aplicación.

   En versiones anteriores con alojamiento propio de Jira, seleccione Configuración > Aplicaciones y elija Enlaces de aplicación.

   Brandfolder Image

   
4. Seleccione Crear enlace; aparecerá una ventana emergente para Crear enlace. Complete los campos de la siguiente forma:

   • En Jira Cloud, seleccione Enlace directo de la aplicación y escriba https://app.smartsheet.com en la URL de la aplicación. Luego, seleccione Siguiente.

     Brandfolder Image

     

   • En las versiones 9 y superiores de Jira con alojamiento propio, seleccione Producto Atlassian y escriba https://app.smartsheet.com en la URL de la aplicación. Luego, seleccione Continuar.

     Brandfolder Image

     
5. Cuando aparezca uno de los siguientes mensajes, seleccione Continuar y no modifique la nueva URL.
   • Si no recibió una respuesta de la URL que ingresó, es posible que no sea válida. Si es necesario, corrija la URL a continuación y seleccione Continuar.
   • La URL de la aplicación proporcionada se redirigió una vez. Verifique el campo de la URL redireccionada para asegurarse de que sea una URL de confianza.
6. Aparece un cuadro emergente Revisar enlace o Vincular aplicaciones. Complete los campos de la siguiente forma:
   • En el campo Nombre de aplicación, escriba Smartsheet.
   • En Tipo de aplicación, acepte el valor predeterminado de Aplicación genérica.
   • En las versiones 9 y superiores de Jira con alojamiento propio, marque la casilla Crear enlace entrante.

   • Seleccione Continuar.

     Brandfolder Image

     

Paso 3: Editar el enlace de la aplicación

Omita este paso si utiliza OAuth 2.0.

1. En cuanto al enlace de la aplicación que se creó en el paso 2, seleccione el menú de tres puntos que aparece cuando pasa el cursor sobre el enlace de la aplicación o seleccione el ícono Editar (depende de la versión). 

2. Aparecerá la ventana emergente Configurar. Seleccione Autenticación entrante.
    

   Brandfolder Image

   
3. Complete los campos de la siguiente forma: 
   • Nombre del proveedor de servicios, si es necesario: Smartsheet.
   • Nombre del consumidor: Pegue el Nombre del consumidor que copió del conector de Jira en el paso 1.
   • Clave de consumidor: Pegue la Clave de consumidor que copió del conector de Jira en el paso 1.
   • Clave pública o compartida: Pegue la Clave pública que copió del conector de Jira en el paso 1.
   • Descripción: Agregue la descripción que desee.
   • Si se precisan la URL del token de solicitud, la URL del token de acceso o la URL de autorización en el entorno de Jira, use esta URL para completar esos campos: https://api.smartsheet.com/2.0/token
4. En la parte inferior de la sección Autenticación entrante, seleccione Guardar y, luego, Cerrar en el extremo inferior derecho.

Paso 4: Completar la conexión entre Jira y Smartsheet

1. Vaya a la configuración del conector Jira de Smartsheet.
2. En la pantalla Conectar, seleccione Conectar para completar la conexión desde Smartsheet.

Aparece un cuadro de diálogo en el que se le pregunta si permite que Smartsheet lea y escriba en su entorno de Jira. 

3. Si utiliza OAuth 2.0, seleccione el host en el menú desplegable Usar aplicación en. En caso contrario, vaya al siguiente paso. 

Brandfolder Image

4. Seleccione Permitir. 

Ya está configurada la conexión entre Smartsheet y Jira. Los usuarios con licencia o miembros de su cuenta ahora pueden crear flujos de trabajo entre elementos en Jira y hojas en Smartsheet. 

Puede conectar múltiples entornos de Jira a su cuenta de Smartsheet con el conector de Jira de Smartsheet. Repita las instrucciones de arriba para cada instancia adicional de Jira que quiera registrar. 

Jira Data Center OAuth 2.0

Paso 1: Crear un enlace de la aplicación (AppLink) a Smartsheet en Jira

1. Inicie sesión en Jira.
2. Vaya a Configuración de Jira > Aplicaciones.
3. En la barra lateral Aplicaciones, en Integraciones, seleccione Enlaces de aplicación.

Si no ve Aplicaciones en Configuración, vaya a Productos y, en la barra lateral Productos, encontrará Enlaces de aplicación en Integraciones.

4. Seleccione Crear enlace. Aparecerá un cuadro emergente Crear enlace. Complete los campos de la siguiente forma:
   • Seleccione Aplicación externa como Tipo de aplicación.
   • Seleccione Entrante como Dirección.
   • Seleccione Continuar.

Brandfolder Image

4. Configure un enlace entrante. Complete los campos de la siguiente manera:
   1. En Nombre, agregue un descriptor útil.
   2. URL de redireccionamiento: {smartsheet-connector-host}/c/jira/signInCallback}. Tenga en cuenta que smartsheet-connector-host es diferente en cada región:

      • EE. UU.: https://connectors.smartsheet.com

      • AU: https://connectors.smartsheet.au

      • UE: https://connectors.smartsheet.eu
   3. En Permiso de la aplicación, seleccione Administrador del sistema.
5. Seleccione Guardar.

Cuando complete estos pasos, obtendrá el ID de cliente y el Secreto de cliente. Copie ambos antes de realizar los siguientes pasos.

Paso 2: Registrar un nuevo servidor Jira en el conector Jira de Smartsheet Configurar los ajustes del firewall

1. Inicie sesión en el conector Jira de Smartsheet. Si se le indica que permita el acceso a su cuenta de Smartsheet, seleccione Permitir.
2. Seleccione el menú de la esquina superior izquierda de la página y, luego, Administración de la cuenta.
3. Seleccione Registrar nuevo servidor Jira.
4. En la página Configuración, realice lo siguiente:
   1. Ingrese la URL del host de JIRA del entorno de Jira que desea conectar a su entorno de Smartsheet (https://mbfcorp.atlassian.net/).
   2. Es probable que la URL de la API de JIRA sea la misma que la del host de Jira.
   3. En la sección Nombre, acepte el nombre predeterminado o cámbielo por uno más útil.
   4. Seleccione su versión de JIRA.
5. Cuando haya completado estos elementos en la página Configuración, seleccione Continuar.
6. En la página Configuración, consulte el ID de cliente y el Secreto de cliente. Complete los valores que obtuvo en el paso 1.

Paso 3: Completar la conexión entre Jira y Smartsheet

1. Una vez que complete el ID cliente y el Secreto de cliente, seleccione Continuar.
2. En la pantalla Conectar, seleccione Conectar para completar la conexión desde Smartsheet.

Aparece un cuadro de diálogo en el que se le pregunta si permite que Smartsheet lea y escriba en su entorno de Jira. Seleccione Permitir.

Ya está configurada la conexión entre Smartsheet y Jira. Los usuarios con licencia o miembros de su cuenta ya pueden crear flujos de trabajo entre elementos en Jira y hojas en Smartsheet.

Restringir el acceso al conector de Jira de Smartsheet

Si desea restringir aún más quiénes pueden crear flujos de trabajo en el conector de Jira de Smartsheet, puede restringir el acceso a ciertos usuarios con licencia o miembros de su cuenta. Lo que pueda hacer en el conector de Jira siempre dependerá de los permisos que tenga sobre los elementos, tanto en Smartsheet (permisos de uso compartido de hojas) como en Jira (permisos de lectura y escrituras en campos de registro), incluso si se habilitan restricciones adicionales.

El conector respeta los permisos otorgados tanto en Jira como en Smartsheet. Por ejemplo, supongamos que la persona que creó un flujo de trabajo en el conector no tiene permiso para editar datos específicos del proyecto en Jira. En ese caso, el flujo de trabajo no puede editar los datos de ese proyecto a través del conector.

Para restringir el acceso

Para limitar quiénes pueden crear flujos de trabajo con el conector de Jira, el administrador del sistema de Smartsheet o de Jira puede activar la configuración Restringir acceso para limitar quién puede crear flujos de trabajo con el conector de Jira.

1. Inicie sesión en el conector de Jira de Smartsheet con sus credenciales de Smartsheet.
2. Haga clic en el ícono del menú en el extremo superior izquierdo de la página y seleccione Administración de usuarios.

3. Marque la casilla de verificación Restringir qué usuarios pueden acceder a la integración de Smartsheet con Jira. 

   Brandfolder Image

   
4. Agregue la dirección de correo electrónico de cualquier persona a la que quiera otorgarle acceso al conector.

Para quitar el acceso

Ningún usuario que se haya eliminado de la lista podrá crear o editar sus propios flujos de trabajo.

1. Inicie sesión en el conector de Jira de Smartsheet con sus credenciales de Smartsheet.
2. Vaya a Administración de usuarios.
3. Seleccione el ícono Eliminar a la derecha de la información de la cuenta de esa persona.