钉钉（企业内部应用）

平台集成钉钉后可以实现：钉钉单点登录、组织信息同步、钉钉API调用，等诸多能力

1.创建自建应用

使用钉钉管理员账号，登录钉钉开放平台，并创建企业内部应用

特别说明

必须是钉钉管理员账号，普通账号不具备相关权限

创建完成示例

提示

图中红色标记处为：后续配置需要的相关凭据

1、自建应用agentId
2、自建应用key
3、自建应用秘钥

2.配置应用参数

自建应用创建完成后，就可以将相关参数配置到钉钉集成中

---

2.1 绑定自建应用

提示

登录系统组织管理/集成/钉钉，并点击点击绑定按钮，将创建自建应用获得的相关参数填到下方位置

2.2 绑定事件订阅

提示

事件订阅：当钉钉组织架构、成员信息等发生变化后，钉钉会自动将变更后的信息推送到平台

如果您不需要自动变更组织架构相关信息，则此步骤可以省略

将上方生成的加密 aes_key、签名 token，配置到下方位置

保存后，点击查看验证地址

并将地址配置到请求网址，然后点击保存

最后，配置需要订阅的事件

3.权限配置

需要配置相关权限后，才能获取到个人信息、部门信息等

具体需要启用的权限如下

注意

以下为推荐启用的权限，企业可以根据实际需要增加/减少权限

• 个人权限/个人手机号信息: 用于获取个人的手机号
• 个人权限/通讯录个人信息读权限: 用于获取个人的姓名、部门等信息
• 通讯录管理/所有权限: 通讯录的所有权限都需要启用，方便后续通讯录相关操作

4.安全配置

配置说明

• 服务器出口IP： 配置为服务器的公网IP
• 重定向URL（回调域名）： 直接将专属登录链接配置到此处即可

5.访问配置

添加应用能力：网页应用

配置应用地址，将专属登录链接配置到下方位置

6.发布应用

点击版本管理与发布，并创建新版本发布

发布完成后，钉钉工作台添加应用即可