看完这篇文章你还感觉SpringSecurity整合OAuth2

作者: 恒宇少年 | 来源:发表于2019-12-03 11:06 被阅读0次

SpringSecurity整合OAuth2是开发者公认的资源保护、服务认证的最佳搭配伙伴，这对好基友一直在默默的守护着应用服务的安全，根据访问者的不同角色可以颗粒度控制到具体的接口，从而实现权限的细微划分。

而SpringSecurity框架在安全框架的队伍中算是入门比较高的，虽然Spring通过SpringBoot进行了封装，但是使用起来还是有很多容易遗漏的配置，因为配置比较多，让初学者理解起来也比较困难，针对这个问题ApiBoot对SpringSecurity以及OAuth2进行了封装，在基础上极大的简化了配置（只做简化、增强，SpringSecurity的基础语法、配置还可以正常使用）

免费教程专题

恒宇少年在博客整理三套免费学习教程专题，由于文章偏多特意添加了阅读指南，新文章以及之前的文章都会在专题内陆续填充，希望可以帮助大家解惑更多知识点。

创建项目

使用IDEA开发工具创建一个SpringBoot项目。

ApiBoot的底层是SpringBoot，而且ApiBoot为了支持SpringBoot的2.2.x分支，也对应的创建了2.2.x分支版本。

添加ApiBoot统一依赖

创建完项目后我们需要在pom.xml添加ApiBoot的统一版本依赖，如下所示：

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>org.minbox.framework</groupId>
      <artifactId>api-boot-dependencies</artifactId>
      <version>2.2.0.RELEASE</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

添加相关依赖

本章我们需要查询数据库内的用户信息进行认证，所以需要在pom.xml添加数据库相关的依赖，如下所示：

<dependencies>
  <dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
  </dependency>
  <dependency>
    <groupId>org.minbox.framework</groupId>
    <artifactId>api-boot-starter-security-oauth-jwt</artifactId>
  </dependency>
  <dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
  </dependency>
  <dependency>
    <groupId>com.zaxxer</groupId>
    <artifactId>HikariCP</artifactId>
  </dependency>
  <dependency>
    <groupId>org.minbox.framework</groupId>
    <artifactId>api-boot-starter-mybatis-enhance</artifactId>
  </dependency>
</dependencies>

在本章使用到了ApiBoot Mybatis Enhance，具体的使用请访问官方文档ApiBoot MyBatis Enhance使用文档

配置数据源

添加数据库相关的依赖后，在application.yml文件内添加如下配置信息：

spring:
  application:
    name: apiboot-security-oauth-custom-certification-user
  # 数据源配置
  datasource:
    type: com.zaxxer.hikari.HikariDataSource
    url: jdbc:mysql://127.0.0.1:3306/test?characterEncoding=utf8&serverTimezone=Asia/Shanghai
    username: root
    password: 123456
    driver-class-name: com.mysql.cj.jdbc.Driver
server:
  port: 9090

配置ApiBoot Security

ApiBoot Security默认采用的是内存方式（memory）读取用户信息，我们本章需要修改为JDBC方式，并且禁用默认读取用户信息（ApiBoot Security内部提供了默认的表结构，建表后添加数据即可直接使用用户信息进行认证，详见：ApiBoot Security使用文档）。

在application.yml配置文件中添加如下配置：

# ApiBoot配置
api:
  boot:
    security:
      # ApiBoot Security 使用JDBC方式读取用户
      away: jdbc
      # 禁用默认的读取用户方式
      enable-default-store-delegate: false

api.boot.security.enable-default-store-delegate配置参数默认值为true，也就是会自动读取数据源对应数据库内的api_boot_user_info用户信息表，当我们设置为false后需要通过实现ApiBootStoreDelegate接口来进行自定义查询的用户信息。

配置ApiBoot OAuth

api-boot-starter-security-oauth-jwt这个依赖内部也默认集成了OAuth2，而且默认的数据存储方式与Spring Security一致也是内存方式（memory），我们本章的主要目的是查询认证用户信息，而不是客户端信息，所以我们还是采用默认的内存方式，不过修改下客户端的默认配置信息，在application.yml文件内添加配置如下所示：

# ApiBoot配置
api:
  boot:
    oauth:
      # ApiBoot OAuth2的客户端列表
      clients:
        - clientId: hengboy
          clientSecret: chapter
          grantTypes: password,refresh_token

在ApiBoot中OAuth2默认的客户端配置信息，可以通过查看org.minbox.framework.api.boot.autoconfigure.oauth.ApiBootOauthProperties.Client源码了解详情。

用户认证

配置已经完成，下面我们来编写查询用户信息，将用户信息交给ApiBoot Security框架进行认证、生成AccessToken等操作。

本章使用的持久化框架是ApiBoot MyBatis Enhance，具体的使用方法请查看官方文档。

创建用户表

我们在数据库内创建一张名为system_user的系统用户信息表，表结构如下所示：

CREATE TABLE `system_user` (
  `su_id` varchar(36) COLLATE utf8mb4_general_ci NOT NULL COMMENT '用户编号',
  `su_login_name` varchar(30) COLLATE utf8mb4_general_ci DEFAULT NULL COMMENT '登录名',
  `su_nick_name` varchar(30) COLLATE utf8mb4_general_ci DEFAULT NULL COMMENT '昵称',
  `su_password` varchar(200) COLLATE utf8mb4_general_ci DEFAULT NULL COMMENT '用户密码',
  `su_create_time` timestamp NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  `su_status` int(11) DEFAULT '1' COMMENT '用户状态，1：正常，0：冻结，-1：已删除',
  PRIMARY KEY (`su_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='系统用户信息表';

system_user用户表创建完成后，我们往这张表内添加一条用户数据，如下所示：

INSERT INTO `system_user` VALUES ('9b69fd26-14db-11ea-b743-dcd28627348e','yuqiyu','恒宇少年 - 于起宇','$2a$10$RbJGpi.v3PwkjrYENzOzTuMxazuanX3Qa2hwI/f55cYsZhFT/nX3.','2019-12-02 08:13:22',1);

我们在登录时用户名对应su_login_name字段，而密码则是对应su_password字段，yuqiyu这个用户的密码初始化为123456，密码的格式必须为BCryptPasswordEncoder加密后的密文。

创建用户实体

针对system_user表我们需要来创建一个ApiBoot MyBatis Enhance使用的实体，创建一个名为SystemUser的实体如下所示：


/**
 * 系统用户基本信息
 *
 * @author 恒宇少年
 */
@Data
@Table(name = "system_user")
public class SystemUser implements UserDetails {
    /**
     * 用户编号
     */
    @Id(generatorType = KeyGeneratorTypeEnum.UUID)
    @Column(name = "su_id")
    private String userId;
    /**
     * 登录名
     */
    @Column(name = "su_login_name")
    private String loginName;
    /**
     * 昵称
     */
    @Column(name = "su_nick_name")
    private String nickName;
    /**
     * 密码
     */
    @Column(name = "su_password")
    private String password;
    /**
     * 创建时间
     */
    @Column(name = "su_create_time")
    private String createTime;
    /**
     * 用户状态
     * 1：正常，0：已冻结，-1：已删除
     */
    @Column(name = "su_status")
    private Integer status;

    @Override
    public Collection<? extends GrantedAuthority> getAuthorities() {
        return Collections.EMPTY_LIST;
    }

    @Override
    public String getUsername() {
        return this.loginName;
    }

    @Override
    public String getPassword() {
        return this.password;
    }

    /**
     * UserDetails提供的方法，用户是否未过期
     * 可根据自己用户数据表内的字段进行扩展，这里为了演示配置为true
     *
     * @return
     */
    @Override
    public boolean isAccountNonExpired() {
        return true;
    }

    /**
     * UserDetails提供的方法，用户是否未锁定
     * 可根据自己用户数据表内的字段进行扩展，这里为了演示配置为true
     *
     * @return
     */
    @Override
    public boolean isAccountNonLocked() {
        return true;
    }

    /**
     * UserDetails提供的方法，凭证是否未过期
     * 可根据自己用户数据表内的字段进行扩展，这里为了演示配置为true
     *
     * @return
     */
    @Override
    public boolean isCredentialsNonExpired() {
        return true;
    }

    /**
     * UserDetails提供的方法，是否启用
     *
     * @return
     */
    @Override
    public boolean isEnabled() {
        return this.status == 1;
    }
}

具体的注解使用详见ApiBoot MyBatis Enhance文档，这里还一点需要注意的是，SystemUser实现了UserDetails接口，如果使用过Spring Security的同学应该都知道这是Spring Security提供的用户详情接口定义，我们如果自定义查询用户就应该让我们自定义的用户实体（注：这是的自定义用户实体也就是SystemUser实体）实现这个接口并全部实现UserDetails接口内提供的方法。

创建用户数据接口

用户的实体已经创建完成，我们本章需要一个根据用户的登录名来查询用户基本的数据接口，创建一个名为SystemUserEnhanceMapper的接口如下所示：

/**
 * ApiBoot Enhance提供的增强Mapper
 * 自动被扫描并且注册到IOC
 *
 * @author 恒宇少年
 * @see org.minbox.framework.api.boot.autoconfigure.enhance.ApiBootMyBatisEnhanceAutoConfiguration
 */
public interface SystemUserEnhanceMapper extends EnhanceMapper<SystemUser, Integer> {
    /**
     * 根据用户登录名查询用户信息
     *
     * @param loginName {@link SystemUser#getLoginName()}
     * @return {@link SystemUser}
     */
    SystemUser findByLoginName(@Param("loginName") String loginName);
}

该接口继承了EnhanceMapper<Entity,ID>接口，可以自动被扫描到创建代理的实例后并且加入IOC，这样我们在项目其他的地方可以直接注入使用。

注意：findByXxx方法是ApiBoot MyBatis Enhance提供的方法命名规则查询，多个查询条件可以使用And或者Or追加，会自动根据方法的规则生成对应的SQL。

实现ApiBootStoreDelegate接口

ApiBoot Security提供了一个接口ApiBootStoreDelegate，这个接口主要是用来查询登录用户的具体信息的作用，当我们通过grant_type=password&username=xxx的方式进行获取AccessToken时，ApiBoot Security会直接把username的参数值传递给ApiBootStoreDelegate#loadUserByUsername的方法内，这样我们就可以根据username进行查询用户并返回给ApiBoot Security做后续的认证操作。

我们来创建一个名为UserService的类并实现ApiBootStoreDelegate接口，如下所示：


/**
 * 自定义读取用户信息
 *
 * @author 恒宇少年
 */
@Service
public class UserService implements ApiBootStoreDelegate {
    /**
     * logger instance
     */
    static Logger logger = LoggerFactory.getLogger(UserService.class);
    /**
     * 用户数据接口
     */
    @Autowired
    private SystemUserEnhanceMapper mapper;

    @Override
    public UserDetails loadUserByUsername(String username) throws UsernameNotFoundException {
        UserDetails userDetails = mapper.findByLoginName(username);
        if (ObjectUtils.isEmpty(userDetails)) {
            throw new UsernameNotFoundException("用户：" + username + "，不存在.");
        }
        logger.info("登录用户的信息：{}", JSON.toJSONString(userDetails));
        return userDetails;
    }
}

loadUserByUsername方法的返回值是UserDetails接口类型，在之前我们已经将SystemUser实现了该接口，所以我们可以直接将SystemUser实例作为返回值。

运行测试

代码一切就绪，通过XxxxApplication的方式来启动项目。

测试点：获取AccessToken

在获取AccessToken之前，我们需要确认application.yml文件内配置的api.boot.oauth.clients的客户端的clientId、clientSecret配置内容，下面是通过CURL的方式：

➜ ~ curl hengboy:chapter@localhost:9090/oauth/token -d 'grant_type=password&username=yuqiyu&password=123456'
{"access_token":"3beb1bee-9ca6-45e1-9fb8-5fc181670f63","token_type":"bearer","refresh_token":"d2243e18-8ab3-4842-a98f-ebd79da94e2e","expires_in":7199,"scope":"api"}

测试点：刷新AccessToken

复制上面获取到的refresh_token的值进行刷新，下面是刷新AccessToken的CURL方式：

➜ ~ curl hengboy:chapter@localhost:9090/oauth/token -d 'grant_type=refresh_token&refresh_token=d2243e18-8ab3-4842-a98f-ebd79da94e2e'
{"access_token":"e842c2ee-5672-49db-a530-329186f36492","token_type":"bearer","refresh_token":"d2243e18-8ab3-4842-a98f-ebd79da94e2e","expires_in":7199,"scope":"api"}

hengboy这个OAuth2客户端在application.yml中通过配置grantTypes授权了两种grant_type，分别是password、refresh_token，如果需要别的方式可以在配置文件内对应添加。

敲黑板，划重点

ApiBoot整合Spring Security以及OAuth2后读取自定义用户信息，我们只需要关注具体怎么读取用户信息，之前那些懵懵懂懂的代码配置都可以通过配置文件的方式代替，本章的主要内容是ApiBootStoreDelegate这个接口，ApiBoot所提供的功能还不止这些，会陆续分享给大家。

代码示例

微信扫描下图二维码关注“程序员恒宇少年”后，回复“源码”即可获取源码仓库地址。

本章节源码在spring-boot-chapter仓库内目录为SpringBoot2.x/apiboot-security-oauth-custom-certification-user

作者个人博客
使用开源框架 ApiBoot 助你成为Api接口服务架构师

看完这篇文章你还感觉SpringSecurity整合OAuth2

免费教程专题

创建项目

添加ApiBoot统一依赖

添加相关依赖

配置数据源

配置ApiBoot Security

配置ApiBoot OAuth

用户认证

创建用户表

创建用户实体

创建用户数据接口

实现ApiBootStoreDelegate接口

运行测试

测试点：获取AccessToken

测试点：刷新AccessToken

敲黑板，划重点

代码示例

相关文章

网友评论

延伸阅读

深度阅读

栏目导航

热点阅读

ApiBoot 核心技术

Spring Boot 核心技术