一、背景
最近业务要求 PC 端系统登录使用 APP 应用扫码登录。
主要目的是：
1、简化用户录入账号密码，达到快速登录 PC；
2、账号登录使用更加安全性；
3、为了推广更多让大家打开使用 APP（因为行业的特殊性，实际业务场景中大都设计师都在使用 PC 端设计软件，同时也习惯了 PC 端下单）。
二、处理流程
1、业务流程图
因为扫码的时候有两种处理逻辑，所以流程图有业务处理方案。但不管哪种方案，背后技术处理逻辑是一样的。
2、技术实现设计流图程
3、处理步骤说明
a、用户打开 PC 登录页面，PC 登录页面向认证中心发起请求，认证中心生成 uuid 等信息，返回 uuid 等信息给前端，前端展示一个包含 uuid 的二维码。
b、PC 端登录页面定时向认证中心轮询二维码的状态。
c、用户登录移动端，打开移动端摄像头扫描 PC 端登录页面的二维码。
d、移动端将二维码中包含的 uuid 等信息发送给认证中心，认证中心将二维码状态设置为“扫描成功”。
e、PC 端登录页面轮询到二维码状态为“扫描成功”，提示“扫描成功”，以下图片仅供参考。
f、移动端展示消息确认弹出框，显示“登录”、“取消登录”按钮，同时将移动端当前登录的用账号、当前移动端登录的 token 和二维码 uuid 等信息发送给认证中心。
g、认证中心将用户所选要登录的账号保存在二维码信息里面，并将二维码状态设置为“已授权”。
h、登录页面从轮询二维码不存在时，提示“二维码已过期” ，以下图片仅供参考。
i、登录页面从轮询二维码状态为“已取销”时，提示“你已取消此次操作，你可再次扫描，或关闭窗口”。
j、登录页面从轮询二维码状态为“已授权”时，认证中心生成 PC 端登录的 token，设置 cookie，并向 PC 端前端发起重定向跳转。
程序处理时序图
三、代码实现
auth2 认证最简单的代码结构示例
public class Auth2Login { public static void main(String[] args) { //Step 1: 获取授权请求URL String authRequestUrl = "https://example.com/oauth/authorize";
//Step 2: 向授权服务器发送请求，获取授权码 String authCode = getAuthCode(authRequestUrl);
//Step 3: 使用授权码，向认证服务器发送请求，获取access token String accessToken = getAccessToken(authCode);
//Step 4: 使用access token，访问资源服务器，进行用户登录 String userInfo = getUserInfo(accessToken);
//Step 5: 根据user info进行用户登录 login(userInfo); }
public static String getAuthCode(String authRequestUrl) { //TODO return null; }
public static String getAccessToken(String authCode) { //TODO return null; }
public static String getUserInfo(String accessToken) { //TODO return null; }
public static void login(String userInfo) { //TODO }}
复制代码
扫码登录认证关键代码片段
/** * 初始化，主要通过请求基本参娄生成UUID，并把uuid写入redis * @param cmd 请求参数 * @return */ public Response init(LoginQrCodeInitCmd cmd) {
String clientId = cmd.getClientId(); String clientRedirectUri = cmd.getClientRedirectUri();
ClientDetailsE clientDetails = oauthService.loadClientDetails(clientId); if (clientDetails == null || clientDetails.getId() == null) { return Response.buildFailure(AuthcenterCode.INVALID_CLIENT, String.format(AuthcenterCode.INVALID_CLIENT.getDesc(), clientId)); }
if (!clientDetails.getGrantTypes().contains(GrantType.QR_CODE.toString())) { return Response.buildFailure(AuthcenterCode.INVALID_GRANT_TYPE, String.format(AuthcenterCode.INVALID_GRANT_TYPE.getDesc(), clientId)); }
LoginQrCodeE qrCodeE = LoginQrCodeE.instance().init(clientId, clientRedirectUri); return DataResponse.of(BeanToolkit.instance().copy(qrCodeE, LoginQrCodeCO.class)); }
/** * 通过UUID获取登录二维码 * @param uuid 唯一字符串 * @return QR code对象 */ public LoginQrCodeE getLoginQrCode(String uuid) { return LoginQrCodeE.instance().of(uuid); }
/** * 通过UUID扫码 * @param uuid 唯一字符串 * @return */ public Response scan(String uuid) { LoginQrCodeE.instance().scan(uuid); return Response.buildSuccess(); }
/** * 取消登录确认 * @param uuid 唯一字符串 * @return */ public Response cancel(String uuid) { LoginQrCodeE.instance().cancel(uuid); return Response.buildSuccess(); }
/*** * 验证登录 * @param cmd 用户登录对象信息 * @return 如果成功返回登录信息结构体 */ public Response authorize(LoginQrCodeAuthorizeCmd cmd) {
String uuid = cmd.getUuid(); String selectedAccountId = cmd.getSelectedAccountId(); String token = cmd.getToken();
//是否有扫码 if (LoginQrCodeE.instance().of(uuid).notScanned()) { return Response.buildFailure(AuthcenterCode.QR_CODE_NOT_SCANNED); }
/** * 找出token */ AccessTokenE accessTokenE = oauthRepository.findAccessToken(token); if (accessTokenE == null) { return Response.buildFailure(AuthcenterCode.INVALID_TOKEN); }
AccountE userAccount = oauthRepository.findAccountByToken(token); if (userAccount == null) { // 当前令牌不存在用户态（账号） return Response.buildFailure(AuthcenterCode.TOKEN_ACCOUNT_RELA_NOT_EXIST); } List<String> userAccountIds = accountRepository.forceGetAccountIdsByMainUserId(userAccount.getMainUserId()); if (userAccountIds == null) { // 当前账号异常 return Response.buildFailure(AuthcenterCode.UNKNOWN_ACCOUNT); }
if (!userAccountIds.contains(selectedAccountId)) { // 所选账号与当前令牌登录人信息不一致 return Response.buildFailure(AuthcenterCode.INVALID_SWITCH_ACCOUNT); }
LoginQrCodeE.instance().authorize(uuid, selectedAccountId); return Response.buildSuccess(); }
/** * 对外提供轮旬时间服务方法，当查询redis key=uuid是否超时 * @param uuid 用户访问请求的UUID * @return 登录码状态对象 * @throws OAuthSystemException */ public LoginQrCodeE handle(String uuid) throws OAuthSystemException { LoginQrCodeE loginQrCode = getLoginQrCode(uuid); // 当处于“已授权”状态时，才能触发准备登录 if (loginQrCode.authorized()) { return loginQrCode.ready(); }
// 当处于“准备登录”状态时，才能触发登录 if (loginQrCode.loginReady()) { return login(loginQrCode); }
return loginQrCode; }
/** * 扫码登录 * @param loginQrCode 二维码带的对象信息 * @return * @throws OAuthSystemException 认证异常 */ public LoginQrCodeE login(LoginQrCodeE loginQrCode) throws OAuthSystemException { String clientId = loginQrCode.getClientId(); String accountId = loginQrCode.getAccountId(); ClientDetailsE clientDetails = clientDetailsRepository.findByClientId(clientId); AccountE userAccount = accountRepository.getAccountById(accountId); accountRepository.checkAccount(userAccount); AuthorizeE authorize = oauthRepository.findAccountAuthorizeByAccountId(accountId); authorizeRepository.checkAuthorizeDataIntegrity(authorize); if (authorize == null) { throw new UnknownAuthorizeException("Cannot find AuthorizeE mainUserId="+mainUserId); } AccessTokenE accessToken = oauthService.retrieveQrCodeAccessToken(clientDetails, authorize, userAccount, new HashSet<>(), new BizCodeE(loginQrCode.getAppCode(), loginQrCode.getSubAppCode()));
return loginQrCode.login(accessToken.getToken(), accessToken.getRefreshToken(), accessToken.getCastgt()); }
复制代码
代码仅是展示关键的处理过程，结构还是比较清晰的；这里不提供完整的项目工程，因为这是公司的产权，况且每个公司的业务要求不同，大家理解后再去实现的自己扫码认证逻辑，处理方法大同小异。
原文链接：文章
评论