---
author: OOMOL
author_url: https://oomol.com/zh-cn/about/
title: 创建 Trello 应用并连接 OOMOL
description: 创建自己的 Trello OAuth 2.0 客户端，设置回调地址和权限，并在 OOMOL 中连接账号。
lang: zh-CN
canonical_url: https://oomol.com/zh-cn/docs/trello-oauth-app/
markdown_url: https://oomol.com/zh-cn/docs/trello-oauth-app.md
---

# 创建 Trello 应用并连接 OOMOL

在 OOMOL 中使用 OAuth2 连接 Trello，需要提供自己创建的 Trello 应用的 **Client ID** 和 **Client Secret**。你需要拥有在 Trello Workspace 中创建或管理应用的权限。

## 1. 创建或打开 Trello 应用

1. 打开 [Trello 应用管理页面](https://trello.com/apps/admin)并登录。
2. 选择已有应用，或点击 **New**，填写名称、Workspace、邮箱、支持邮箱和作者。首次进入时，Trello 可能要求填写 Joint Development Agreement。
3. 新建用于连接 OOMOL 的应用时，选择 **My app doesn't use Power-Up capabilities**，然后点击 **Create**。
4. 进入应用，在左侧导航选择 **OAuth 2.0**。

Power-Up OAuth 客户端的部分权限受单次授权的 Workspace 范围限制，非 Power-Up OAuth 客户端没有这项限制。创建应用时选择的 Workspace 表示应用的归属；连接后能访问哪些看板，仍由 Trello 用户的实际权限决定。

## 2. 选择机密客户端并添加回调 URL

1. 在 **客户端安全类型** 中选择 **机密（Confidential）**。OOMOL 后端会使用客户端密钥交换和刷新 token。**公开的（Public）** 类型不提供客户端密钥。
2. 打开 [OOMOL 应用连接](https://console.oomol.com/connections)，找到 **Trello**，点击 **添加账号**，选择 **OAuth2**。
3. 复制 OOMOL 显示的完整 **重定向 URI**，粘贴到 Trello 的 **回调 URL** 输入框，点击 **添加（Add）**，再点击 **保存（Save）**。保留原地址的路径和结尾斜杠，不要自行修改。

Trello 至少需要一个回调 URL 才能启用 OAuth 2.0。

## 3. 勾选权限并保存客户端凭据

在 Trello 的 **Scopes** 表格中启用 OOMOL 连接所申请的权限，然后保存。默认连接申请以下权限：

- `read:board:trello`
- `read:enterprise:trello`
- `read:member:trello`
- `read:organization:trello`
- `write:board:membership:trello`
- `write:board:trello`
- `write:enterprise:trello`
- `write:member:trello`
- `write:organization:membership:trello`
- `write: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 客户端不会自动迁移已有连接。

[官方应用创建指南](https://developer.atlassian.com/cloud/trello/guides/power-ups/managing-apps/)和 [OAuth 2.0 配置说明](https://developer.atlassian.com/cloud/trello/guides/rest-api/oauth-2-client-configuration/)。
