私有部署版
配置管理
配置企业微信

一、私有部署版企业微信服务功能简介

通过绑定企业微信、您可获得以下特性:

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

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

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

(4)支持通过企业微信扫描二维码登录门户;

二、配置企业微信前置条件

2.1、必要项:

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

(1)企业微信后台管理员,可以进入企业微信后台管理系统;

(2)行云管家门户服务器必须要能访问外网,能连通企业微信地址https://qyapi.weixin.qq.com

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

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

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

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

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

三、配置企业微信:企业微信端

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

(2)点击“我的企业”并记录“企业ID”(这个就是后面要用到的“CorpId”);

(3)依次点击“应用管理”菜单-“应用”-“自建”-“创建应用”;

(4)添加“应用logo”、填写“应用名称”、选择“可见范围”,然后点击“创建应用”;

(5)此时进入到该应用页面,可以看到右上角显示该应用已启用,记录“AgentID”以及“Secret”;

(6)往下拉,找到如图“功能”里的“工作台应用主页”,点击“设置应用主页”:

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

http://66.66.66.66/mobile/login.html

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

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

(7)点击“确定”后如图显示“已启用”;

(8)往下拉,找到如图“开发者接口”里的“网页授权及JS-SDK”,点击“设置可信域名”;

(9)在“可信域名”里,域名或IP前面请不要带“http://”或“https://”;

a)如果您没有域名(不用扫码登录功能),请填写行云管家门户服务器外网IP地址并带上端口号(没有外网IP的话可以随意填写),例如

66.66.66.66:80

b)如果您有域名(需要扫码登录功能),请填写行云管家域名并带上端口号,例如

www.abc.com:80

(10)找到如图“开发者接口”里的“企业微信授权登录”,点击“设置”;

(11)点击如图“设置授权回调域”;

(12)填写IP或域名,点击“保存”;

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

66.66.66.66

b)如果您有域名(需要扫码登录功能),请填写行云管家域名,例如

www.abc.com

(13)点击“返回”;

(14)返回后可以看到这两项已设置完毕,到这里就完成了企业微信端的配置;

四、配置企业微信:管理控制台

4.1、必须配置项:

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

“RedirectUri”为选填项,具体请参考下述操作(实现通过企业微信扫码登录行云管家功能);

4.2、选择配置项:

如果希望通过企业微信扫码登录行云管家门户网页,需要为行云管家配置公网域名并填写“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”,请填写“PC域名网址然后加上/api/oauth/work_weixin_callback”(以http://www.abc.com为例,请填写http://www.abc.com/api/oauth/work_weixin_callback),点击“下一步”既完成企业微信的配置及绑定;

五、行云管家用户绑定企业微信

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

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

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

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

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

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

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

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

六、登录行云管家

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

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

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

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

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

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

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

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

6.3、手机APP端登录:

打开企业微信,下图以企业微信APP为例,点击“工作台”,下拉后找到“其他应用”,即可找到刚发布的应用,点击该图标即可登录移动端行云管家(前提是您已经在个人资料里绑定了企业微信);

七、设置企业微信消息订阅

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

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