Lark同步器
Lark 同步器会将您 Lark(飞书)组织中的用户导入 Casdoor。 它以应用身份进行认证,递归遍历部门树,并提取每位成员的个人资料。
先决条件
在【Lark 开放平台】创建一个 Lark 应用程序。https://open.feishu.cn/). 该应用需要以下权限:
contact:user.base:readonly— 读取用户基本信息contact:department.base:readonly— 读取部门结构
将应用发布到您的组织后,从应用的凭据页面复制应用ID和应用密钥。
配置
在Casdoor中创建一个新的同步器(同步器 → 添加),并填写:
| 字段 | 值 |
|---|---|
| Organization | 目标 Casdoor 组织 |
| Name | 此同步器的唯一名称 |
| Type | Lark |
| Client ID | 您的Lark应用ID |
| Client Secret | 您的Lark应用密钥 |
与数据库相关的字段(数据库类型、端口、表名等) 不用于Lark同步器,可留空。
字段映射
| 字段 | Casdoor 字段 | 备注 |
|---|---|---|
user_id | Id | 稳定的 内部用户 ID |
name | DisplayName | 用户显示名称 |
email | Email | 主要电子邮件 |
mobile | Phone | 手机号码 |
avatar.avatar_origin | Avatar | 原尺寸头像URL |
job_title | Title | 职位名称 |
gender | Gender | 1 = 男,2 = 女 |
OAuth登录绑定
当用户从Lark同步时,其Lark user_id 会存储在Casdoor用户的lark字段中。 已同步的用户可通过Lark OAuth提供商登录,无需单独进行账号绑定步骤。
运行同步器
点击测试连接以在启用前验证您的应用ID和密钥。 切换已启用以进行计划同步,或点击同步立即运行。
同步器从根节点开始获取完整的部门树,对属于多个部门的用户进行去重,并自动处理分页。