1. 目标
微信发展到今天,庞大的用户群体使得很多企业选择了微信定制开发。第三方应用可以通过集成企业微信实现企业用户对APP的功能的操作。
2. 准备
2.1 进入微信后台管理页面,开发者需要拥有管理员权限。
扫码进入后台管理:https://work.weixin.qq.com/wework_admin/loginpage_wx#profile/wxPlugin
2.2 到应用管理内创建本次需要集成的应用
2.3 准备好企业的ID 和 应用的ID(AgentId)、Secret
3. 开发集成
3.1 OAuth2接入流程
OAuth2的设计背景,在于允许用户在不告知第三方自己的帐号密码情况下,通过授权方式,让第三方服务可以获取自己的资源信息。
微信access_token有效期为7200秒,且每次URL重新获取时为最新的时效为7200秒的access_token,,FSC后台取到后缓存到redis 避免与微信服务的频繁交互。
3.2 集成过程
3.3开发步骤
3.3.1 登录企业微信后台,配置应用入口URL和网页授权
3.3.2 配置的入口URL跳转到应用的中间页面,用于重定向到应用的登录验证中间页面。( 此处也可以直接配置重定向的URL,直接跳转到登录验证。)
<script>
$.get('https://xxx.yyy.net/security/getDeriectInfoForWeChat', {},
function (params, status) {
console.log(params, status);
if (status == "success") {
var deriectUrl = encodeURIComponent(params.deriectUrl);
var reidctUrl = "https://open.weixin.qq.com/connect/oauth2/authorize?appid=" + params.appID + "&response_type=code&scope=snsapi_privateinfo&agentid=" + params.agentId + "&state=WeChat&redirect_uri=" + deriectUrl + "#wechat_redirect";
// alert(reidctUrl)
window.location.href = reidctUrl;
} else {
alert('初始化失败!')
}
}
)
</script>
3.3.3 重定向后的页面获取到微信授权码code,调用应用后台验证用户信息并登录
1)根据企业ID+应用Secret 获取access_token,并缓存到redis
2)根据access_token+code获取微信用户基本信息 (UserId、user_ticket)
3)根据access_token+user_ticket获取微信用户详细信息(userid、name、mobile、email)
4)根据userid匹配后台用户信息映射表 并做应用的登录
/**
* 验证微信用户信息
* @param LoginUser
* @return
*/
// @RequestMapping(value="/preLoginForWeChat",method=RequestMethod.GET)
public void preLoginForWeChat(LoginUser loginUser) {
String code = loginUser.getCode();
if(code==null||"".equals(code))
{
throw new RuntimeException("未获取到微信code");
}
SystemService sService = SpringBeanUtil.getBean(SystemService.class);
String accessToken = "";
Object accessTokenTimeObj = redisManager.get("WETCHAT_ACCESSTOKEN_TIME");//先从缓存里获取accessToken缓存的时间
boolean isGetTokenByURL = false;
if(accessTokenTimeObj!=null && !"".equals(accessTokenTimeObj)){
String accessTokenTimeStr = String.valueOf(accessTokenTimeObj);
Long accessTokenTime = Long.parseLong(accessTokenTimeStr);
Long thisTime = new Date().getTime();
long interval = (thisTime - accessTokenTime)/1000;
if(interval > 6900) //上次缓存到现在大于6900秒,再次通过URL获取
{
isGetTokenByURL = true;
}
else //否则从缓存中取
{
accessToken = String.valueOf(redisManager.get("WETCHAT_ACCESSTOKEN"));
}
}
else //未获取到缓存时间(即没有缓存),需通过URL获取
{
isGetTokenByURL = true;
}
if(isGetTokenByURL)//缓存中没有时 调用url获取
{
AdSysParamDto aspd = sService.getAdSysParamDtoByTypeAndCode("APP_WECHAT","ACCESS_TOKEN_URL");
if(aspd!=null)
{
String tokenUrl = aspd.getParamValues();//url
if(tokenUrl!=null)
{
String resStr = LocalUtil.sendPost(tokenUrl, null);
JSONObject json = JSONObject.parseObject(resStr);
accessToken = json.getString("access_token");
if(accessToken!=null && !"".equals(accessToken)) //获取到accessToken
{
redisManager.delete("WETCHAT_ACCESSTOKEN");
redisManager.set("WETCHAT_ACCESSTOKEN", accessToken,7000);//缓存accessToken7000秒(accessToken有效期7200秒)
redisManager.delete("WETCHAT_ACCESSTOKEN_TIME");
String tokenTime = String.valueOf(new Date().getTime());
redisManager.set("WETCHAT_ACCESSTOKEN_TIME", tokenTime,7000);//本次缓存的时间
}
}
}
}
if("".equals(accessToken)||"null".equals(accessToken))
{
throw new RuntimeException("未获取到微信accessToken");
}
AdSysParamDto aspd = sService.getAdSysParamDtoByTypeAndCode("APP_WECHAT","USER_INFO_URL");
if(aspd!=null)
{
String userUrl = aspd.getParamValues();//url
if(userUrl!=null)
{
userUrl = userUrl.replace("{ACCESS_TOKEN}", accessToken);
userUrl = userUrl.replace("{CODE}", code);
String resStr = LocalUtil.sendPost(userUrl, null);
JSONObject json = JSONObject.parseObject(resStr);
String userId = json.getString("UserId");
String userTicket = "";
if(userId!=null && !"".equals(userId))
{
userTicket = json.getString("user_ticket");
Map<String, Object> param = new HashMap<String, Object>();
param.put("weChatUserId", userId);
ModuleReturn<UserInfoWechatMappingDto> weUserModule = userIfoWeChatMappingAPI.queryUserInfoWechatMapping(param);
if(weUserModule.isSuccess())
{
UserInfoWechatMappingDto weUser = weUserModule.getDatas();
if(weUser!=null)
{
String userAccount = weUser.getUserAccount();
String password = userAccount;//任意密码(此处做单点不校验)
loginUser.setIsPointLogin("1");//单点登录
loginUser.setUserAccount(userAccount);
loginUser.setPassword(userAccount);//单点登录密码不校验
}
}
}
else
{
throw new RuntimeException("未获取到微信userId");
}
}
}
}
3.3.4 应用的前台获取后台接口登录成功结果,跳转到对应的展示页面