跳转到主要内容
步骤 1:在 Teable 中创建认证提供商
- 进入 Teable 的 SSO 设置页面
- 创建新的认证提供商,命名为 OneLogin 并选择 OpenID Connect
步骤 2:访问 OneLogin 管理门户
- 登录你的 OneLogin Admin Portal
- 确保你拥有管理员权限
- 点击顶部菜单的 Applications
步骤 3:添加新应用程序
- 点击菜单中的 Applications → Applications
- 点击 Add App 按钮
- 在搜索框中搜索 OpenId Connect (OIDC)
- 从结果中选择 OpenId Connect (OIDC)
- 点击 Save
步骤 4:配置应用程序设置
显示信息
在 Configuration 选项卡中:
- Display Name(显示名称):Teable SSO
- Description(描述):(可选)Teable 的 SSO 集成
- Logo(徽标):(可选)上传 Teable 徽标
- 点击 Save
配置设置
进入 Configuration 选项卡并配置:
- Redirect URIs(重定向 URI):粘贴 Teable 中的回调 URL
- Login Url(登录 URL):(可选)
https://app.teable.io
- Application Type(应用程序类型):Web
- 点击 Save
步骤 5:获取客户端凭据
进入 SSO 选项卡:
- 找到 Client ID 字段并复制其值
- 找到 Client Secret 字段并复制其值(可能需要先点击 “Show”)
- 将这两个值粘贴到 Teable 的 SSO 配置中
警告:请妥善保管你的客户端密钥。如需要,你可以从此页面重新生成。
步骤 6:配置 OAuth 端点
在 SSO 选项卡中,你会找到你的 OneLogin 子域名。使用它在 Teable 中配置端点:
- Authorization URL(授权 URL):
https://{subdomain}.onelogin.com/oidc/2/auth
- Token URL(令牌 URL):
https://{subdomain}.onelogin.com/oidc/2/token
- User Info URL(用户信息 URL):
https://{subdomain}.onelogin.com/oidc/2/me
- Issuer(颁发者):
https://{subdomain}.onelogin.com/oidc/2
注意:请将 {subdomain} 替换为你的实际 OneLogin 子域名(例如:mycompany.onelogin.com)。你可以在 OneLogin 门户 URL 中找到它。
步骤 7:配置应用程序访问
分配角色
进入 Access 选项卡:
- Roles(角色):选择哪些角色应该有权访问此应用程序
- 你可以选择:
- 点击 Save
分配用户
进入 Users 选项卡:
- 点击 Add Users 或 Add Users by Role
- 选择应该通过 SSO 访问 Teable 的用户
- 点击 Continue 和 Save
步骤 8:配置参数(可选)
进入 Parameters 选项卡以映射用户属性:
- 点击 Add parameter 创建自定义声明
- 配置标准 OIDC 声明:
- email:用户电子邮件地址
- name:用户全名
- given_name:用户名字
- family_name:用户姓氏
- 将每个参数映射到相应的 OneLogin 用户字段
- 点击 Save
步骤 9:启用应用程序
- 确保所有配置已保存
- 应用程序现在应该已启用并对分配的用户可见
- 用户将在其 OneLogin 门户中看到 Teable 应用
步骤 10:测试 SSO 登录
你有三种方式启用 SSO 登录:
方式 1:直接使用认证 URL
- 直接使用授权 URL 作为你的 SSO 登录 URL
方式 2:OneLogin 门户
- 用户可以登录到其 OneLogin 门户并点击 Teable 应用程序图标
方式 3:域名验证
- 在 Teable 中配置域名验证
- 验证你的自定义域名
- 访问 https://app.teable.io
- 点击 SSO 登录按钮
- 输入已验证域名下的电子邮件地址以登录
其他配置(可选)
配置 MFA
- 在 OneLogin 管理门户中,进入 Security → Multi-Factor Authentication
- 为你的组织或特定用户启用 MFA 策略
- 配置 MFA 要求(例如:始终要求、新设备要求)
设置用户配置(SCIM)
如果要自动从 OneLogin 配置用户到 Teable:
- 在你的 Teable 应用程序中进入 Provisioning 选项卡
- 启用配置
- 配置 SCIM 端点(如果 Teable 支持 SCIM)
- 映射用户属性
- 启用用户创建、更新和删除
配置会话持续时间
- 在 OneLogin 中进入 Settings → Sessions
- 配置会话超时设置
- 设置空闲超时和最大会话持续时间
自定义品牌
- 在 OneLogin 中进入 Customization → Portal
- 自定义 OneLogin 门户外观
- 添加你的公司徽标、颜色和自定义 CSS
- 这会影响用户登录 OneLogin 时看到的内容