Jira 云集成 - Amazon 快速
您能做什么开始前的准备工作创建 Jira API 令牌设置 Jira 集成配置身份验证可用操作共享集成管理 Jira 集成

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

Jira 云集成

将 Amazon Quick 连接到你的 Jira Cloud 实例，以管理问题、项目和其他 Jira 对象。您无需离开 Amazon Quick 环境即可创建、更新和查询 Jira 内容。此集成需要亚马逊 Quick Pro 等级或更高的等级。

您能做什么

借助 Jira Cloud 集成，你可以通过 Jira REST API 在 Jira 实例中执行操作。

动作连接器

通过 Jira REST API 创建、更新和查询 Jira 事务、项目和其他对象。

注意

此集成仅支持操作执行。您不能使用它来创建知识库或出于搜索目的访问 Jira 数据。

开始前的准备工作

您需要以下内容来设置 Jira 集成：

  • 具有适当权限的 Jira Cloud 实例。

  • Jira 用户账户或 API 令牌凭证。

  • 亚马逊 Quick Author 或更高版本

  • 配置 OAuth 应用程序的管理权限（用于用户身份验证）。

创建 Jira API 令牌

要使用 API 密钥身份验证，请在您的 Atlassian 账户中创建 API 令牌。

  1. 前往您的 Atlassian 账户设置，然后选择安全。

  2. 为 Amazon Quick 集成创建新的 API 令牌。

  3. 复制生成的令牌以在您的 Amazon Quick 集成设置中使用。

  4. 记下你的 Jira Cloud 实例 URL 和用户电子邮件地址。您的 Jira Cloud 实例 URL 是 API 调用的特殊值，可以通过导航到来找到。https://your-domain.atlassian.net/_edge/tenant_info

重要

即使 API 令牌被撤销或配置不当，Jira Cloud 也可能返回 HTTP 200 成功响应。欲了解更多信息，请参阅 JRACLOUD-82932。如果您的集成似乎成功连接，但操作意外失败，请验证您的 API 令牌是否有效且未被撤销。

设置 Jira 集成

按照以下步骤将 Amazon Quick 连接到你的 Jira Cloud 实例。

  1. 在 Amazon Quick 控制台中，选择集成。

  2. 单击 “添加”（加上 “+” 按钮）。

  3. 完成整合细节：

    • 名称-输入 Jira 集成的描述性名称。

    • 描述（可选）-描述此集成的目的。

  4. 选择连接类型（用户或服务身份验证）。

  5. 根据身份验证方法完成连接设置：

    • 对于用户身份验证 (OAuth)：

      • 基本网址-您的 Jira Cloud 实例网址。必须按以下格式提供:https://api.atlassian.com/ex/jira/instanceid. instanceid您可以通过导航到https://your-domain.atlassian.net/_edge/tenant_info来找到。

      • 客户端 ID-您的 Atlassian OAuth 应用程序客户端 ID。

      • 客户端密钥-您的 Atlassian OAuth 应用程序客户端密钥。

      • 令牌网址-Atlassian OAuth 令牌终端节点。

      • 身份验证网址-Atlassian 授权端点 OAuth 。

      • 重定向 URL- OAuth 重定向 URI。

    • 对于服务身份验证（API 密钥）：

      • 基本网址-您的 Jira Cloud 实例网址。

      • API 密钥 ——你的 Jira API 令牌。

      • 电子邮件-与您的 Jira 用户帐户关联的电子邮件地址。

  6. 选择创建并继续。

  7. 选择要与之共享集成的用户。

  8. 单击下一步。

配置身份验证

Jira Cloud 集成支持两种身份验证方法。选择最适合贵组织的方法。

用户认证 (OAuth)

OAuth 当您希望在个人用户身份下执行操作时使用。配置以下字段：

  • 基本网址-您的 Jira Cloud 实例网址。

  • 客户端 ID-您的 Atlassian OAuth 应用程序客户端 ID。

  • 客户端密钥-您的 Atlassian OAuth 应用程序客户端密钥。

  • 令牌网址-Atlassian OAuth 令牌终端节点。

  • 身份验证网址-Atlassian 授权端点 OAuth 。

  • 重定向 URL- OAuth 重定向 URI。

必需的 OAuth 范围：

  • read:jira-user-读取用户信息。

  • read:jira-work-阅读问题、项目和工作项。

  • write:jira-work-创建和修改议题和工作项。

  • manage:jira-project-管理项目设置。

  • manage:jira-configuration-管理 Jira 的配置。

  • manage:jira-webhook-管理网络挂钩。

  • read:sprint:jira-software-阅读冲刺信息。

  • write:sprint:jira-software-创建和修改冲刺。

  • delete:sprint:jira-software-删除冲刺。

  • write:board-scope:jira-software-管理主板配置。

服务认证（API 密钥）

对 service-to-service连接使用 API 密钥身份验证。配置以下字段：

  • 基本网址-您的 Jira Cloud 实例网址。

  • API 密钥 ——你的 Jira API 令牌。

  • 电子邮件-与您的 Jira 用户帐户关联的电子邮件地址。

注意

由于已知的 Jira Cloud 行为，即使使用已撤销或无效的 API 令牌，集成也可能显示为成功连接。如果设置后操作意外失败，请在 Atlassian 账户设置中验证您的 API 令牌仍然有效。

可用操作

创建 Jira 集成后，您可以使用以下操作与 Jira Cloud 进行交互：

  • 创建、读取、更新和删除 Jira 事务。

  • 管理问题过渡和工作流程。

  • 使用 JQL（Jira 查询语言）查询问题。

  • 管理项目、组件和版本。

  • 为议题添加评论和附件。

  • 管理用户分配和观察者。

  • 访问项目和议题元数据。

注意

您可以使用的操作取决于您的 Jira Cloud 实例中配置的权限和身份验证方法。

共享集成

您可以与组织中的其他用户共享您的 Jira 操作连接器。

  1. 创建集成后，选择共享集成。

  2. 选择要与之共享集成的用户或群组。

  3. 为共享访问设置适当的权限。

  4. 确认您的共享设置。

管理 Jira 集成

您可以为 Jira 集成执行以下管理任务：

  • 编辑集成设置-更新身份验证设置或 Jira 实例配置。

  • 共享集成访问权限-使组织中的其他用户可以使用该集成。

  • 监控使用情况指标-查看集成活动和 API 使用情况指标。

  • 查看可用操作-查看可用 Jira 操作的完整列表。

  • 删除集成-移除集成并撤消关联的身份验证。