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_id | Id | 稳定的内部用户 ID |
name | DisplayName | 用户显示名称 |
邮箱 | 邮箱 | 主要电子邮件 |
移动端 | 电话 | 手机号码 |
avatar.avatar_origin | 头像 | 原尺寸头像URL |
job_title | 职称 | 职位名称 |
性别 | 性别 | 1 = 男,2 = 女 |
OAuth登录绑定
当用户从Lark同步时,其Lark user_id 会存储在Casdoor用户的lark字段中。已同步的用户可通过Lark OAuth提供商登录,无需单独进行账号绑定步骤。
运行同步器
点击测试连接以在启用前验证您的应用ID和密钥。切换已启用以进行计划同步,或点击同步立即运行。
同步器从根节点开始获取完整的部门树,对属于多个部门的用户进行去重,并自动处理分页。