pomlin

环境说明

依赖	版本
PIGX	5.6
架构模式	微服务

1721222053

#1. 登录页面

src/views/login/component/password.vue 此文件是前端账号密码登录的入口文件。此文件涉及页面验证码获取逻辑，行为验证码基于AJ-Captcha (opens new window)实现。

#① 密码登录页面的逻辑

#② 前端登录成功后跳转逻辑

#2. 前端报文加密

password明文：123456

转成

password密文：JFat0Zdc

为了保证前端提交登录信息（尤其是密码字段）带后台验证过程中被抓包破解密码，PIGX 框架对登录报文进行了对称加密处理详细说明参考: 前端报文加密的业务。

前端提供简单的 AES 对称加密算法，注意 key 和后端网关配置相同，这里打包混淆后，相对安全。

#3. 网关请求转发

网关中最重要的功能是路由转发，根据请求前缀匹配到对应服务。比如所有以 /auth 开头的请求会自动转发至 pigx-auth 服务的接口处理。

以下为：sys_route_conf 表定义的路由规则

在 PigxRequestGlobalFilter 过滤器中另外一个重要的功能就是截取路由前缀

例如: http://127.0.0.1:9999/auth/oauth2/token 转发到 pigx-auth 的请求路径自动截取 前缀变成

http://127.0.0.1:3000/oauth2/token

#4. 验证码校验处理

1721222163

pigx-auth 认证中心在接收到网关转发的请求后，会通过 ValidateCodeFilter 对验证码（图形、短信）等进行校验

#5. 前端请求密文解密

password密文：JFat0Zdc

转成

password明文：123456

Copied!

pigx-auth 在处理完验证码判断逻辑后，PasswordDecoderFilter 针对 /oauth2/token 请求会进行前端密码解密。

#6. auth 模块详解

登录请求报文

POST /auth/oauth2/token?grant_type=password&scope=server HTTP/1.1
Host: pig-gateway:9999
Authorization: Basic dGVzdDp0ZXN0
Content-Type: application/x-www-form-urlencoded
Content-Length: 32
username=admin&password=YehdBPev

#① 客户端认证

如上图在登录请求中会携带 Basic base64(clientId:clientSecret)，那么首先 OAuth2ClientAuthenticationFilter 会通过调用 RegisteredClientRepository (数据库存储) 来判断传入的客户端是否正确

#② 正式接收登录请求

OAuth2TokenEndpointFilter 会接收通过上文 OAuth2ClientAuthenticationFilter 客户端认证的请求

#③ 组装认证对象

AuthenticationConverter 会根据请求中的参数和授权类型组装成对应的授权认证对象

#④ 登录认证对象

AuthenticationToken

public class XXXAuthenticationToken extends OAuth2ResourceOwnerBaseAuthenticationToken {

}

#⑤ 授权认证调用

#⑥ 核心认证逻辑

#多用户体系匹配 UserDetailsService

#密码匹配校验

#用户状态校验

#⑦ 用户查询逻辑

用户查询逻辑的多种实现形式

解耦：通过 feign 查询其他系统获取并组装成 UserDetails
简单: 认证中心直接查询 DB 并组装成 UserDetails

#⑧ 密码校验逻辑

默认支持加密方式如下：

{noop}密码明文
{加密特征码}密码密文

PasswordEncoder 会自动根据特征码匹配对应的加密算法，所以上一步⑧ 查询用户对象组装成  UserDetails 需要特殊处理

return new UserDetails(user.getUsername(),"{bcrypt}"+"数据库存储的密文");

#⑨ 生成 OAuth2AccessToken

#⑩Token 存储持久化

当前 SAS 仅支持 JDBC 和内存，PIGX 扩展支持 Redis 实现

#⑪ 登录成功事件处理

基于 SpringEvent 事件处理，可以在这里做更多的处理日志、个性化等处理逻辑

#⑫ 请求结果输出 Token

private void sendAccessTokenResponse(HttpServletRequest request, HttpServletResponse response,
                                     Authentication authentication) throws IOException {

    OAuth2AccessTokenAuthenticationToken accessTokenAuthentication = (OAuth2AccessTokenAuthenticationToken) authentication;

    OAuth2AccessToken accessToken = accessTokenAuthentication.getAccessToken();
    OAuth2RefreshToken refreshToken = accessTokenAuthentication.getRefreshToken();
    Map<String, Object> additionalParameters = accessTokenAuthentication.getAdditionalParameters();
    // 无状态 注意删除 context 上下文的信息
    SecurityContextHolder.clearContext();
    this.accessTokenHttpResponseConverter.write(accessTokenResponse, null, httpResponse);
}

定义具体的输出返回格式等逻辑

登录 token 生成源码解析