集成钉钉

1.集成能力

通过自建应用集成钉钉后，支持：

功能名称	功能说明
用户目录同步	同步钉钉组织架构至ONES，实现统一账号管理
登录验证	通过钉钉登录到ONES，实现安全快捷地单点登录
消息通知	ONES消息通知到钉钉，并点击查看详情页面

2.功能入口

管理员可在【配置中心】页面，点击「添加账号集成」并选择「钉钉」进行添加集成配置。

3.添加集成流程

3.1新建钉钉应用

打开系统的钉钉配置页面，同时进入钉钉开发者后台，点击「应用开发」>「创建应用」，应用名称等信息可按需自行填写。

3.2创建后，选择网页应用进入

3.3配置应用首页与回调地址

• 配置应用首页地址与PC端首页地址
  1. 打开钉钉应用的「网页应用」
  2. 将系统后台的「应用首页地址」，复制至钉钉应用的「应用首页地址」和「PC端首页地址」中，保存生效

• 配置安全设置
  1. 打开钉钉应用的「安全设置」
  2. 将系统后台的「授权回调域」，复制至钉钉应用的「重定向URL（回调域名）」中，保存生效

3.4配置应用权限

进入「权限管理」，申请获取以下权限：

通讯录个人信息读权限

调用SNS API时需要具备的基本权限

邮箱等个人信息

成员信息读权限

企业员工手机号信息

通讯录部门信息读权限

通讯录部门成员读权限

企业已安装的应用列表查询权限

3.5发布应用版本

进入「版本管理与发布」，创建新版本，按需配置应用可见范围，保存并发布应用

3.6将发布后的应用凭证信息复制粘贴至系统中

3.7用户属性映射

目前系统支持同步的字段包含：用户名、邮箱、工号、公司、职位，对应钉钉用户属性值见：用户信息

注意确认企业分辨当前在钉钉中使用的是「员工邮箱：email」还是「企业邮箱：org_email」，并填入「钉钉用户属性-邮箱」

3.8点击添加，可开启集成相关功能

4.使用集成

4.1开启「用户目录同步」与「登录验证」后

4.1.1ONES获取邮箱，根据邮箱进行「新成员账号自动创建」或「现有成员账号自动绑定」

• 当该邮箱在组织中无匹配邮箱，将进行「新成员账号自动创建」

• 当该邮箱在组织中有匹配邮箱，将进行「现有成员账号自动绑定」

4.1.2「成员管理」页面：将出现「已激活成员」并归属对应「钉钉组织架构树中」

4.1.3成员首次登录

不管首次登录发生在「4.1.3中的任意登录路径」（下图以浏览器访问登录链接为例）

• 进行「现有成员账号自动绑定」的账号，成员可直接登入系统

• 进行「新成员账号自动创建」的账号，成员需完成「验证邮箱」后，才可登入系统

4.1.4登录路径

成员可通过以下路径进行钉钉登录：

• 浏览器访问登录链接（登录链接可在集成页面复制）

• 浏览器访问组织中的工作项或wiki链接

• 钉钉PC客户端应用访问「消息通知」或「应用主页」

• 钉钉移动客户端应用访问「消息通知」或「应用主页」

4.2开启消息通知后

开启钉钉消息通知后，还需要在对应ONES Project和ONES Wiki业务中勾选对应的通知方式，详见消息通知