创建 Trello 应用并连接 OOMOL
在 OOMOL 中使用 OAuth2 连接 Trello,需要提供自己创建的 Trello 应用的 Client ID 和 Client Secret。你需要拥有在 Trello Workspace 中创建或管理应用的权限。
1. 创建或打开 Trello 应用
- 打开 Trello 应用管理页面并登录。
- 选择已有应用,或点击 New,填写名称、Workspace、邮箱、支持邮箱和作者。首次进入时,Trello 可能要求填写 Joint Development Agreement。
- 新建用于连接 OOMOL 的应用时,选择 My app doesn’t use Power-Up capabilities,然后点击 Create。
- 进入应用,在左侧导航选择 OAuth 2.0。
Power-Up OAuth 客户端的部分权限受单次授权的 Workspace 范围限制,非 Power-Up OAuth 客户端没有这项限制。创建应用时选择的 Workspace 表示应用的归属;连接后能访问哪些看板,仍由 Trello 用户的实际权限决定。
2. 选择机密客户端并添加回调 URL
- 在 客户端安全类型 中选择 机密(Confidential)。OOMOL 后端会使用客户端密钥交换和刷新 token。公开的(Public) 类型不提供客户端密钥。
- 打开 OOMOL 应用连接,找到 Trello,点击 添加账号,选择 OAuth2。
- 复制 OOMOL 显示的完整 重定向 URI,粘贴到 Trello 的 回调 URL 输入框,点击 添加(Add),再点击 保存(Save)。保留原地址的路径和结尾斜杠,不要自行修改。
Trello 至少需要一个回调 URL 才能启用 OAuth 2.0。
3. 勾选权限并保存客户端凭据
在 Trello 的 Scopes 表格中启用 OOMOL 连接所申请的权限,然后保存。默认连接申请以下权限:
read:board:trelloread:enterprise:trelloread:member:trelloread:organization:trellowrite:board:membership:trellowrite:board:trellowrite:enterprise:trellowrite:member:trellowrite:organization:membership:trellowrite:organization:trello
看板写入权限允许修改卡片、列表、评论和看板成员关系。Workspace 写入权限允许修改 Workspace 及其成员关系。企业写入权限允许管理企业资源,成员写入权限可用于收藏看板、保存搜索等操作。
只申请实际需要的权限。如果只需要读取数据,请在 OOMOL 的 OAuth 高级设置中移除写入权限,并在 Trello 中启用对应的读取权限。OOMOL 会自动补齐识别账号所需的 read:member:trello 和获取刷新 token 所需的 offline_access。offline_access 不显示在 Trello 的配置表格中,无需寻找对应复选框。
将 OAuth 2.0 页面的 客户端 ID(Client ID) 和 客户端密钥(Client Secret) 复制到 OOMOL 的 OAuth 客户端配置中并保存。这里使用的是 OAuth 2.0 页签的凭据,不是 Trello Auth 页签中的 API key 和 token。
4. 完成授权并确认访问范围
在 OOMOL 中继续连接,在 Trello 授权页同意授权。返回 OOMOL 后,查询 Trello 看板列表,确认包含你需要访问的看板。
授权失败时,检查回调 URL 是否完全一致、客户端类型是否为 机密,以及申请的 scopes 是否已启用。无法管理应用时,请 Workspace 管理员协助。自己的客户端不会增加账号原本没有的看板权限。
如果 OOMOL 中没有 OAuth2 选项,可以使用 Trello API key 和 token 连接。创建 OAuth 客户端不会自动迁移已有连接。