钉钉集成

注意:

  • 钉钉对接要求可道云必须有公网IP或者公网域名地址。
  • 可道云服务器时间需与标准时间一致,否则登录可能出现”签名时间戳参数超时“的报错提示。

Kod的钉钉插件,是结合钉钉中的自建应用(免密登录),来实现钉钉通讯录信息同步网页扫码登录ding_desktop

钉钉集成功能概述

  1. 用户数据集成:钉钉用户集成同步到可道云。
  2. 部门数据集成:钉钉部门集成同步到可道云。
  3. 用户实时同步:在钉钉后台新增、修改、删除用户, 数据自动实时同步到可道云。
  4. 部门实时同步:在钉钉后新增、修改、删除部门, 数据自动实时同步到可道云。
  5. 钉钉APP中单点登录:在钉钉中打开可道云应用,能自动识别当前登录的用户并自动登录对应账号。
  6. 钉钉扫码登录可道云:电脑/浏览器端访问可道云地址, 通过钉钉扫码可以实现自动登录。

ding_des

对接流程

1. 插件中心安装插件

管理员登录;插件中心,安装『钉钉同步』插件。 在钉钉插件配置界面,需填写如下6个参数,以完成配置:

  1. 企业应用CorpId
  2. H5微应用AgentId
  3. H5微应用AppKey
  4. H5微应用AppSecret
  5. 扫码登录AppId
  6. 扫码登录AppSecret

ding_server

通过后续步骤,可获取到相关参数。

2. 企业应用CorpId

如尚未注册钉钉,请前往 注册

登录钉钉后台,导航栏【工作台】,点击自建应用,进入新页面。在新页面右上方可获取到企业应用CorpId [1] ding_corpId

3. H5微应用

注意:

  • 服务器出口IP是钉钉方面限制的白名单, 如果有变更, 请及时修改, 否则将无法使用钉钉登录。
  1. 点击【创建应用】:
    • 应用类型:H5微应用
    • 开发方式:企业自主开发 ding_creat
  2. 创建完成后,进入应用详情页:
    • 应用信息:可获取到微应用AgentId [2]、微应用AppKey [3]、微应用AppSecret [4]ding_app
  3. 进入开发管理页, 修改:
    • 开发模式:开发应用
    • 服务器出口IP:KOD服务器外网IP;
    • 其余3项地址:填写[kod地址], 如 https://kod.kodcloud.com ding_dev
  4. 进入权限管理页, 修改:
    • 权限范围:全部员工。如需排除部门或用户,可在钉钉插件配置中进行
    • 接口权限-通讯录管理:全部申请开通。 ding_priv
  5. 应用发布
    • 部署与发布-版本管理与发布,点击【确认发布】。 ding_rele
    • 发布后,用户可以在钉钉【工作台】看到该应用。 ding_panel

4. 扫码登录

进入旧版工作台 ding_old

导航栏【应用开发】,选择 移动应用接入,创建扫码登录应用授权。

  • 授权LOGO地址[kod地址]/static/images/icon/fav.png, 或者使用其他图片地址
  • 回调域名[kod地址],如 https://kod.kodcloud.com/ ding_saoma

  • 创建后,可获取扫码登录AppId [5], 扫码登录AppSecret [6]
  • 在配置到插件后, 可以在浏览器使用钉钉扫码登录可道云 ding_login

5. 同步方式

可道云提供了两种同步钉钉通讯录的方案:实时推送、定时拉取。

  • 实时推送:填写 回调校验aesKey (长度固定43位的随机字符串),点击【注册回调地址】按钮进行回调注册。 注册成功后,如果钉钉通讯录的数据发生变动,会实时推送到kod系统,kod接收数据后进行更新。

提示:

  • 此方式只有在钉钉通讯录发生变化时才进行推送(且只推送有变化的部分),因此在完成插件配置后,需在【同步设置】页点击【手动同步用户数据】,进行一次数据初始化同步。
  • 定时拉取:kod系统通过钉钉提供的接口,定时拉取(时间推荐默认填写的240分钟,数据量较大时适当增大)通讯录数据进行更新。

提示:

此方式为定时全量拉取企业微信通讯录数据,进行覆盖更新。可能存在同步不及时,增加服务器压力的情况。

6. 配置插件

将如上参数配置到kod钉钉插件配置中,点击[应用]进行保存——如选择同步方式为【实时推送】,保存前需先注册回调地址。

名词解释:

  • 是否同步组织架构:如选择关闭,将不同步部门,只同步用户账号(部门归属默认为根部门)。
  • 允许账号昵称重复:在钉钉通讯录中,可能存在用户昵称(姓名)相同的情况,如关闭该项,同名账号将无法同步。
  • 允许账号自动绑定:默认关闭, 如果打算使用已有账号和钉钉账号合并, 请设置绑定唯一字段 手机号/邮箱, kod用户手机号或邮箱 和钉钉用户一致时则不会再创建新账号。
  • 用户所属部门权限:用户在归属的所有部门中,都设置为这个文档权限。
  • 用户在根部门权限:(点击更多展开设置) 用户在根部门(企业网盘)中的文档权限。
  • 用户存储空间大小:用户个人空间分配大小。
  • 部门存储空间大小:每个部门的共享空间大小。
  • 用户默认权限角色:用户个人角色权限。 ding_sync
  • 失效数据处理:此处的失效数据,主要是指已同步到kodbox系统,但在钉钉通讯录中被删除了的部门和用户。 如选择开启,同步时失效数据将被直接禁用;如选择关闭,则只对失效数据做标记,而不直接禁用,管理员可在后台【用户与部门管理】-【待处理账号】选择管理; 另,如同步方式为定时拉取,可能出现因网络或接口不稳定导致部分拉取结果为空的情况,这部分结果将被当做失效数据处理,因此建议选择关闭。
  • 同步指定排除:不需要同步的部门/用户,按名称进行排除,多个时以”,”分隔。 关于排除指定部门,如待同步用户的归属部门都在排除指定范围内,则该用户也不会被同步。 ding_others
插件安装, 钉钉, H5应用