摘要：如果全部使用默認(rèn)值的情況話不需要做任何配置方式前提項(xiàng)目需要添加數(shù)據(jù)源依賴。獲取通過獲取啟用在使用格式化時(shí)非常簡單的，配置如下所示開啟轉(zhuǎn)換轉(zhuǎn)換時(shí)所需加密，默認(rèn)為恒宇少年于起宇默認(rèn)不啟用，簽名建議進(jìn)行更換。

ApiBoot是一款基于SpringBoot1.x，2.x的接口服務(wù)集成基礎(chǔ)框架， 內(nèi)部提供了框架的封裝集成、使用擴(kuò)展、自動(dòng)化完成配置，讓接口開發(fā)者可以選著性完成開箱即用， 不再為搭建接口框架而犯愁，從而極大的提高開發(fā)效率。

在pom.xml配置文件內(nèi)添加如下：

    org.minbox.framework
    api-boot-starter-security-oauth-jwt

ApiBoot所提供的依賴都不需要添加版本號(hào)，但是需要添加版本依賴，具體查看ApiBoot版本依賴

ApiBoot在整合SpringSecurity、Oauth2時(shí)把配置參數(shù)進(jìn)行了分離，配置列表如下所示：

ApiBoot在整合SpringSecurity、Oauth2時(shí)配置進(jìn)行了分離，也就意味著我們可以讓SpringSecurity讀取內(nèi)存用戶、Oauth2將生成的AccessToken存放到數(shù)據(jù)庫，當(dāng)然反過來也是可以的，相互不影響?。?！

ApiBoot在整合Spring Security的內(nèi)存方式時(shí)，僅僅需要配置api.boot.security.users用戶列表參數(shù)即可，就是這么的簡單，

配置用戶示例如下所示：

api:
  boot:
    security:
      # Spring Security 內(nèi)存方式用戶列表示例
      users:
        - username: hengboy
          password: 123456
        - username: apiboot
          password: abc321

api.boot.security.users是一個(gè)List類型的集合，所以這里可以配置多個(gè)用戶。

如果全部使用默認(rèn)值的情況話不需要做任何配置！??！

前提：項(xiàng)目需要添加數(shù)據(jù)源依賴。

默認(rèn)用戶表

ApiBoot在整合Spring Security的Jdbc方式時(shí)，在使用ApiBoot提供的默認(rèn)結(jié)構(gòu)用戶表時(shí)只需要修改api.boot.security.away: jdbc即可，ApiBoot提供的用戶表結(jié)構(gòu)如下所示：

CREATE TABLE `api_boot_user_info` (
  `UI_ID` int(11) NOT NULL AUTO_INCREMENT COMMENT "用戶編號(hào)，主鍵自增",
  `UI_USER_NAME` varchar(30) DEFAULT NULL COMMENT "用戶名",
  `UI_NICK_NAME` varchar(50) DEFAULT NULL COMMENT "用戶昵稱",
  `UI_PASSWORD` varchar(255) DEFAULT NULL COMMENT "用戶密碼",
  `UI_EMAIL` varchar(30) DEFAULT NULL COMMENT "用戶郵箱地址",
  `UI_AGE` int(11) DEFAULT NULL COMMENT "用戶年齡",
  `UI_ADDRESS` varchar(200) DEFAULT NULL COMMENT "用戶地址",
  `UI_IS_LOCKED` char(1) DEFAULT "N" COMMENT "是否鎖定",
  `UI_IS_ENABLED` char(1) DEFAULT "Y" COMMENT "是否啟用",
  `UI_STATUS` char(1) DEFAULT "O" COMMENT "O：正常，D：已刪除",
  `UI_CREATE_TIME` timestamp NULL DEFAULT current_timestamp() COMMENT "用戶創(chuàng)建時(shí)間",
  PRIMARY KEY (`UI_ID`)
) ENGINE=InnoDB AUTO_INCREMENT=2 DEFAULT CHARSET=utf8 COMMENT="ApiBoot默認(rèn)的用戶信息表";

自定義用戶表

如果你的系統(tǒng)已經(jīng)存在了自定義用戶表結(jié)構(gòu)，ApiBoot是支持的，而且很簡單就可以完成整合，我們需要先修改api.boot.security.enable-default-store-delegate參數(shù)為false，如下所示：

api:
  boot:
    security:
      # Spring Security jdbc方式用戶列表示例
      enable-default-store-delegate: false
      away: jdbc

添加ApiBootStoreDelegate接口實(shí)現(xiàn)類，如下所示：

@Component
public class DisableDefaultUserTableStoreDelegate implements ApiBootStoreDelegate {

    @Autowired
    private PasswordEncoder passwordEncoder;

    /**
     * 用戶列表示例
     * 從該集合內(nèi)讀取用戶信息
     * 可以使用集合內(nèi)的用戶獲取access_token
     */
    static List users = new ArrayList() {
        {
            add("api-boot");
            add("hengboy");
            add("yuqiyu");
        }
    };

    /**
     * 根據(jù)用戶名查詢用戶信息
     *
     * @param username 用戶名
     * @return
     * @throws UsernameNotFoundException
     */
    @Override
    public UserDetails loadUserByUsername(String username) throws UsernameNotFoundException {
        if (!users.contains(username)) {
            throw new UsernameNotFoundException("用戶：" + username + "不存在");
        }
        return new DisableDefaultUserDetails(username);
    }

    @Data
    @AllArgsConstructor
    @NoArgsConstructor
    class DisableDefaultUserDetails implements UserDetails {
        private String username;

        @Override
        public Collection getAuthorities() {
            return new ArrayList() {
                {
                    add((GrantedAuthority) () -> "ROLE_USER");
                }
            };
        }

        /**
         * 示例密碼使用123456
         *
         * @return
         */
        @Override
        public String getPassword() {
            return passwordEncoder.encode("123456");
        }

        @Override
        public String getUsername() {
            return username;
        }

        @Override
        public boolean isAccountNonExpired() {
            return true;
        }

        @Override
        public boolean isAccountNonLocked() {
            return true;
        }

        @Override
        public boolean isCredentialsNonExpired() {
            return true;
        }

        @Override
        public boolean isEnabled() {
            return true;
        }
    }
}

根據(jù)上面代碼示例，我們可以通過users用戶列表進(jìn)行訪問獲取access_token。

創(chuàng)建Oauth所需表結(jié)構(gòu)

Oauth2如果使用Jdbc方式進(jìn)行存儲(chǔ)access_token、client_details時(shí)，需要在數(shù)據(jù)庫內(nèi)初始化Oauth2所需相關(guān)表結(jié)構(gòu)，oauth-mysql.sql

添加客戶端數(shù)據(jù)

初始化Oauth2表結(jié)構(gòu)后，需要向oauth_client_details表內(nèi)添加一個(gè)客戶端信息，下面是對應(yīng)ApiBoot Security Oauth配置信息的數(shù)據(jù)初始化，如下所示：

INSERT INTO `oauth_client_details` VALUES ("ApiBoot","api","$2a$10$M5t8t1fHatAj949RCHHB/.j1mrNAbxIz.mOYJQbMCcSPwnBMJLmMK","api","password",NULL,NULL,7200,7200,NULL,NULL);

AppSecret加密方式統(tǒng)一使用BCryptPasswordEncoder，數(shù)據(jù)初始化時(shí)需要注意。

在上面memory/jdbc兩種方式已經(jīng)配置完成，接下來我們就可以獲取access_token。

?  ~ curl ApiBoot:ApiBootSecret@localhost:8080/oauth/token -d "grant_type=password&username=api-boot&password=123456"

{"access_token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE1NTMxMDk1MjMsInVzZXJfbmFtZSI6ImFwaS1ib290IiwiYXV0aG9yaXRpZXMiOlsiUk9MRV9VU0VSIl0sImp0aSI6IjBmZTUyY2RlLTBhZjctNDI1YS04Njc2LTFkYTUyZTA0YzUxYiIsImNsaWVudF9pZCI6IkFwaUJvb3QiLCJzY29wZSI6WyJhcGkiXX0.ImqGZssbDEOmpf2lQZjLQsch4ukE0C4SCYJsutfwfx0","token_type":"bearer","expires_in":42821,"scope":"api","jti":"0fe52cde-0af7-425a-8676-1da52e04c51b"}

ApiBoot Security Oauth在使用JWT格式化access_token時(shí)非常簡單的，配置如下所示：

api:
  boot:
    oauth:
      jwt:
        # 開啟Jwt轉(zhuǎn)換AccessToken
        enable: true
        # 轉(zhuǎn)換Jwt時(shí)所需加密key，默認(rèn)為ApiBoot
        sign-key: 恒宇少年 - 于起宇

默認(rèn)不啟用JWT，sign-key簽名建議進(jìn)行更換。

本章源碼地址：https://github.com/hengboy/api-boot/tree/master/api-boot-samples/api-boot-sample-security-oauth-jwt