传统集成活动

上次更新日期 2024年12月13日

设置

简介

要使用此活动包连接到 Jira，您必须首先创建 Jira 作用域所需的凭据，以对所有后续调用进行身份验证。作用域当前支持两种类型的身份验证：

API 令牌：Jira 为您的用户生成身份验证令牌。此方法支持完全 Unattended 的自动化。
OAuth 2.0：客户端 ID 和密码由 Jira 生成，可用于组织内的所有用户。此方法在 Runtime显示登录屏幕，用户可以在其中输入 Jira 或其任何 SSO 提供程序的登录凭据。系统将生成令牌并将其保存在本地。此令牌的生存期很短，可能需要稍后刷新。因此，此方法支持有人 Attended 自动化和某些 Unattended 自动化。

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

凭据

Option 1: API Token

请按照 Atlassian 在此处的说明生成 API 令牌。
将 Jira 作用域添加到您的工作流中，并将 身份验证类型 参数更改为 Api Token。
在“ 服务器 URL ” 属性中填写组织的 Jira 实例的 URL。对于 Cloud 实例，这通常采用 https://<your org>.atlassian.net的形式。
最后，在“ API 令牌 ” 属性中填写第 1 步中生成的令牌，并在“ 用户名 ” 属性中填写您用于登录指定 Jira 实例的电子邮件。 Jira 作用域现在可以使用了。

Option 2: OAuth 2.0

请按照此处 Atlassian 关于启用 OAuth 2.0 (3LO) 的说明创建新的“应用程序”。
在“ API 和功能” 下，选择“ OAuth 2.0 (3LO)”。在 回调 URL 字段中输入 http://127.0.0.1:10001/authorize/ 。这将指示 Jira 应用程序在完成用户身份验证后返回到运行活动的计算机。
在“API 和功能 ”下，选择“ 添加 ”，以向应用程序授予 Atlassian API 的访问权限。选择 Jira Platform REST API下的添加按钮。
“ 添加 ” 按钮将替换为“ 配置” 按钮。单击此项以选择向应用程序授予的权限。添加 read:jira-work、 manage:jira-project、 manage:jira-configuration、 read:jira-user和 write:jira-work。
返回到“ 应用程序详细信息 ”，然后复制您的客户端 ID 和密码。这些现在可以在工作流中使用。
将 Jira 作用域添加到您的工作流中，并将 身份验证类型 参数更改为 OAuth 2.0。
在“ 服务器 URL ” 属性中填写组织的 Jira 实例的 URL。对于 Cloud 实例，这通常采用 https://<your org>.atlassian.net的形式。
最后，使用在步骤 5 中复制的值填写“ 客户端 ID ” 和“ 客户端密码” 属性。 Jira 作用域现在可以使用了。

要将变量类型从字符串转换为安全字符串，您可以在 clientSecret的默认参数中使用以下命令：

(new System.Net.NetworkCredential("","*YOUR_SECRET*")).SecurePassword
如果您在 Studio 中按照上述步骤操作，并且在尝试执行 Jira 作用域时收到 RemoteException wrapping System.Net.HttpListenerException: The network location cannot be reached. For information about network troubleshooting, see Windows Help 错误消息，则解决方案是以管理员身份打开 cmd.exe 并运行以下命令：

netsh http add iplisten ipaddress=127.0.0.1
首次执行 Jira 作用域后，您的默认浏览器中会收到一个授权请求窗口，您需要在其中指定 Jira 站点，然后单击“ 接受”。