跳到主内容

Lark同步器

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

先决条件

在【Lark 开放平台】创建一个 Lark 应用程序。https://open.feishu.cn/). 该应用需要以下权限:

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

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

配置

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

字段
Organization目标 Casdoor 组织
Name此同步器的唯一名称
TypeLark
Client ID您的Lark应用ID
Client Secret您的Lark应用密钥

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

字段映射

字段Casdoor 字段备注
user_idId稳定的内部用户 ID
nameDisplayName用户显示名称
emailEmail主要电子邮件
mobilePhone手机号码
avatar.avatar_originAvatar原尺寸头像URL
job_titleTitle职位名称
genderGender1 = 男,2 = 女

OAuth登录绑定

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

运行同步器

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

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