独享版的用户如果创建钉钉集成模式版的账号,需要先创建企业,然后进行钉钉绑定。
创建企业时,需要填写以下信息:
登录 钉钉开放平台,在钉钉开放平台中新建一个自建应用,这一步是为了获取后文需要配置的自建应用 ID、自建应用 secret 等参数。
登录后先获取需要绑定的企业的 CorpId 进行备份,如下图所示:
接下来,在首页处新建一个企业应用,如下图所示:
在弹出的页面中选择「H5微应用」,然后填写自建应用基本资料,如下图所示:
然后将应用信息中 AgentId、AppKey 和 AppSecret 复制备份,用于后文【4.1步骤】的参数填写:
通过以上步骤可以获取 CorpId、AgentId、AppSecret、AppKey。
创建企业后,找到刚刚创建的企业,点击企业详情。在企业详情中,切换到「钉钉集成」,配置「企业ID」、「自建应用ID」、「自建应用secret」、「钉钉CP app_key」,其他参数暂时获取不到,先不填写。填写完毕后点击提交:
钉钉企业ID | 对应【3.1节】中的钉钉 CorpId |
自建应用AgentId | 对应【3.3节】中的自建应用 AgentId |
自建应用appKey | 对应【3.3节】中的自建应用 AppKey |
自建应用secret | 对应【3.3节】中的自建应用 AppSecret |
提交修改信息后,可以看到该企业已切换为钉钉集成模式。
进入【3.节】创建的钉钉企业自建应用中,在「事件与回调」模块中,点击重置按钮生成加密 aes_key 和 签名 token,如下图所示:
注:重置后请勿关闭此页面,后续还需返回此页面操作。
新开一个浏览器标签,登录独享版控制台,将生成的 token 和 aes_key 复制后分别回填至企业信息处的「消息编码token」和「消息编码aes_key」处,回填后点击「提交」。如下图所示:
再回到刚刚自建应用处配置回调地址。回调地址的组成为:
https://private.yourdoamin.com/dingtalk/corp/{CorpId}/service
上述 URL 中 dingtalk 前面的内容直接替换为「独享版控制台 >> 基础信息」处的访问地址:
URL 中 的 {CorpId} 直接替换为上文【3.节】绑定了自建应用的钉钉账号的 CorpId。
替换为属于自己企业的回调地址后,将该地址配置到刚刚重置 token 和 aes_key 页面中的回调地址处,如下图所示:
配置好以后点击保存。
这一步是为了将独享版的账号登录地址接入到需要绑定的钉钉账号中。将企业信息中的访问地址配置到如下如所示的回调域名处:
在开发管理处分别配置以下地址:
地址类型 | URL路径 |
应用首页地址 | https://private.yourdoamin.com/dingtalk/corp/{corpId}/dashboard |
PC端首页地址 | https://private.yourdoamin.com/dingtalk/corp/{corpId}/pc_auth |
管理后台地址 | https://private.yourdoamin.com/dingtalk/corp/{corpId}/admin/auth |
注:URL替换方式同【4.2.3节】中回调地址的配置,此处不在赘述。
配置好的地址效果如下图所示:
在权限管理处设置需要的权限,如通讯录权限,设置后可以同步钉钉企业中的部门成员信息至绑定的简道云企业。如下图所示:
在部署与发布的版本管理与发布中对应用进行发布:
独享版企业控制台处输入管理员用户名和密码,即可以创建者身份登录进绑定的企业,如下图所示:
登录后,在通讯录中可以同步钉钉账户中的部门成员。
1)进入通讯录
2)同步成员
在内部组织中点击「立即同步」即可将钉钉组织架构中的部门成员同步至独享版企业中。如下图所示:
除创建者身份以外的其他成员(包括管理员)登录简道云时,可以通过企业账号 URL 进行登录。如下图所示:
还可以直接在钉钉客户端中登录简道云: