Jira 凭证
您可以使用这些凭据来验证以下节点:
先决条件
创建一个 Jira{:target=_blank .external-link} Software Cloud 或 Server 账户。
支持的认证方式
- SW Cloud OAuth2:与 Jira Software Cloud 一起使用此方法进行 OAuth2 身份验证。
- SW Cloud API token:与 Jira Software Cloud 一起使用此方法。
- SW Server account:与 Jira Software Server 一起使用此方法。
相关资源
参考 Jira 的 API 文档{:target=_blank .external-link}了解有关该服务的更多信息。
使用SW Cloud OAuth2
要配置此凭据,你需要一个 Jira Software Cloud{:target="_blank" .external-link} 账户,并且可以访问 Atlassian Developer Console{:target="_blank" .external-link}。
- 打开Atlassian 开发者控制台,然后选择 Create 创建 > OAuth 2.0 integration OAuth 2.0 集成。
- 输入您的应用程序的 Name 名称 并同意条款,然后选择 Create 创建。
- 在左侧边栏中选择 Authorization 授权。
- 在 OAuth 2.0 (3LO) 旁边,选择 Add 添加。
- 在n8n中,复制OAuth Redirect URL OAuth 重定向 URL。
- 将 URL 粘贴到 Atlassian 开发者控制台的 Callback URL 回调地址 字段中。
- 选择 Save changes 保存更改。
- 在左侧边栏中选择 Permissions 权限,然后选择 Jira API 吉拉API 旁边的 Add 添加。
- 选择 Jira API 吉拉API > Edit Scopes 编辑范围 旁边的 Configure 配置。至少启用这些范围,然后保存您的编辑:
read:jira-userread:jira-workwrite:jira-workmanage:jira-webhook
- 在左侧边栏中选择 Settings。
- 复制 Client ID 并粘贴到 n8n 中。
- 复制 Secret,并在 n8n 中将其粘贴为 Client Secret。
- 输入你访问 Jira 的 Site URL 站点 URL,例如
https://example.atlassian.net。 - 选择 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} 账户。
然后:
- 登录到你的 Atlassian 个人资料 > Security > API tokens 页面,或使用此链接直接跳转。
- 选择 Create API Token。
- 为你的 token 输入 Name,例如
n8n integration。 - 设置 Expires on 日期,或保留默认日期。
- 选择 Create。
- 复制 API token。
- 在 n8n 中,输入与你的 Jira 账户关联的 Email 邮箱地址。
- 将你复制的 API token 粘贴为 API Token。
- 输入你访问 Jira 的 Domain 域名,例如
https://example.atlassian.net。
有关更多信息,请参阅 管理 Atlassian 账户的 API token。
提示
New tokens 新代币
新令牌可能需要一分钟才能生效。如果您的凭据验证第一次失败,请稍等片刻,然后重试。
使用 SW Server account
要配置此凭据,您需要一个 Jira Software Server{:target=_blank .external-link} 账户。
然后:
- 输入与您的 Jira 账户关联的 Email 邮箱地址。
- 输入您的 Jira 账户 Password 密码。
- 输入您访问 Jira 的 Domain 域名。