Jira 身份验证

在使用 Jira 活动或触发器之前，必须在 UiPath Integration Service 中创建与 Jira Cloud 实例的连接。

重要提示：

Jira 连接器仅支持 Jira Cloud 实例。不支持 Jira Server 和 Data Center 实例。

支持的身份验证方法（仅限 Jira Cloud）

身份验证类型	描述	理想适用于
基本	使用 Atlassian Cloud 电子邮件和 API 令牌	服务帐户、Unattended 自动化。
OAuth 2.0	使用用户登录并同意 Jira Cloud 作用域	用户委派的流程、有人值守的流程或个人的流程。
自带您自己的 OAuth 2.0 应用程序	将您自己的 OAuth 应用程序与 UiPath 的回调 URL 结合使用。	管理自己的 Jira 应用程序和密钥的客户。

基本

使用 Atlassian 帐户电子邮件和 API 令牌向 Jira Cloud 进行身份验证，并以 HTTPS 基本身份验证传递。了解详情。

连接使用与配置的 Jira 用户相同的项目和问题权限运行。

必填字段

字段	描述
网站 URL	Jira 站点 URL，例如https://your-domain.atlassian.net 。 注意：确保 URL 包含“https://”，并且末尾不以“/”结尾。
用户名	用于登录 Jira Cloud 的 Atlassian 帐户电子邮件
API 令牌	与帐户关联的 Jira Cloud API 令牌

如何生成 API 令牌

1. 在 Atlassian 帐户安全性中创建 API 令牌（没有作用域）。。了解详情。
2. 复制生成的令牌并妥善保存以备后用。
3. 在 UiPath Integration Service 中，添加 Jira 连接并填写以下内容：

• 网站 URL
• 用户名
• API 令牌秒至秒

令牌生命周期

为了您的安全，令牌的持续时间不能超过一年，并且可以从 Atlassian 帐户安全页面撤销和删除。删除后，使用该令牌的所有 Integration Service 调用都将失败，并显示 401“401 Unauthorized”，直到配置新的令牌为止。

故障排除

• 401 未授权：检查电子邮件和令牌，确认令牌存在且已正确复制。
• 403 禁止执行某些操作：确认 Jira 用户拥有目标项目和问题类型所需的项目权限。

常见问题

是否可以将 API 令牌限制用于特定项目？
否。令牌继承用户的所有权限；通过在 Jira 中配置用户/项目权限来限制访问。

验证码 或 SSO 是否会影响基于令牌的调用？
验证码和交互式登录规则适用于用户名/密码，不适用于 API 令牌； SSO 仍会监管帐户，但不会阻止使用令牌。了解详情...

我应如何轮换 UiPath 使用的令牌？
创建一个新令牌，使用新令牌更新 UiPath 中的 Jira 连接，验证自动化，然后撤销旧令牌。

自带 OAuth 2.0 应用程序

此身份验证类型类似于 OAuth 2.0 授权代码，但要求您使用自己的客户端 ID 和客户端密码凭据。

请按照 Jira 准则创建您自己的应用程序： OAuth 2.0 (3LO) 应用程序。您可以从 Jira开发者控制台创建应用程序。设置您自己的 OAuth2.0 时请确保以以下形式提供重定向/回调 URL： https://cloud.uipath.com/provisioning_/callback
当自动化应在最终用户的上下文中运行并遵守 OAuth 作用域和用户的项目权限时，建议使用此方法。。

必填字段

字段	描述
网站 URL	Jira 站点 URL，例如https://your-domain.atlassian.net 。当系统提示您授予 UiPath 应用程序访问 Jira 的权限时，请确保选择相同的 Jira 站点 URL。
客户端 ID	Atlassian OAuth 2.0 (3LO) 应用程序的客户端标识符。
客户端密码	Atlassian OAuth 2.0 (3LO) 应用程序中的密码。这将存储在 UiPath Integration Service 数据库中。
重定向 URL	UiPath 回调 URL，在 Atlassian 应用程序中完全配置。
用户名	在 Jira 登录页面中使用。
密码	在 Jira 登录页面中使用。

了解 Jira 作用域

作用域定义应用程序可以请求与 Atlassian 产品交互的访问级别。当建立连接并且用户通过 Jira 活动（通过 API）授权应用程序时，OAuth 应用程序将获得代表用户执行指定操作的权限，具体取决于用户的权限设置。有关可用作用域的完整列表，请参阅Jira 作用域文档。

下表列出了创建连接所需的作用域：

范围	类型	描述
读取：jira-user	必填	在 Jira 中查看用户有权访问的用户信息，包括用户名、电子邮件地址和头像。
阅读：jira-work	必填	读取 Jira 项目和问题数据，搜索问题以及与问题关联的对象，例如附件和工作日志。
写入：jira-work	必填	在 Jira 中创建和编辑问题、以用户身份发布注释、创建工作日志以及删除问题。
管理：jira-project	必填	创建和编辑项目设置，以及创建新的项目级别对象（例如版本和组件）。
离线_访问	必填	自动刷新 OAuth 令牌
管理：jira 配置	可选	执行 Jira 管理操作（例如，创建项目和自定义字段、查看工作流以及管理问题链接类型）。
管理：jira-data-provider	可选	在 Jira 中管理第三方的开发和发布信息

重要提示：

应用程序必须具有连接请求的所有作用域。

如何生成凭据

1. 遵循 Atlassian 的3LO 应用程序指南（从 3LO 到 3LO 应用程序） 。
2. 将 Integration Service Jira 身份验证页面中的 UiPath Jira 回调 URL 配置为重定向 URI。
3. 选择所需的 Jira Cloud 作用域（例如read:jira-work 、 write:jira-work 、 read:jira-user ）。
4. 将 Atlassian 应用中的客户端 ID 和客户端密码复制到 UiPath Jira 连接设置。

令牌生命周期

访问令牌的生命周期很短； UiPath 使用刷新令牌获取新的访问令牌，直到刷新令牌过期或被撤销。

撤销同意或删除 Atlassian OAuth 应用会导致令牌失效，并且需要从 UiPath 重新授权。

故障排除 (OAuth)

• 重定向 URI 不匹配：确保在 Atlassian 中配置的重定向 URL 与 UiPath 的回调 URL 完全匹配。

• insufficient_scope或 403：将任何缺少的 Jira 作用域添加到应用程序，并确保用户具有必要的 Jira 权限。

常见问题

问题 CRUD 的最小作用域是多少？
它因对象而异，但通常适用于问题/注释的read:jira-work和write:jira-work ；如果使用用户查找/分配，请添加read:jira-user 。

作用域是否可以限制对特定项目的访问？
否。作用域可以正常运行；项目级别的访问权限仍由 Jira 中授权用户的权限进行管理。</

为什么在成功登录 OAuth 后仍收到 403 错误？
确保read:jira-user正在您的私有应用程序中推断。

OAuth 2.0 授权代码

在如何获取令牌以及如何在 Jira Cloud 中执行活动方面，UiPath Integration Service 中的 OAuth 2.0 授权代码方法在功能上与自带 OAuth 2.0 应用程序 (BYOA) 相同。主要区别在于谁拥有 OAuth 应用程序凭据：

• OAuth 2.0 授权代码使用 UiPath 自己的已注册适用于 Jira Cloud 的公共 OAuth 2.0 应用程序，具有有限的预配置作用域。
  • 这意味着客户端 ID 和客户端密码由 UiPath 管理，不需要用户提供。
  • 您只需提供 Jira 站点 URL 并在设置连接期间选择所需的作用域。
  • 其余的身份验证体验，包括用户登录、同意和令牌管理，与自定义应用程序相同。
• BYOA（自带 OAuth）允许组织使用 Atlassian 注册和管理自己的 OAuth 2.0 应用程序。
  • 用户或管理员必须提供自定义应用程序的客户端 ID、客户端密码，并相应地配置回调 URL。。
  • 如果您的组织需要私有应用程序、希望管理自己的密钥或需要对 OAuth 客户端配置强制执行监管，请使用 BYOA。

在所需作用域、同意流程或可用功能方面没有差异；两者都使用 Atlassian 的三足 OAuth 获取用户授予的 Jira Cloud 访问令牌。唯一的区别是您使用的是 UiPath 的公共集成（无需客户端凭据），还是您自己的 Atlassian OAuth 应用程序（设置时需要凭据）。