Configuración

Introducción

Para conectarte a Jira usando este paquete de actividades, primero debes crear las credenciales requeridas por el ámbito de Jira para autenticar todas las llamadas posteriores. El ámbito admite actualmente dos tipos de autenticación:

• Token de API: Jira genera un token de autenticación para tu usuario. Este método admite automatizaciones completamente Unattended .
• OAuth 2.0: Jira genera un ID de cliente y un secreto, que pueden usarse para todos los usuarios de una organización. Este método muestra, en Runtime, una pantalla de inicio de sesión en la que el usuario puede introducir sus credenciales de inicio de sesión para Jira o cualquiera de sus proveedores de SSO. Se produce y guarda un token de forma local. Este token es de corta duración y es posible que deba actualizarse más adelante. Por esta razón, este método admite automatizaciones Attended y algunas Unattended .

Please follow the steps below to prepare a set of credentials for your activities.

Credenciales

Option 1: API Token

1. Sigue las instrucciones de Atlassian aquí para generar un token de API.
2. Agrega un Ámbito de Jira a tu flujo de trabajo y cambia el parámetro Tipo de autenticación a Api Token.
3. Rellena la propiedad URL del servidor con la URL de la instancia de Jira de tu organización. Para las instancias de Cloud, suele tener el formato https://<your org>.atlassian.net.
4. Por último, rellena la propiedad Token de API con el token generado en el paso 1 y la propiedad Nombre de usuario con el correo electrónico que utilizas para iniciar sesión en la instancia de Jira designada. El ámbito de Jira ya está listo para usarse.

Option 2: OAuth 2.0

1. Sigue las instrucciones de Atlassian aquí en Habilitar OAuth 2.0 (3LO) para crear una nueva "aplicación".

   
   

   

   
   
2. En APIS Y CARACTERÍSTICAS, selecciona OAuth 2.0 (3LO). Introduce http://127.0.0.1:10001/authorize/ en el campo URL de devolución de llamada . Esto indica a la aplicación de Jira que vuelva a la máquina que ejecuta las actividades una vez que haya terminado de autenticar a un usuario.
   
   

   

   
   

3. En APIS Y CARACTERÍSTICAS , seleccione Añadir para que la aplicación acceda a las API de Atlassian. Selecciona el botón Agregar en la API de REST de la plataforma Jira.

   
   

   

   
   
4. El botón Agregar se reemplazará por uno que dice Configurar. Haga clic aquí para elegir los permisos otorgados a la aplicación. Añade read:jira-work, manage:jira-project, manage:jira-configuration, read:jira-usery write:jira-work.
   
   

   

   
   
   
   

   

   
   

5. Vuelve a Detalles de la aplicación y copia tu ID de cliente y tu secreto. Ahora se pueden usar en un flujo de trabajo.

   
   

   

   
   
6. Agrega un Ámbito de Jira a tu flujo de trabajo y cambia el parámetro Tipo de autenticación a OAuth 2.0.
7. Rellena la propiedad URL del servidor con la URL de la instancia de Jira de tu organización. Para las instancias de Cloud, suele tener el formato https://<your org>.atlassian.net.

8. Por último, rellena las propiedades ID de cliente y Secreto de cliente con los valores copiados en el paso 5. El ámbito de Jira ya está listo para usarse.

   Para transformar el tipo de variable de String a SecureString, en el parámetro predeterminado para clientSecret, puede usar este comando:

   (new System.Net.NetworkCredential("","*YOUR_SECRET*")).SecurePassword

   
   

   

   
   
9. Si sigue los pasos anteriores en Studio y recibe el mensaje de error RemoteException wrapping System.Net.HttpListenerException: The network location cannot be reached. For information about network troubleshooting, see Windows Help al intentar ejecutar el ámbito de Jira, la solución es abrir un cmd.exe como Administrators y ejecutar este comando:

   netsh http add iplisten ipaddress=127.0.0.1

   
   

   

   
   

10. Después de la primera ejecución del ámbito de Jira, recibes una ventana de solicitud de autorización en tu navegador predeterminado donde debes especificar el sitio de Jira y luego hacer clic en Aceptar.