微信扫码登录
- 1. 授权流程说明
- 第一步:请求 code
- 第二步:通过 code 获取 access_token
- 第三步:通过 access_token 调用接口
- 2. 授权流程代码
- 3. 用户登录和登出
- 4. Spring AOP 校验用户有没有登录
- 5. 拦截登录校验不通过抛出的异常
1. 授权流程说明
微信 OAuth2.0授权登录让用户使用微信身份安全登录第三方应用或网站,在微信用户授权登录已接入微信 OAuth2.0的第三方应用后,第三方可以获取到用户的接口调用凭证(access_token),通过 access_token 可以进行微信开放平台授权关系接口调用,从而可实现获取微信用户基本开放信息和帮助用户实现基础开放开发功能等。
官方文档:https://developers.weixin.qq.com/doc/oplatform/Website_App/WeChat_Login/Wechat_Login.html
微信OAuth2.0授权登录目前支持authorization_code模式,适用于拥有server端的应用授权。该模式整体流程为:
- 第三方发起微信授权登录请求,微信用户允许授权第三方应用后,微信会拉起应用或重定向到第三方网站,并且带上授权临时票据 code 参数;
- 通过 code 参数加上 AppID 和 AppSecret 等,通过 API 换取 access_token;
- 通过 access_token 进行接口调用,获取用户基本数据资源或帮助用户实现基本操作。
第一步:请求 code
第三方使用网站应用授权登录前,需要注意已获取相应网页授权作用域(scope = snsapi_login),则可以通过在 PC端打开以下链接:记得替换成自己的参数
https://open.weixin.qq.com/connect/qrconnect?appid=APPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&state=STATE#wechat_redirect
返回说明
用户允许授权后,将会重定向到 redirect_uri 的网址上,并带上 code 和 state 参数
redirect_uri?code=CODE&state=STATE
若用户禁止授权,则重定向后不会带上 code 参数,仅会带上 state 参数
redirect_uri?state=STATE
例如:
登录一号店网站应用:https://passport.yhd.com/wechat/login.do
打开后,一号店会生成 state 参数,跳转到 :
https://open.weixin.qq.com/connect/qrconnect?appid=wxbdc5610cc59c1631&redirect_uri=https%3A%2F%2Fpassport.yhd.com%2Fwechat%2Fcallback.do&response_type=code&scope=snsapi_login&state=3d6be0a4035d839573b04816624a415e#wechat_redirect
微信用户使用微信扫描二维码并且确认登录后,PC端会跳转到:https://passport.yhd.com/wechat/callback.do?code=CODE&state=3d6be0a4035d839573b04816624a415e
第二步:通过 code 获取 access_token
通过 code 获取 access_token
官方文档:https://api.weixin.qq.com/sns/oauth2/access_token?appid=APPID&secret=SECRET&code=CODE&grant_type=authorization_code
返回说明
正确的返回:
{
"access_token":"ACCESS_TOKEN",
"expires_in":7200,
"refresh_token":"REFRESH_TOKEN",
"openid":"OPENID",
"scope":"SCOPE",
"unionid": "o6_bmasdasdsad6_2sgVt7hMZOPfL"
}
错误的返回样例:
{"errcode":40029,"errmsg":"invalid code"}
- AppSecret 是应用接口使用密钥,泄露后将可能导致应用数据泄露、应用的用户数据泄露等高风险后果;存储在客户端,极有可能被恶意窃取(如反编译获取 AppSecret );
- access_token 为用户授权第三方应用发起接口调用的凭证(相当于用户登录态),存储在客户端,可能出现恶意获取 access_token 后导致的用户数据泄露、用户微信相关接口功能被恶意发起等行为;
- refresh_token 为用户授权第三方应用的长效凭证,仅用于刷新 access_token,但泄露后相当于 access_token 泄露,风险同上。
建议将 Secret、用户数据(如 access_token)放在App云端服务器,由云端中转接口调用请求。
第三步:通过 access_token 调用接口
获取access_token 后,进行接口调用,有以下前提:
1.access_token 有效且未超时;
2.微信用户已授权给第三方应用账号相应接口作用域(scope)
对于接口作用域(scope),能调用的接口有以下:
2. 授权流程代码
因为微信开放平台和微信公众平台的 AppID、AppSecret 都是不同的,因此需要配置以下:
# 开放平台
wechat.open-app-id = wx6ad144e54af67d87
wechat.open-app-secret = 91a2ff6d38a2bbccfb7e9f9079108e2e
@Data
@Component
@ConfigurationProperties(prefix = "wechat")
public class WechatAccountConfig {//公众号appidprivate String mpAppId;//公众号appSecretprivate String mpAppSecret;//商户号private String mchId;//商户秘钥private String mchKey;//商户证书路径private String keyPath;//微信支付异步通知private String notifyUrl;//开放平台idprivate String openAppId;//开放平台秘钥private String openAppSecret;
}
@Configuration
public class WechatOpenConfig {@Autowiredprivate WechatAccountConfig accountConfig;@Beanpublic WxMpService wxOpenService() {WxMpService wxOpenService = new WxMpServiceImpl();wxOpenService.setWxMpConfigStorage(wxOpenConfigStorage());return wxOpenService;}@Beanpublic WxMpConfigStorage wxOpenConfigStorage() {WxMpInMemoryConfigStorage wxMpInMemoryConfigStorage = new WxMpInMemoryConfigStorage();wxMpInMemoryConfigStorage.setAppId(accountConfig.getOpenAppId());wxMpInMemoryConfigStorage.setSecret(accountConfig.getOpenAppSecret());return wxMpInMemoryConfigStorage;}
}
@Controller
@RequestMapping("/wechat")
@Slf4j
public class WeChatController {@Autowiredprivate WxMpService wxMpService;@Autowiredprivate WxMpService wxOpenService;@GetMapping("/qrAuthorize")public String qrAuthorize() {//returnUrl就是用户授权同意后回调的地址String returnUrl = "http://heng.nat300.top/sell/wechat/qrUserInfo";//引导用户访问这个链接,进行授权String url = wxOpenService.buildQrConnectUrl(returnUrl, WxConsts.QRCONNECT_SCOPE_SNSAPI_LOGIN, URLEncoder.encode(returnUrl));return "redirect:" + url;}//用户授权同意后回调的地址,从请求参数中获取code@GetMapping("/qrUserInfo")public String qrUserInfo(@RequestParam("code") String code) {WxMpOAuth2AccessToken wxMpOAuth2AccessToken = new WxMpOAuth2AccessToken();try {//通过code获取access_tokenwxMpOAuth2AccessToken = wxOpenService.oauth2getAccessToken(code);} catch (WxErrorException e) {log.error("【微信网页授权】{}", e);throw new SellException(ResultEnum.WECHAT_MP_ERROR.getCode(), e.getError().getErrorMsg());}//从token中获取openidString openId = wxMpOAuth2AccessToken.getOpenId();//这个地址可有可无,反正只是为了拿到openid,但是如果没有会报404错误,为了好看随便返回一个百度的地址String returnUrl = "http://www.baidu.com";log.info("openid={}", openId);return "redirect:" + returnUrl + "?openid="+openId;}
}
请求路径:在浏览器打开
https://open.weixin.qq.com/connect/qrconnect?appid=wx6ad144e54af67d87&redirect_uri=http%3A%2F%2Fsell.springboot.cn%2Fsell%2Fqr%2FoTgZpwenC6lwO2eTDDf_-UYyFtqI&response_type=code&scope=snsapi_login&state=http%3a%2f%2fheng.nat300.top%2fsell%2fwechat%2fqrUserInfo
获取了openid:openid = o9AREv7Xr22ZUk6BtVqw82bb6AFk
3. 用户登录和登出
@Controller
@RequestMapping("/seller")
public class SellerUserController {@Autowiredprivate SellerService sellerService;@Autowiredprivate StringRedisTemplate redisTemplate;@Autowiredprivate ProjectUrlConfig projectUrlConfig;@GetMapping("/login")public ModelAndView login(@RequestParam("openid") String openid, HttpServletResponse response, Map<String, Object> map) {//1. openid去和数据库里的数据匹配SellerInfo sellerInfo = sellerService.findSellerInfoByOpenid(openid);if (sellerInfo == null) {map.put("msg", ResultEnum.LOGIN_FAIL.getMessage());map.put("url", "/sell/seller/order/list");return new ModelAndView("common/error");}//2. 设置token至redisString token = UUID.randomUUID().toString();//设置token的过期时间Integer expire = RedisConstant.EXPIRE;redisTemplate.opsForValue().set(String.format(RedisConstant.TOKEN_PREFIX, token), openid, expire, TimeUnit.SECONDS);//3. 设置token至cookieCookieUtil.set(response, CookieConstant.TOKEN, token, expire);return new ModelAndView("redirect:" + "http://heng.nat300.top/sell/seller/order/list");}@GetMapping("/logout")public ModelAndView logout(HttpServletRequest request, HttpServletResponse response, Map<String, Object> map) {//1. 从cookie里查询Cookie cookie = CookieUtil.get(request, CookieConstant.TOKEN);if (cookie != null) {//2. 清除redisredisTemplate.opsForValue().getOperations().delete(String.format(RedisConstant.TOKEN_PREFIX, cookie.getValue()));//3. 清除cookieCookieUtil.set(response, CookieConstant.TOKEN, null, 0);}map.put("msg", ResultEnum.LOGOUT_SUCCESS.getMessage());map.put("url", "/sell/seller/order/list");return new ModelAndView("common/success", map);}
}
- 将上面获取到的 openID 存入数据库
- 将授权后跳转的地址改为登录地址:
//用户授权同意后回调的地址,从请求参数中获取code@GetMapping("/qrUserInfo")public String qrUserInfo(@RequestParam("code") String code) {WxMpOAuth2AccessToken wxMpOAuth2AccessToken = new WxMpOAuth2AccessToken();try {//通过code获取access_tokenwxMpOAuth2AccessToken = wxOpenService.oauth2getAccessToken(code);} catch (WxErrorException e) {log.error("【微信网页授权】{}", e);throw new SellException(ResultEnum.WECHAT_MP_ERROR.getCode(), e.getError().getErrorMsg());}//从token中获取openidString openId = wxMpOAuth2AccessToken.getOpenId();//授权成功后跳转到卖家系统的登录地址String returnUrl = "http://heng.nat300.top/sell/seller/login";log.info("openid={}", openId);return "redirect:" + returnUrl + "?openid="+openId;}
- 在浏览器请求这个链接:
https://open.weixin.qq.com/connect/qrconnect?appid=wx6ad144e54af67d87&redirect_uri=http%3A%2F%2Fsell.springboot.cn%2Fsell%2Fqr%2FoTgZpwenC6lwO2eTDDf_-UYyFtqI&response_type=code&scope=snsapi_login&state=http%3a%2f%2fheng.nat300.top%2fsell%2fwechat%2fqrUserInfo
第三方应用请求使用微信扫码登录,而不是使用本网站的密码:
用户同意授权后登入第三方应用的后台管理系统中:
4. Spring AOP 校验用户有没有登录
@Aspect
@Component
@Slf4j
public class SellerAuthorizeAspect {@Autowiredprivate StringRedisTemplate redisTemplate;@Pointcut("execution(public * com.hh.controller.Seller*.*(..))" +"&& !execution(public * com.hh.controller.SellerUserController.*(..))")public void verify() {}@Before("verify()")public void doVerify() {ServletRequestAttributes attributes = (ServletRequestAttributes) RequestContextHolder.getRequestAttributes();HttpServletRequest request = attributes.getRequest();//查询cookieCookie cookie = CookieUtil.get(request, CookieConstant.TOKEN);//如果cookie中没有token说明已经登出或者根本没有登录if (cookie == null) {log.warn("【登录校验】Cookie中查不到token");//校验不通过,抛出异常throw new SellerAuthorizeException();}//去redis里查询String tokenValue = redisTemplate.opsForValue().get(String.format(RedisConstant.TOKEN_PREFIX, cookie.getValue()));//如果redis中没有对应的openid,同样表示登出或者根本没有登录if (StringUtils.isEmpty(tokenValue)) {log.warn("【登录校验】Redis中查不到token");throw new SellerAuthorizeException();}}
}
5. 拦截登录校验不通过抛出的异常
拦截及登录校验不通过的异常,让其跳转的登录页面,扫码登录
@ControllerAdvice
public class SellExceptionHandler {//拦截登录异常@ExceptionHandler(value = SellerAuthorizeException.class) public ModelAndView handlerAuthorizeException() {//拦截异常后,跳转到登录界面return new ModelAndView("redirect:".concat("https://open.weixin.qq.com/connect/qrconnect?" +"appid=wx6ad144e54af67d87" +"&redirect_uri=http%3A%2F%2Fsell.springboot.cn%2Fsell%2Fqr%2F" +"oTgZpwenC6lwO2eTDDf_-UYyFtqI" +"&response_type=code&scope=snsapi_login" +"&state=http%3a%2f%2fheng.nat300.top%2fsell%2fwechat%2fqrUserInfo"));}@ExceptionHandler(value = SellException.class) @ResponseBody public ResultVO handlerSellerException(SellException e) {return ResultVOUtil.error(e.getCode(), e.getMessage());}@ExceptionHandler(value = ResponseBankException.class) @ResponseStatus(HttpStatus.FORBIDDEN) public void handleResponseBankException() {}
}
好事定律:每件事最后都会是好事,如果不是好事,说明还没到最后。