跳到主内容

Lark同步器

Lark 同步器会将您 Lark(飞书)组织中的用户导入 Casdoor。它以应用身份进行认证,递归遍历部门树,并提取每位成员的个人资料。

先决条件​

在 飞书开放平台 创建一个 Lark 应用。该应用需要以下权限:

  • contact:user.base:readonly — 读取用户基本信息
  • contact:department.base:readonly — 读取部门结构

将应用发布到您的组织后,从应用的凭据页面复制应用ID和应用密钥。

配置​

在Casdoor中创建一个新的同步器(同步器 → 添加),并填写:

字段值
选择组织目标 Casdoor 组织
名称此同步器的唯一名称
类型Lark
Client ID您的Lark应用ID
客户端密钥您的Lark应用密钥

与数据库相关的字段(数据库类型、端口、表名等)不用于Lark同步器,可留空。

字段映射​

字段Casdoor 字段备注
user_idId稳定的内部用户 ID
nameDisplayName用户显示名称
邮箱邮箱主要电子邮件
移动端电话手机号码
avatar.avatar_origin头像原尺寸头像URL
job_title职称职位名称
性别性别1 = 男,2 = 女

OAuth登录绑定​

当用户从Lark同步时,其Lark user_id 会存储在Casdoor用户的lark字段中。已同步的用户可通过Lark OAuth提供商登录,无需单独进行账号绑定步骤。

运行同步器​

点击测试连接以在启用前验证您的应用ID和密钥。切换已启用以进行计划同步,或点击同步立即运行。

同步器从根节点开始获取完整的部门树,对属于多个部门的用户进行去重,并自动处理分页。