Casdoor集成市场

Moka People 员工同步 | 提供商

从 Moka People 同步员工和部门

用 Moka People 的员工任职数据接口和组织部门数据接口,把在职、离职员工和启用的部门同步进 Casdoor,可以定时重跑。离职员工同步为禁用。

Casdoor 官方核验企业版Moka人事同步群组同步
你需要一个正在运行的 Casdoor,自己部署或用 Casdoor 云都可以。示例中的 https://auth.example.com 请换成你的 Casdoor 地址(Casdoor 云上类似 https://acme.casdoor.com),其他 example.com 地址也换成你自己的。

用 Casdoor 配置 Moka People 员工同步

  1. 1

    准备接口凭据

    向 Moka 的客户成功经理要租户的 entCode、接口的 apiKey 和签名用的 RSA 私钥(一行 Base64 的 PKCS#8,或者 PEM 都可以)。

  2. 2

    建两个对外接口

    在 Moka People 的 设置 → 对外接口设置 里建两个接口:数据源选 员工任职信息 的一个、选 组织部门 的一个,分别复制它们的 接口编码(apiCode)。再选一个超级管理员的公司邮箱,员工接口要用它的身份调用。

  3. 3

    安装插件

    在 Casdoor 组织的“集成市场”里安装 Moka People 员工同步,需要企业版许可证。

  4. 4

    新建同步器

    在“同步器”里新建一个,类型选 Plugin,“动作”选刚装的插件,按下表填写,保存后点“同步”。插件会一并导入部门树,用户按所在部门归入对应的群组。私钥和两个接口编码填在元数据里,是一段 JSON。

    主机留空(固定调用 https://api.mokahr.com)
    用户entCode
    密码apiKey
    元数据{"privateKey": "<RSA 私钥>", "employeeApiCode": "<员工任职信息的接口编码>", "departmentApiCode": "<组织部门的接口编码>", "userName": "<超级管理员的公司邮箱>"}

注意事项

  • Moka People 每个租户每秒最多查 3 次、每分钟 60 次,插件每页取 200 条、两次请求间隔 0.4 秒,人很多时第一次同步要多等一会儿。
  • 待入职的员工不在员工任职数据接口里,不会同步。
  • 用户名用工号,没有工号时用 Moka 的员工 uuid;邮箱优先用公司邮箱,没有时用个人邮箱。
  • 只同步启用的部门,上级部门已停用的部门当作顶级部门。

Moka People 员工同步 的设置取自它的官方文档(核对于 2026年11月:Moka People 开放 API 文档(员工任职数据接口、组织部门数据接口、签名规则)、Moka People 帮助中心:鉴权认证、Moka People 帮助中心:签名规则)。Moka People 员工同步 是其所有者的商标。