n8n 中文文档

Atlassian 凭据

Atlassian OAuth2 API 凭据是用于 Atlassian Cloud 的通用 OAuth2 凭据。

提示

选择凭据类型

产品专用的 Jira SW Cloud OAuth2 API 和 Confluence Cloud OAuth2 API 凭据都基于此凭据,并会请求相应节点所需的 scopes,因此适合用于 Jira 和 Confluence 节点。在高级场景中(例如搭配 HTTP Request 节点并自行定义 scopes),请使用通用的 Atlassian OAuth2 API 凭据。

前置要求

支持的身份验证方式

  • OAuth2

相关资源

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

使用 OAuth2

要配置此凭据,您需要一个 Atlassian Cloud 站点,并且能够访问 Atlassian Developer Console。

然后:

  1. 打开 Atlassian Developer Console,选择 Create > OAuth 2.0 integration。
  2. 输入应用的 Name 并同意条款,然后选择 Create。
  3. 在左侧边栏中选择 Authorization。
  4. 在 OAuth 2.0 (3LO) 旁选择 Add。
  5. 在 n8n 中复制 OAuth Redirect URL。
  6. 将该 URL 粘贴到 Atlassian Developer Console 的 Callback URL 字段中。
  7. 选择 Save changes。
  8. 在左侧边栏中选择 Permissions,然后在要访问的每个产品 API(例如 Jira API 或 Confluence API)旁选择 Add。
  9. 在每个已添加的 API 旁选择 Configure,再选择 Edit Scopes,并启用计划请求的 scopes。
  10. 在左侧边栏中选择 Settings。
  11. 复制 Client ID 并粘贴到 n8n 中。
  12. 复制 Secret,并将其作为 Client Secret 粘贴到 n8n 中。
  13. 在 Scope 中输入以空格分隔的 scope 列表,例如 read:jira-work read:page:confluence offline_access。
  14. 选择 Connect my account,按照提示完成 OAuth2 流程。

警告

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

如果凭据请求的 scope 未在 OAuth 应用中启用,Atlassian 会拒绝授权请求。您必须在 Atlassian Developer Console 的 Permissions > Edit Scopes 中,为应用启用 n8n Scope 字段中填写的每一个 scope。offline_access 除外:Atlassian 会在请求时自动授予它,因此只需将其写入 Scope 字段。它用于刷新 token,使连接无需再次登录也能持续工作。

有关可用 scopes,请参阅 Atlassian 文档中的 Jira scopes 和 Confluence scopes。

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。