跳到主要内容

Jira 凭据

这些凭据可用于以下节点的身份验证：

前置条件 ​

创建 Jira Software Cloud 或 Server 账户。

支持的身份验证方式 ​

相关资源 ​

有关该服务的更多信息，请参阅 Jira API 文档。

使用 SW Cloud OAuth2 ​

配置此凭据需要一个 Jira Software Cloud 账户，以及 Atlassian Developer Console 的访问权限。

然后：

  1. 打开 Atlassian Developer Console，选择 Create（创建）> OAuth 2.0 integration（OAuth 2.0 集成）。
  2. 输入应用的 Name（名称），同意条款，再选择 Create（创建）。
  3. 在左侧边栏选择 Authorization（授权）。
  4. 在 OAuth 2.0 (3LO) 旁选择 Add（添加）。
  5. 在 n8n 中复制 OAuth Redirect URL（OAuth 重定向 URL）。
  6. 将该 URL 粘贴到 Atlassian Developer Console 的 Callback URL（回调 URL）字段。
  7. 选择 Save changes（保存更改）。
  8. 在左侧边栏选择 Permissions（权限），再选择 Jira API 旁的 Add（添加）。
  9. 在 Jira API 旁选择 Configure（配置）> Edit Scopes（编辑作用域）。至少启用以下作用域，再保存修改：
    • read:jira-user
    • read:jira-work
    • write:jira-work
    • manage:jira-webhook
  10. 在左侧边栏选择 Settings（设置）。
  11. 复制 Client ID（客户端 ID），粘贴到 n8n。
  12. 复制 Secret（秘密值），粘贴到 n8n 的 Client Secret（客户端密钥）。
  13. 输入访问 Jira 的 Site URL（站点 URL），例如 https://example.atlassian.net。
  14. 选择 Connect to Jira SW Cloud（连接到 Jira SW Cloud），按照提示完成 OAuth2 流程。
信息

创建和删除用户需要额外作用域

Jira 节点的 User > Create（用户 > 创建）和 User > Delete（用户 > 删除）操作调用的端点要求 manage:jira-configuration 作用域，它不在默认作用域中。如需使用这两个操作，请在 Atlassian Developer Console 的 OAuth 应用中启用 manage:jira-configuration，在凭据中开启 Custom Scopes（自定义作用域），将该作用域添加到列表中，然后重新连接。Jira 节点的其余操作均可使用默认作用域。

注意

在应用中启用每个请求的作用域

如果凭据请求了 OAuth 应用未启用的作用域，Atlassian 会拒绝授权请求。请确保在 Atlassian Developer Console 中启用上述全部作用域。凭据还会请求 offline_access，Atlassian 会在请求时自动授予它。此作用域用于刷新令牌，让连接无需你再次登录即可持续工作。

更多信息，请参阅 Atlassian 文档中的 OAuth 2.0（3LO）应用。

使用 SW Cloud API 令牌 ​

配置此凭据需要一个 Jira Software Cloud 账户。

然后：

  1. 登录 Atlassian 个人资料，进入 Security > API tokens（安全 > API 令牌）页面，或通过此链接直接打开。
  2. 选择 Create API Token（创建 API 令牌）。
  3. 输入令牌的 Name（名称），例如 n8n integration。
  4. 设置 Expires on（到期日期），或保留默认日期。
  5. 选择 Create（创建）。
  6. 复制 API 令牌。
  7. 在 n8n 中输入 Jira 账户关联的 Email（电子邮箱）地址。
  8. 将复制的 API 令牌粘贴到 API Token（API 令牌）。
  9. 输入访问 Jira 的 Domain（域名），例如 https://example.atlassian.net。

更多信息，请参阅管理 Atlassian 账户的 API 令牌。

信息

新令牌

新令牌最长可能需要一分钟才会生效。如果首次凭据验证失败，请等待一分钟后重试。

使用 SW Server 账户 ​

配置此凭据需要一个 Jira Software Server 账户。

然后：

  1. 输入 Jira 账户关联的 Email（电子邮箱）地址。
  2. 输入 Jira 账户的 Password（密码）。
  3. 输入访问 Jira 的 Domain（域名）。
本文为社区中文翻译。查看对应英文原文