步骤 1:在飞书创建自建应用
- 打开飞书客户端,进入 工作台
- 点击 创建应用
- 创建成功后,获取 App ID 和 App Secret

步骤 2:在 Teable 中创建认证提供商
- 进入 Teable 的 SSO 设置页面(
空间设置->认证设置) - 创建新的认证提供商
- 填写第一步中获取的 App ID 和 App Secret

- 创建完成后,点击复制 providerId,稍后配置飞书应用时需要用到

步骤 3:配置飞书应用
回到飞书开放平台控制台进行以下配置:配置权限
- 进入 开发配置 → 权限管理
- 搜索并勾选以下权限:
contact:user.base:readonlycontact:user.email:readonly
安全设置
- 进入 开发配置 → 安全设置
- 在 重定向 URL 中填写:
https://app.teable.cn/api/auth/authentication/__providerId__/callback
注意:
- 请将 URL 中的
__providerId__替换为 步骤 2 中复制的 ID。
网页应用设置
- 进入 应用能力 → 网页应用
- 点击 网页应用配置 的 设置
- 在 桌面端主页 和 移动端主页 中填写:
https://app.teable.cn/api/auth/authentication/__providerId__
注意:同样需要替换 __providerId__ 和域名(同上一步)。
步骤 4:发布应用版本
- 点击 创建版本
- 上传应用图标

- 设置 版本号(例如
1.0.0) - 选择 可用范围(例如全员可见)
- 点击 发布,等待审批通过即可生效
步骤 5:访问应用与登录测试
公有云登录链接需要带上您的organizationId。
例如:https://app.teable.cn/auth/login?organizationId=orgxxxxxxxx
此时登录页面会出现飞书登录按钮,或者直接在飞书工作台点击应用图标进入。
