从管理后台配置 SSO （仅 PRO)

专业版及以上空间站，公有云版本与私有化版本均支持

支持的 SSO Provider

• 标准OIDC

• 飞书

OIDC

参靠通用环境变量配置

飞书

1. 进入飞书创建自建应用

飞书客户端 -> 工作台 -> 创建应用

得到 App ID 和 App Secret

2. 进入 Teable 创建认证提供商

公有云版本 (app.teable.cn) -> 空间 -> 空间设置 -> 认证设置

需要空间可管理权限

或

私有部署环境 -> 管理面板 -> 认证设置

需要实例管理员账号

填写 APP ID, APP Secret

第一步创建飞书自建应用的时候可以得到这两个值

点击复制，得到 providerId 备用

3. 回到飞书自建应用进行配置

3.1 权限设置

开发配置 -> 权限管理

搜索勾选

contact:user.base:readonly

contact:user.email:readonly

3.2 安全设置

开发配置 -> 安全设置

重定向 URL：

https://app.teable.cn/api/auth/authentication/__providerId__/callback

将 __providerId__ 其替换为第二步复制来的 providerId

私有化按本请将 app.teable.cn 替换成私有化实例的域名或 IP

3.3 网页应用设置

应用能力 -> 网页应用

网页应用配置，点击设置

为公有云设置

桌面端主页，移动端主页：

https://app.teable.cn/auth/login?spaceId=spcxxxxxxx

注意将 spexxxxxxx 替换成您的 spaceId

为私有部署版本设置

桌面端主页，移动端主页：

设置为您的私有化实例访问的 URL，比如 https://your-teable.com

4. 发布版本

点击创建版本

上传图标

设置版本号，比如 1.0.0

选择可用范围，比如全员可见

点击发布，完成审批即可生效

5. 访问应用

公有云

公有云登录链接需要带上您的 spaceId

例如https://app.teable.cn/auth/login?spaceId=spcxxxxxxxx这时候登录页面就会出现添加的飞书登录的登录按钮，或者直接在飞书中点击应用图标

私有部署版本

私有部署版本直接访问应用 URL 即可展示登陆按钮，或者直接在飞书点击应用图标