n8n 中文文档

Jira 凭证

您可以使用这些凭据来验证以下节点:

先决条件

创建一个 Jira{:target=_blank .external-link} Software Cloud 或 Server 账户。

支持的认证方式

相关资源

参考 Jira 的 API 文档{:target=_blank .external-link}了解有关该服务的更多信息。

使用SW Cloud OAuth2

要配置此凭据,你需要一个 Jira Software Cloud{:target="_blank" .external-link} 账户,并且可以访问 Atlassian Developer Console{:target="_blank" .external-link}。

  1. 打开Atlassian 开发者控制台,然后选择 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 开发者控制台的 Callback URL 回调地址 字段中。
  7. 选择 Save changes 保存更改。
  8. 在左侧边栏中选择 Permissions 权限,然后选择 Jira API 吉拉API 旁边的 Add 添加。
  9. 选择 Jira API 吉拉API > Edit Scopes 编辑范围 旁边的 Configure 配置。至少启用这些范围,然后保存您的编辑:
    • read:jira-user
    • read:jira-work
    • write:jira-work
    • manage:jira-webhook
  10. 在左侧边栏中选择 Settings。
  11. 复制 Client ID 并粘贴到 n8n 中。
  12. 复制 Secret,并在 n8n 中将其粘贴为 Client Secret。
  13. 输入你访问 Jira 的 Site URL 站点 URL,例如 https://example.atlassian.net。
  14. 选择 Connect to Jira SW Cloud,并按照提示完成 OAuth2 流程。

提示

创建和删除用户需要额外的 scope

Jira 节点的 User > Create 和 User > Delete 操作会调用需要 manage:jira-configuration scope 的 endpoint,而该 scope 不在默认 scopes 中。若要使用这些操作,请在 Atlassian Developer Console 中为 OAuth 应用启用 manage:jira-configuration,在凭据中打开 Custom Scopes,将该 scope 添加到列表,然后重新连接。Jira 节点的其他所有操作均可使用默认 scopes。

警告

在应用中启用所有请求的 scope

如果凭据请求的 scope 未在 OAuth 应用中启用,Atlassian 会拒绝授权请求。请确保在 Atlassian Developer Console 中启用上面列出的全部 scopes。凭据还会请求 offline_access,Atlassian 会在请求时自动授予它。它用于刷新 token,使连接无需再次登录也能持续工作。

有关更多信息,请参阅 Atlassian 文档中的 OAuth 2.0 (3LO) apps。

使用 SW Cloud API token

要配置此凭据,您需要一个 Jira Software Cloud{:target=_blank .external-link} 账户。

然后:

  1. 登录到你的 Atlassian 个人资料 > Security > API tokens 页面,或使用此链接直接跳转。
  2. 选择 Create API Token。
  3. 为你的 token 输入 Name,例如 n8n integration。
  4. 设置 Expires on 日期,或保留默认日期。
  5. 选择 Create。
  6. 复制 API token。
  7. 在 n8n 中,输入与你的 Jira 账户关联的 Email 邮箱地址。
  8. 将你复制的 API token 粘贴为 API Token。
  9. 输入你访问 Jira 的 Domain 域名,例如 https://example.atlassian.net。

有关更多信息,请参阅 管理 Atlassian 账户的 API token。

提示

New tokens 新代币

新令牌可能需要一分钟才能生效。如果您的凭据验证第一次失败,请稍等片刻,然后重试。

使用 SW Server account

要配置此凭据,您需要一个 Jira Software Server{:target=_blank .external-link} 账户。

然后:

  1. 输入与您的 Jira 账户关联的 Email 邮箱地址。
  2. 输入您的 Jira 账户 Password 密码。
  3. 输入您访问 Jira 的 Domain 域名。
不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。