钉钉集成说明

优米云盘的钉钉集成可以与钉钉共享同一账号及组织架构体系，可以用钉钉直接扫码登录云盘。同时，优米云盘也可以直接集成进钉钉的PC端及手机端工作台。

一、钉钉后台配置

要集成钉钉，首先要在钉钉开发者后台创建应用，方式如下：

首先登录钉钉开发者后台：https://open-dev.dingtalk.com ，选择应用开发，创建应用，应用类型选择H5微应用，开发方式选择企业自主开发，这样应用就创建成功了。

1、获取参数

应用创建后，便可以获得AppKey、AppSecret这两个参数，还有一个CorpId参数，可以直接在https://open-dev.dingtalk.com页面的右上角查看到，记住这三个参数，需要在优米云盘后台填写。

2、开通权限

我们需要对刚创建的应用做权限设置，在开发后台打开应用，选择权限管理，找到：

通讯录个人信息读权限

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

邮箱等个人信息

通讯录部门信息读权限

成员信息读权限

通讯录部门成员读权限

调用企业API基础权限

这些权限在“个人权限”与“通讯录管理”两大分类里，需要把它们全部开通

3、服务器地址设置

在开发后台应用管理界面，选择开发管理，需要填写服务器出口IP、应用首页地址、PC端首页地址

服务器出口IP是指优米云盘所在服务器的IP地址，这里要填写外网地址，即在公网能访问到的服务器IP地址。

应用首页地址是指在手机端钉钉工作台上显示的优米云盘手机端的地址，格式如下：

http://test.yomicloud.com:188/dingding/mobile

其中test.yomicloud.com:188是优米云盘的首页地址，它可以是域名或IP

PC端首页地址是PC端工作台上显示的优米云盘的地址，格式如下：

http://test.yomicloud.com:188/dingding/pc

4、发布应用

一切准备好之后，就可以发布应用，刚开始可以只发布给部分员工，后面可以发布给全体员工。发布在开发者后台的“部署与发布”下的“版本管理与发布”页面。在发布之前还需要先在优米云盘后台配置参数。

二、优米云盘后台配置

登录优米云盘后台，在“钉钉集成”页面配置钉钉集成相关的参数。

第一部分是基本的参数配置，开启钉钉集成后，填写CorpId、AppKey、AppSecret参数，并按说明选择是否自动添加账号、是否按工号自动创建关联，是否同步邮箱。

第二部分是账号关联，这部分的作用是把云盘里的账号与钉钉的账号关联起来，这样便可以直接使用钉钉的账号登录云盘。关联的方式是填写每个云盘账号对应的钉钉userId，为了方便获取钉钉用户的userId，可以在直接下载钉钉用户信息（钉钉集成的基本参数必须设置完成才可下载），然后根据里面的信息填写钉钉UserId即可，也可以按姓名匹配，钉钉与云盘使用同一个姓名，并且尚未建立关联的会进行匹配。

账号关联还有一个按工号匹配模式，如果在钉钉后台给员工设置了工号，工号与优米云盘的登录号一致并且当前账号尚未建立关联，就自动创建关联，如果该工号在云盘不存在，则会自动在云盘创建账号（这两项功能需要在第一部分的参数配置中开启）。