You need to enable JavaScript to run this app.
文档中心
AI 原生 BaaS 平台 Supabase 版

AI 原生 BaaS 平台 Supabase 版

复制全文
下载 pdf
使用 Authentication
设置飞书授权登录
复制全文
下载 pdf
设置飞书授权登录
本文介绍如何在 AI 原生 BaaS 平台 Supabase 版中配置飞书授权登录。​
前提条件​
  • 已创建使用 Supabase 引擎的 Workspace,且 Workspace 状态为运行中。关于创建 Workspace 的详细信息,请参见创建 Workspace。​
  • 已登录目标 Workspace 的 Supabase 控制台。关于登录控制台的详细信息,请参见登录 Supabase 控制台。​
  • 已在飞书开放平台创建企业自建应用,并获取应用的 App ID 和 App Secret。​
  • 已根据业务需要为飞书应用配置可用范围,并完成应用发布。​
注意事项​
  • App Secret 属于敏感凭证,请妥善保管,不要在客户端代码、公开仓库或日志中暴露。​
  • Supabase 控制台生成的 OAuth Callback URL 必须完整、准确地配置到飞书应用的安全设置中。协议、域名、路径或端口不一致都会导致回调失败。​
  • 如果关闭 Allow users without an enterprise email,仅拥有企业邮箱的飞书用户可以登录。启用该开关后,没有企业邮箱的飞书用户也可以完成登录。​
通过控制台设置飞书 APP 认证​
步骤一:获取 OAuth 回调地址​
  1. 登录 Supabase 控制台。​
  1. 在左侧导航栏选择 Authentication > Sign In / Providers。​
  1. 在 Auth Providers 列表中找到飞书(Feishu),并打开配置页面。​
  1. 复制 Callback URL (for OAuth) 字段中的地址。该字段为只读,系统会根据当前 Workspace 自动生成回调地址。​
步骤二:配置飞书应用​
  1. 登录飞书开放平台,进入需要用于登录的企业自建应用。​
  1. 在应用的安全设置中,将步骤一获取的 Callback URL 配置为 OAuth 重定向 URL。​
  1. 确认应用已申请登录所需的用户身份信息权限,并按飞书开放平台要求发布应用。​
  1. 在应用凭证页面复制 App ID 和 App Secret。​
步骤三:启用飞书 Provider​
  1. 返回 Supabase 控制台的飞书 Provider 配置页面。​
  1. 打开 Enable Feishu provider 开关。​
  1. 填写以下配置项后,单击 Save 保存配置。​
​
配置项​
说明​
Feishu App ID​
飞书开放平台中企业自建应用的 App ID。​
Feishu App Secret​
飞书开放平台中企业自建应用的 App Secret。​
Allow users without an enterprise email​
是否允许没有企业邮箱的飞书用户登录。请根据应用的账号准入策略设置。​
Callback URL (for OAuth)​
​
OAuth 回调地址。该字段默认由系统生成,也支持手动修改,需注册到飞书应用的安全设置中。​
说明​
若内网环境中的应用无法直接连接到 Supabase,可参考配置重定向 URL,将该字段配置为开发者域名下的服务 Callback 接口作为中转地址,并由该接口重定向到 Supabase Auth Callback 接口。​
​
通过 Admin API 设置飞书 APP 认证​
查询配置​
​
curl -X GET "$SUPABASE_BASE_URL/auth/v1/config" \​
-H "apikey: ${SERVICE_ROLE_KEY}" \​
-H "Authorization: Bearer ${SERVICE_ROLE_KEY}" \​
-H "Content-Type: application/json"​
​
修改配置​
​
curl -X PATCH "$SUPABASE_BASE_URL/auth/v1/config" \​
-H "apikey: ${SERVICE_ROLE_KEY}" \​
-H "Authorization: Bearer ${SERVICE_ROLE_KEY}" \​
-H "Content-Type: application/json" \​
-d '{​
"EXTERNAL_FEISHU_ENABLED": true,​
"EXTERNAL_FEISHU_CLIENT_ID": "cli_xxxxxxxxxxxxxxxx",​
"EXTERNAL_FEISHU_SECRET": "xxxxxxxxxxxxxxxx",​
"EXTERNAL_FEISHU_REDIRECT_URI": "https://br-xxxx.supabase.aidap-global.cn-beijing.volces.com/auth/v1/callback",​
"EXTERNAL_FEISHU_EMAIL_OPTIONAL": true,​
"URI_ALLOW_LIST": "http://www.app1.com/home,https://www.app2.com"​
}'​
​
验证配置​
  1. 从网页发起飞书授权登录。​
  1. 在飞书授权页面完成登录和授权。​
  1. 确认页面能够返回应用,且 Supabase Authentication 的 Users 列表中已生成对应用户。​
常见问题​
回调地址不匹配​
如果登录后提示回调地址不合法或 redirect_uri 不匹配,请确认飞书应用安全设置中的重定向 URL 与 Supabase 控制台显示的 Callback URL 完全一致。​
无企业邮箱的用户无法登录​
检查 Allow users without an enterprise email 开关。如果业务允许无企业邮箱用户登录,请启用该开关并重新保存配置。​
应用未开放给目标用户​
检查飞书应用的可用范围和发布状态,确认目标用户已被纳入应用可用范围。​
最近更新时间:2026.10.20 21:01:23
这个页面对您有帮助吗?
有用
有用
无用
无用