飞书配置

飞书登录配置指南

1. 申请应用

  1. 访问飞书开放平台并登录： https://open.feishu.cn/

  2. 进入 开发者后台，选择 创建企业自建应用 创建企业自建应用

  3. 填写应用信息并获取相关参数 应用信息

  4. 安全设置：填写回调域名（重定向 URL）

    域名/authLogin/lark

    参考示例：https://x.tduckcloud.com/authLogin/lark 安全设置示例

  5. 配置完成后点击 发布版本，选择可用范围（可选择“全部”） 发布版本

  6. 发布后需要管理员审核，具体操作请参考官方文档： 飞书自建应用审核指南

  7. 发布成功后，将应用凭证配置到系统 【管理后台】-【系统管理】-【系统配置】-【三方登录】 应用凭证配置

图片

2. 同步部门与用户信息（二选 1）

定时同步（可选）

  • 若需定时将飞书部门和用户同步到系统，可执行以下 SQL（每 10 分钟同步一次）：

下载 SQL 文件

  • 执行后重启系统生效。

飞书主动推送同步（可选）

图片

获取参数配置到系统管理里面

图片

配置事件，将事件发送到开发者服务器。请求地址填你的域名+/tduck-api/authLogin/lark/callback

如https://dev.tduckcloud.com/tduck-api/authLogin/lark/callback

然后需要把相关的事件添加进去

图片

通讯录的事件都给他勾选上

2.1 权限配置

  1. 在飞书开发后台 权限管理 中勾选所需权限：
    • 左侧选择 通讯录
    • 勾选与通讯录相关的权限
  2. 开通权限后必须 重新发布应用 才生效 权限管理示例

3. 消息推送配置

若需使用飞书消息推送，需要开通消息权限：

  • im:message:send
  • im:message
  • im:message:send_as_bot
  1. 添加机器人能力，使机器人可发送消息 机器人能力
  2. 开通权限后必须 重新发布应用 才生效 消息权限示例

✅ 完成以上步骤后，即可在系统中启用飞书登录、部门用户同步及消息推送功能。