企业微信单点登录开发
公司目前做了一个基于Vuejs为前端加Java为后端的H5系统,公司很多客户希望对接企业微信单点登录。这里记录下开发企业微信单点登录模式。
为了测试方便,建立测试公司来做测试。
企业微信单点登录流程
要实现单点登录,先要注册公司企业微信,然后配置应用,并配置相关的URL,信任域名,回调地址等。
简单操作开发逻辑:
image
配置企业微信单点登录注册企业
首先需要注册一个测试的企业:
填写企业名称等基本信息填写管理员信息用微信扫码绑定管理员微信
image
注册成功
注册成功后可以进入管理后台,可以配置应用了。
image
配置应用
注册好企业之后,进入管理控制后台,可以在企业中配置应用了微信点单,点击【创建应用】
image
配置应用基本信息,logo等
image
创建应用之后,和在调用接口的时候需要用到。
image
配置应用信任域名,如果没有域名可以尝试修改hosts来实现,但是只能在配置了hosts的机器上做测试
image
如果需要使用JS-SDK的话(只做单点登录不需要配置),还需要验证域名:
image
配置应用主页信息
后面有详细的应用【单点登录地址】章节说明信息
image
完成之后如下
image
单点登录地址
企业微信使用单点登录,因此地址是一个单点登录的地址微信点单,如下网址:
#
文档地址:
参数说明:
参数必须说明
appid
是
企业的
是
授权后重定向的回调链接地址,此链接是开发者提前开发出来,会在微信登录成功的时候跳转到此URL,并附带一个名为code的请求参数,然后可以根据这个code来获取用户信息,请使用对链接进行处理
是
返回类型,此时固定为:code
scope
是
应用授权作用域。企业自建应用固定填写:
state
否
重定向后会带上state参数,企业可以填写a-zA-Z0-9的参数值,长度不可超过128个字节
#
是
终端使用此参数判断是否需要带上身份信息,注意URL hash是必须带上的,不然可能会报错:请在企业微信客户端打开链接
需要转码之后拼接到URL之后
URL转码工具:
注意上面的来源是:
image
开发单点登录
微信单点登录已经有人开源出来一些调用工具,把相关token获取(token有效期处理)和接口调用等工作封装好,目前选择此开源库
选用企业微信模块即可:
com.github.binarywang
weixin-java-cp
3.6.0
参考文档地址:
如果不是用开源库,使用等工具直接调用其API接口也能实现,参考官方文档地址:
具体开发代码:
public class QyWeixinLoginTest {
private static final Logger logger = LoggerFactory.getLogger(QyWeixinLoginTest.class);
public static final String CORP_ID = ""; // 企业的corpId
public static final Integer AGENT_ID = 1000002; // 企业应用的AgentId
public static final String APP_SECRET = ""; // 企业应用的Secret
public static final String CODE = ""; // OAUTH2 REDIRECT_URI接收的code(测试的时候可以在浏览器地址栏中复制出来)
@Test
public void test() throws Exception {
// 初始化WxCpService
WxCpService wxCpService = new WxCpServiceImpl();
WxCpDefaultConfigImpl wxCpConfigStorage = new WxCpDefaultConfigImpl();
wxCpConfigStorage.setCorpId(CORP_ID); // 企业的corpId
wxCpConfigStorage.setAgentId(AGENT_ID); // 企业应用的AgentId
wxCpConfigStorage.setCorpSecret(APP_SECRET); // 企业应用的Secret
wxCpService.setWxCpConfigStorage(wxCpConfigStorage);
// 调用获取用户信息
// 根据oauth2获取到的code获取用户基本信息
WxCpOauth2UserInfo userInfo = wxCpService.getOauth2Service().getUserInfo(CODE);
if (userInfo != null) {
String userId = userInfo.getUserId();
if (StringUtils.isBlank(userId)) { // 用openId换取userId
userId = wxCpService.getUserService().openid2UserId(userInfo.getOpenId());
}
// 根据userId查询微信中用户详情
WxCpUser userDetail = wxCpService.getUserService().getById(userId);
logger.debug("{}", userDetail);
}
}
}
// 拿到用户信息之后就可以根据用户的信息模拟登录操作
测试单点登录
如果有外网域名或者手机可以改hosts的话,单点登录可以在手机上测试,但是却没有调试功能,最好的方式是使用【微信开发者工具】来做测试
下载微信开发者工具:
下载安装之后,可以按照上面【单点登录地址】拼接出URL地址,并复制到开发者工具的地址栏测试(开发者工具需要登录和授权):
image
简简单单微信扫二维码可以登录,登录成功后再次操作,可能遇到需要授权问题,提示信息:未绑定企业号开发者
image
在企业控制后台中配置开发者工具授权:
image
然后可以测试可以获取到用户信息。
免责声明:部分文章信息来源于网络以及网友投稿,本站只负责对文章进行整理、排版、编辑,出于传递更多信息之目的,并不意味着赞同其观点或证实其内容的真实性,如本站文章和转稿涉及版权等问题,请作者在及时联系本站,我们会尽快为您处理。