Atlassian 凭据

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

信息

选择凭据类型

产品专用凭据 Jira SW Cloud OAuth2 API 和 Confluence Cloud OAuth2 API 基于此凭据构建，适合 Jira 和 Confluence 节点，会请求这些节点所需的作用域。通用 Atlassian OAuth2 API 凭据适用于高级场景，例如在 HTTP Request 节点中自行定义作用域。

前置条件

• 要访问的产品（例如 Jira 或 Confluence）的 Atlassian Cloud 站点。
• Atlassian Developer Console 的访问权限。

支持的身份验证方式

• OAuth2

相关资源

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

使用 OAuth2

配置此凭据需要一个 Atlassian 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（权限），再选择要访问的各产品 API（例如 Jira API 或 Confluence API）旁的 Add（添加）。
9. 在每个已添加的 API 旁选择 Configure（配置），再选择 Edit Scopes（编辑作用域），启用计划请求的作用域。
10. 在左侧边栏选择 Settings（设置）。
11. 复制 Client ID（客户端 ID），粘贴到 n8n。
12. 复制 Secret（秘密值），粘贴到 n8n 的 Client Secret（客户端密钥）。
13. 在 Scope（作用域）中输入以空格分隔的待请求作用域列表，例如 read:jira-work read:page:confluence offline_access。
14. 选择 Connect my account（连接我的账户），按照提示完成 OAuth2 流程。

注意

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

如果凭据请求了 OAuth 应用未启用的作用域，Atlassian 会拒绝授权请求。必须在 Atlassian Developer Console 的 Permissions（权限）> Edit Scopes（编辑作用域）中，同样启用你在 n8n 的 Scope（作用域）字段填写的每个作用域。offline_access 是例外：Atlassian 会在请求时自动授予它，因此只需填入 Scope 字段。此作用域用于刷新令牌，让连接无需你再次登录即可持续工作。

可用作用域，请参阅 Atlassian 文档中的 Jira 作用域和 Confluence 作用域。