私有部署版
配置管理
配置钉钉

一、私有部署版钉钉服务功能简介

通过绑定钉钉、您可获得以下特性:

(1)钉钉消息推送:在行云管家内产生的各种消息可以推送到您的手机;

(2)Mobile版本支持:可通过“钉钉APP”--“工作台”--“其他应用”里的应用图标来访问手机版本的行云管家;

(3)支持通过钉钉进行登录门户的二次认证以及主机双因子认证等;

(4)支持通过钉钉扫描二维码登录门户;

二、配置钉钉前置条件

2.1、必要项:

行云管家私有部署版本开通钉钉功能,必须满足以下先决条件:

(1)钉钉后台管理员,可以进入钉钉后台管理系统;

(2)行云管家门户服务器必须要能访问外网,能连通钉钉地址https://oapi.dingtalk.com

2.2、选要项(扫码登录功能):

如果想通过钉钉扫描二维码来直接登录门户的功能,则需要满足以下条件,如果不需要该功能,可以忽略:

(1)准备一个“域名”用于浏览器访问行云管家,并且该域名必须已有ICP备案(ICP服务热线:010-66411166);

(2)如果您用的是HTTPS协议,那么在上述域名的基础上,准备二级域名的域名证书(建议下载nginx格式证书);

(3)在DNS服务器中配置上述域名指向行云管家服务器IP地址;

三、配置钉钉:钉钉端

(1)登录钉钉官网并点击“企业登录”,通过钉钉管理员账号登录钉钉后台管理系统;

(2)点击“工作台”菜单;

(3)点击“自建应用”里的“+自建应用”;

(4)此时进入到“应用开发”菜单页面,点击左边栏“企业内部开发”下的“H5微应用”,点击“创建应用”;

(5)如图填写“创建应用”的各项内容,其中“应用Logo”请上传您需要显示在“钉钉”里的图标(也就是“钉钉APP”--“工作台”--“其他应用”里到时候显示出来的图标),填写和选择后点击“下一步”;

(6)继续如图选择并填写各项信息,然后点击“创建”;

“应用首页链接”为“钉钉”里应用(“钉钉APP”--“工作台”--“其他应用”)打开后的显示的首页链接:

a)如果您没有域名(不用扫码登录功能),请填写行云管家门户服务器外网IP地址后面加上/mobile/login.html(没有外网IP的话可以随意填写),例如

http://66.66.66.66/mobile/login.html

b)如果您有域名(需要扫码登录功能),请填写行云管家域名网址后面加上/mobile/login.html,例如

http://m.abc.com/mobile/login.html

“服务器出口IP”为您行云管家服务器的出口IP,一般可以去服务器里输入以下命令进行查询

curl icanhazip.com或wget http://ipecho.net/plain -O - -q ; echo

(7)点击如图“基础信息”菜单下的“应用发布”的“查看详情”;

(8)在“应用发布”菜单下“应用发布”里点击“确认发布”(发布后,该应用将会出现在“钉钉APP”--“工作台”--“其他应用”里,企业组织内部的用户将会看到该应用);

(9)如图,选择范围设置,选择“全部员工”即可,点击“保存修改”;

(10)如图,点击“接口权限”菜单,在“高级权限-企业通讯录”下、对“通讯录只读权限”以及“手机号获取userid”,点击“申请”;

(11)申请后显示为如图示;

(12)点击如图“基础信息”--“应用信息”里的“查看详情”;

(13)记录下“AgentId”、“AppKey”、“AppSecret”;

(14)点击“基本信息”--“开发信息(旧版)”,记录下“CorpId”;

(15)在(14)里还可以点击“基本信息”--“开发体验账号管理”--“体检组织”--“设置体检组织”,这样也可以看到并记录下“CorpId”;

到这里钉钉端的必要项就已经配置完成了,如果想使用通过钉钉扫码登录行云管家门户网页功能(需完成钉钉前置条件里的选要项才能继续这一步),请继续操作步骤(16)、(17),如果不需要,请直接跳过步骤(16)、(17);

(16)点击“应用开发”->左边栏“移动接入应用”->“登录”,并点击“创建扫码登录应用授权”进行填写,填写完成后点击“确定”;

“授权LOGO地址”:请填写您LOGO图标对应的域名地址,例如:

https://www.abc.cn/assets/image/logo-highlight@92@4x-efd6638d61e036b2e3eb535ec511b82c.png

“回调域名”:请把如下链接的“带http或https的域名链接”改为您行云管家的域名;

http或https的域名链接/api/oauth/dingtalk_callback

例如,图中的“回调域名”是http://www.abc.cn/api/oauth/dingtalk_callback

(17)确认后,记录下“appId”、“appSecret”、“回调域名”(就是后面要用到的“RedirectUri”);

四、配置钉钉:管理控制台

4.1、必须配置项:

从上述钉钉端获取到的信息,逐一进行填写,包括“CorpId”、“AgentId”、“AppKey”、“AppSecret”,这几项为必填项;

图中其他三项“AppId”、“AppSecret”、“RedirectUri”为选填项,具体请参考下述操作(实现通过钉钉扫码登录行云管家功能);

4.2、选择配置项:

如果希望通过钉钉扫码登录行云管家门户网页,需要为行云管家配置公网域名并填写“AppId”、“AppSecret”、“RedirectUri”,具体操作如下:

(1)请登录进入行云管家管理控制台;

(2)并点击“系统设置”菜单,进入“基本配置”页面,点击“配置访问协议”;

(3)请根据需要配置HTTP协议或HTTPS协议后点“确定”即可;

如果需要配置为HTTPS访问,则勾选“HTTPS协议”,并指定用于nginx的“SSL证书”及“SSL证书密钥”(SSL证书密钥要求无密码,如果是有密码的密钥,可以执行“openssl rsa -in [有密码.key] -out [无密码.key] ”来获取无密码密钥),此时“HTTPS端口”建议为443;

(4)在“配置访问方式”台中添加域名访问,如果是HTTPS协议,请选择对应的CA证书(注意:域名是填www.abc.com这种格式而不是http://www.abc.com):

(5)输入域名,如果是HTTPS协议,请选择对应的CA证书,并点击“确认”;

(6)点击管理控制台“基本配置”页面的“第三方应用支持”的“配置”按钮;

(7)选择“钉钉”进入到钉钉配置页面

(8)从上述获取到的信息,逐一进行填写,其中“RedirectUri”请填写上面记录的“回调域名”,点击“下一步”既完成钉钉的配置及绑定;

五、行云管家用户绑定钉钉

如图,登录行云管家点击右上角用户头像下的“个人资料”;

5.1、用户绑定方式(无扫码登录功能):

找到如图“账号绑定”下的“钉钉”(如果没有在管理控制台配置钉钉服务,那么在这里是看不到钉钉的绑定的),点击立即绑定,此时会出来两个步骤;

步骤一:请输入您钉钉关联的手机号,并提交信息,此时打开您手机号关联的钉钉,会收到验证码;

步骤二:请输入您钉钉中的验证码以进行绑定认证,点击“绑定”后绑定成功;

5.2、用户绑定方式(有扫码登录功能):

找到如图“账号绑定”下的“钉钉”(如果没有在管理控制台配置钉钉服务,那么在这里是看不到钉钉的绑定的),点击"立即绑定",此时会出来二维码,通过钉钉扫描二维码即可绑定成功;

绑定成功后可以选择是否在行云管家使用钉钉头像、昵称、地址等信息;

六、登录行云管家

6.1、电脑网页端登录(未开通扫码登录功能):

如果配置钉钉时未配置扫码登录功能,那么登录门户网址时还是和平常一样输入账号密码来进行登录;

6.2、电脑网页端登录(已开通扫码登录功能):

如果配置钉钉时配置了扫码登录功能,那么请按如下进行操作:

(1)登录管理控制台,点击“系统设置”->“基本配置”;

(2)找到“安全策略”,点击“门户安全策略”里的“设置”按钮;

(3)找到“身份认证”->“通过第三方应用扫码登录门户”,进行“开启”,然后点击“确定”;

(4)打开门户网页,此时即可看到“登录”按钮下方有“第三方应用扫码登录”,点击下面的“钉钉”图标即可进行扫码登录;

6.3、手机APP端登录:

打开钉钉,下图以钉钉APP为例,点击“工作台”,下拉后找到“其他应用”,即可找到刚发布的应用;

七、设置钉钉消息订阅

如图,登录行云管家点击右上角的信封图标里的“消息订阅”;

此时既可以在“消息订阅”界面来设置哪些消息通过“钉钉”进行接收(如果没有在管理控制台配置钉钉服务,那么在这里是无法设置钉钉消息订阅的);