如何使用支付宝账号授权登录网站

本周在项目开发中使用到了支付宝授权登录（一键登录）我们的网站，周末做一下总结：

0.总体思路

为防止各位朋友看迷糊，先说一下整体执行流程：用户在我们网站点击一个“支付宝授权登录”按钮，请求到了java后台，完成跳转至支付宝之前的字符串拼接（包括回调地址，appid，scope，state），后台将这个地址处理完成之后返回给前端，前端通过window.href=”url”的形式跳转至支付宝登录页面，用户通过输入密码或者扫码，支付宝判断如果正确就会携带支付宝用户id和access_token跳转至我写的回调地址里面（这个回调地址是我们自己写的，让支付宝调用的，需要在支付宝页面配置，下面会说），我根据alipay_user_id查自己的库，看用户是否存在，如果存在说明已经与我们平台的用户系统进行绑定，将其重定向至成功页，否则重定向至绑定用户信息页，完善信息。需要明白的是我们平台也有自己的用户系统，必须将从支付宝拿过来的alipay_user_id与我们平台的用户系统进行绑定，否则区分不出哪个是哪个用户，绑定就是在这个完善用户信息页面进行的。

1.开通蚂蚁金服开发服务并配置完成。

上面只说了思路，下面说具体的操作流程。既然需要调用支付宝的接口，那就要开通蚂蚁金服的服务，通过下面地址开通：https://openhome.alipay.com/platform/appManage.htm ，需要营业执照或者身份证信息，审核通过后创建应用，并在功能选项中选择要使用的服务，比如我这里使用“获取会员信息”，点击“继续添加”可以添加其他的，如下图：

点击概览下面的应用信息，配置回调地址和公钥，密钥，如下图：

随后下载支付宝sdk的jar，已经集成了非常简单的调用方法。
参考文档如下：
https://docs.open.alipay.com/289/105656#s3

2.代码开发

代码开发不太难，有点绕的是怎么传参。我是通过state传递的。从官方文档中可以看到：state参数不是必须参数，属于商户自定义参数，用户授权后，重定向到redirect_uri时会原样回传给商户，而且最大长度只能是100，最好是做到既不可预测，又可以证明客户端和当前第三方网站的登录认证状态存在关联，那我们就可以通过state参数进行传递，比如我这里通过1_0，2_500这种形式拼接的，前面的数代表操作类型，比如我这里1代表登录，2代表修改支付宝账号，0代表无上级id，大于0表示那就是上级id，如500代表上级id，然后拿到传递过来的参数之后使用split参数进行分割、解析、判断不同情况，部分示例代码如下：

/**
 * @Description 登录接口
 * @Author 刘俊重
 */
@NoLogin
@RequestMapping("/supplierLogin")
public R supplierLogin(@RequestBody Map<String, Object> map) throws Exception {
	//获取核心企业id，0表示不是通过核心企业邀请链接登录
	Object coreId = map.get("coreId");
	if (null == coreId || coreId == "") {
		coreId = 0;
	}

	String s = DbEnum.CallBack.Type.LOGIN+"_"+coreId;
	logger.info(">>>>>>>>>>>>>>>>>>>>s"+s);
	/***重定向至支付宝授权登录页*/
	String encode = URLEncoder.encode(SystemVar.REDIRECT_URL,"UTF-8");
	return R.ok().put("visitUrl", SystemVar.ALIPAY_URL+"?app_id=" + SystemVar.APP_ID + "&scope=auth_user&redirect_uri=" + encode + "&state=" + s);
}

回调函数部分代码如下：

/**
	 * @Description 支付宝登录成功之后的回调函数，供支付宝调用
	 * @Author 刘俊重
	 */
	@NoLogin
	@RequestMapping("/callBackLogin")
	@ResponseBody
	public R callBackLogin(HttpServletRequest request, HttpServletResponse response) throws Exception {
		String authCode = request.getParameter("auth_code");
		String state = request.getParameter("state");   /***我们需要的参数，拿到之后以下划线分割*/

		if(null==state || state==""){
			return R.error("获取支付宝授权失败");
		}
		AlipaySystemOauthTokenResponse authToken = getAuthToken(authCode);
		if (null == authToken) {
			return R.error("获取支付宝授权失败");
		}
		String userId = authToken.getUserId();
		String accessToken = authToken.getAccessToken();

		String[] split = state.split("_");
		String type = split[0];
		if(DbEnum.CallBack.Type.LOGIN.equals(type)){
			String coreId = split[1];
			//登录
			/***根据支付宝用户id查询供应商是否存在*/
			Map<String, Object> map = new HashMap<String, Object>();
			map.put("alipayUserId", userId);
			SuppliersInfo suppliersInfo = suppliersInfoService.look(map);
			if (null == suppliersInfo) {
				if("0".equals(coreId)){
					//说明没有注册而且没有带核心企业id，跳转至错误提示页面
					response.sendRedirect(SystemVar.WEBSITE + "/#/error?userId=" + userId + "&coreId=" + coreId);
					return R.ok();
				}

				//根据上级id查询是否确实存在，避免乱注册
				Map<String, Object> param = new HashMap<String, Object>();
				param.put("finmallId", coreId);
				CoreCorpInfo coreCorpInfo = coreCorpInfoService.look(param);
				if (null == coreCorpInfo) {
					response.sendRedirect(SystemVar.WEBSITE + "/#/error?userId=" + userId + "&coreId=" + coreId);
					return R.ok();
				}

				logger.info(">>>>>>>>>>>>>>>>完善信息地址"+SystemVar.WEBSITE + "/#/fillCompMess?userId=" + userId + "&coreId=" + coreId);
				//信息不存在，说明没有注册，去完善信息页
				response.sendRedirect(SystemVar.WEBSITE + "/#/fillCompMess?userId=" + userId + "&coreId=" + coreId);
				return R.ok();
			}
			
			String auditState = suppliersInfo.getAuditState();
			if (SuppliersInfo.AuditState.WAIT.equals(auditState)) {
				logger.info(">>>>>>>>>>>>>>>>待审核地址"+SystemVar.WEBSITE + "/#/waitExam?userId=" + userId + "&coreId=" + coreId);
				//待审核，进待审核提示页
				response.sendRedirect(SystemVar.WEBSITE + "/#/waitExam?userId=" + userId + "&coreId=" + coreId);
				return R.ok();
			} else if (SuppliersInfo.AuditState.UNPASSED.equals(auditState)) {
				logger.info(">>>>>>>>>>>>>>>>审核拒绝地址"+SystemVar.WEBSITE + "/#/refuse?userId=" + userId + "&coreId=" + coreId);
				//审核拒绝，进审核拒绝提示页
				response.sendRedirect(SystemVar.WEBSITE + "/#/refuse?userId=" + userId + "&coreId=" + coreId);
				return R.ok();
			} else if (SuppliersInfo.AuditState.PASSED.equals(auditState)) {
				//审核通过，把用户信息放session中
				String token = TokenUtils.getToken();
				cacheManager.getCache(SysCache.SESSION_CACHE_NAME).put(token, suppliersInfo);
				//往cookie中添加token
				CookieUtils.setCookie(request, response, CookieName.SCM_TOKEN, token);

				logger.info(">>>>>>>>>>>>>>>>审核通过地址"+SystemVar.WEBSITE + "/#/alipay?userId=" + userId + "&coreId=" + coreId + "&token=" + token);
				response.sendRedirect(SystemVar.WEBSITE + "/#/alipay?userId=" + userId + "&coreId=" + coreId + "&token=" + token);
				return R.ok();
			}
		}

		return null;
	}

支付宝获取获取authToken方法如下（支付宝中也有示例）：

/**
 * @Description 获取支付宝authToken
 * @Author 刘俊重
 * @Date 2017/11/27
 */
private AlipaySystemOauthTokenResponse getAuthToken(String authCode) {

	AlipayClient alipayClient = new DefaultAlipayClient(SystemVar.ALIPAY_GATEWAY, SystemVar.APP_ID, SystemVar.PRIVATE_KEY, "json", CHARSET_UTF8, SystemVar.ALIPAY_PUBLIC_KEY, "RSA2");
	AlipaySystemOauthTokenRequest request = new AlipaySystemOauthTokenRequest();
	request.setCode(authCode);
	request.setGrantType("authorization_code");
	AlipaySystemOauthTokenResponse oauthTokenResponse = null;
	try {
		oauthTokenResponse = alipayClient.execute(request);
		System.out.println(oauthTokenResponse.getAccessToken());
	} catch (AlipayApiException e) {
		//处理异常
		e.printStackTrace();
	}
	return oauthTokenResponse;
}

到这里已经可以获取到alipay_user_id供我们使用了，如果还想获取其它信息，可以使用accessToken换取用户信息，文档中有，这里不再赘述。

3.如何配置支付宝沙箱测试

支付宝的回调地址只能填写一个，如果项目已经上线了，那总不能一会把回调地址配置成生产的，一会配置成测试的吧，好在支付宝提供了一套供测试使用的沙箱环境，沙箱环境的文档地址如下：
https://docs.open.alipay.com/200/105311 ，也可以看我下面说的这些：
首先进入如下地址：https://openhome.alipay.com/platform/appDaily.htm?tab=info 配置沙箱环境，包括沙箱的网关，授权url，appid，公钥，密钥，均跟生产的都不同，需要重新配置，其中授权url如下：
https://openauth.alipaydev.com/oauth2/publicAppAuthorize.htm 。沙箱环境使用正常的支付宝账号也无法登录，必须要使用沙箱环境分配的账号，可以在下面地址中找到沙箱测试账号：https://openhome.alipay.com/platform/appDaily.htm?tab=account ，以上便是支付宝授权登录网站的开发流程。