# Spring security 集成 JustAuth 实现第三方授权登录脚手架:

![justAuthSpringSecurity](https://img.shields.io/badge/justAuthSpringSecurity-1.1.25-green.svg)
![JDK](https://img.shields.io/badge/JDK-1.8+-green.svg)
![Maven](https://img.shields.io/badge/Maven-3.6.3-green.svg)
![MySQL](https://img.shields.io/badge/MySQL-5.7.27-green.svg)
![Redis](https://img.shields.io/badge/Redis-5.0.3-green.svg)
![SpringBoot](https://img.shields.io/badge/SpringBoot-2.3.4-green.svg)
![SpringSecurity](https://img.shields.io/badge/SpringSecurity-5.4.1-green.svg)
![JustAuth](https://img.shields.io/badge/JustAuth-1.15.9-green.svg)
![license](https://img.shields.io/badge/license-MIT-yellow.svg)

## 一、`特性`

[Spring security 集成 JustAuth 实现第三方授权登录](https://gitee.com/pcore/just-auth-spring-security-starter): 此项目从 **用户管理脚手架**(UMS):https://github.com/ZeroOrInfinity/UMS | https://gitee
.com/pcore/UMS) 项目中分离.
1. 支持所有 justAuth 支持的第三方登录，登录后自动注册 或 绑定 或 创建临时用户([TemporaryUser](https://gitee.com/pcore/just-auth-spring-security-starter/blob/master/src/main/java/top/dcenter/ums/security/core/oauth/userdetails/TemporaryUser.java)).
2. 支持定时刷新 accessToken 分布式定时任务,
3. 支持第三方授权登录的用户信息表与 token 信息表的 redis 缓存功能.
4. 支持第三方绑定与解绑及查询接口.
5. 支持一键登录.

### 登录流程图
![登录流程图](doc/登录流程.png)

### 微信群：UMS 添加微信(z56133)备注(UMS) 
![weixin](doc/weixin.png)

------
## 二、`maven`：

```xml
<dependency>
    <groupId>top.dcenter</groupId>
    <artifactId>justAuth-spring-security-starter</artifactId>
    <version>latest</version>
</dependency>
```

------
## 三、使用说明:

### 1. `引入依赖`

```xml
<dependency>
    <groupId>top.dcenter</groupId>
    <artifactId>justAuth-spring-security-starter</artifactId>
    <version>latest</version>
</dependency>
```
### 2. `必须实现的接口`

- 本地用户服务: [UmsUserDetailsService](https://gitee.com/pcore/just-auth-spring-security-starter/blob/master/src/main/java/top/dcenter/ums/security/core/oauth/service/UmsUserDetailsService.java)    
   - 开启一键登录功能时: [OneClickLoginService](https://gitee.com/pcore/just-auth-spring-security-starter/blob/master/src/main/java/top/dcenter/ums/security/core/oauth/oneclicklogin/service/OneClickLoginService.java)

### 3. `必须添加 Auth2AutoConfigurer 到 HttpSecurity`

```java
@Configuration
public class WebSecurityConfig extends WebSecurityConfigurerAdapter {

@Autowired
    private Auth2AutoConfigurer auth2AutoConfigurer;
    @Autowired
    private Auth2Properties auth2Properties;

@Override
    protected void configure(HttpSecurity http) throws Exception {

// ========= start: 使用 justAuth-spring-security-starter 必须步骤 ========= 
        // 添加 Auth2AutoConfigurer 使 OAuth2(justAuth) login 生效.
        http.apply(this.auth2AutoConfigurer);

http.csrf().disable();

// 放行第三方登录入口地址与第三方登录回调地址
        // @formatter:off
        http.authorizeRequests()
                .antMatchers(HttpMethod.GET,
                             auth2Properties.getRedirectUrlPrefix() + "/*",
                             auth2Properties.getAuthLoginUrlPrefix() + "/*")
                .permitAll();
        // @formatter:on
        // ========= end: 使用 justAuth-spring-security-starter 必须步骤 =========

}
}
```
### 4. `属性配置`

- justAuth-spring-security-starter 大部分功能实现都是通过配置文件设置属性来完成的, 详细属性配置请查看`五、属性配置列表`.
------
## 四、接口说明:

- [UmsUserDetailsService](https://gitee.com/pcore/just-auth-spring-security-starter/blob/master/src/main/java/top/dcenter/ums/security/core/oauth/service/UmsUserDetailsService.java): `必须实现`

- [Auth2StateCoder](https://gitee.com/pcore/just-auth-spring-security-starter/blob/master/src/main/java/top/dcenter/ums/security/core/oauth/service/Auth2StateCoder.java): `用户需要时实现`, 对第三方授权登录流程中的 state 进行自定义编解码. 可以传递必要的信息, 
  如: 第三方登录成功的跳转地址等 注意此接口的两个方法必须同时实现对应的编解码逻辑, 实现此接口后注入 IOC 容器即可, 如有前端向后端获取 authorizeUrl
  时向后端传递额外参数 且用作注册时的信息, 需配合 UmsUserDetailsService.registerUser(AuthUser, String, String, String) 方法实现.

- [Auth2UserService](https://gitee.com/pcore/just-auth-spring-security-starter/blob/master/src/main/java/top/dcenter/ums/security/core/oauth/service/Auth2UserService.java): 获取第三方用户信息的接口, 一般**不需要用户实现**, 除非想自定义获取第三方用户信息的逻辑, 实现此接口注入 IOC 容器即可替代.

- [ConnectionService](https://gitee.com/pcore/just-auth-spring-security-starter/blob/master/src/main/java/top/dcenter/ums/security/core/oauth/signup/ConnectionService.java): 第三方授权登录用户的注册, 绑定, 更新第三方用户信息与 accessToken 信息的接口, 一般**不需要用户实现**.
  除非想自定义获取第三方用户信息的逻辑, 实现此接口注入 IOC 容器即可替代.

- [UsersConnectionRepository](https://gitee.com/pcore/just-auth-spring-security-starter/blob/master/src/main/java/top/dcenter/ums/security/core/oauth/repository/UsersConnectionRepository.java): 第三方授权登录的第三方用户信息增删改查, 绑定与解绑及查询是否绑定与解绑接口, 一般**不需要用户实现**. 
    除非想自定义获取第三方用户信息的逻辑, 实现此接口注入 IOC 容器即可替代.
  
  - [UsersConnectionTokenRepository](https://gitee.com/pcore/just-auth-spring-security-starter/blob/master/src/main/java/top/dcenter/ums/security/core/oauth/repository/UsersConnectionTokenRepository.java): 第三方授权登录用户 accessToken 信息表增删改查接口, 一般**不需要用户实现**. 
    除非想自定义获取第三方用户信息的逻辑, 实现此接口注入 IOC 容器即可替代.

> # 取消 OAuth2 的内置数据库说明
  > 
  > ## 一. 同时取消第三方登录的 user_connection 与 auth_token 表
  > ### 1. 属性配置 
  > 
  > ```yaml
  > ums:
  >   oauth:
  >     # 是否支持内置的第三方登录用户表(user_connection) 和 auth_token 表. 默认: true.
  >     # 注意: 如果为 false, 则必须重新实现 ConnectionService 接口.
  >     enable-user-connection-and-auth-token-table: false
  > ```
  > ### 2. 必须重新实现 `top.dcenter.ums.security.core.oauth.signup.ConnectionService` 接口
  > 
  > ## 二. 取消第三方登录 auth_token 表
  > ### 1. 属性配置
  > 
  > ```yaml
  > ums:
  >   oauth:
  >     # 是否支持内置的第三方登录 token 表(auth_token). 默认: true.
  >     enable-auth-token-table: false
  > ```

- 自定义 OAuth2 Login 扩展接口: 内置两个自定义 providerId(ums.oauth.customize 与 ums.oauth.gitlabPrivate)

- [AuthGitlabPrivateSource](https://gitee.com/pcore/just-auth-spring-security-starter/blob/master/src/main/java/top/dcenter/ums/security/core/oauth/justauth/source/AuthGitlabPrivateSource.java): 抽象类, 实现此自定义的 AuthGitlabPrivateSource 且注入 ioc 容器的同时, 必须实现 AuthCustomizeRequest , 会自动集成进 OAuth2 Login 逻辑流程中, 只需要像 JustAuth 默认实现的第三方登录一样, 配置相应的属性(ums.oauth.gitlabPrivate.[clientId|clientSecret]等属性)即可.
    
    - [AuthCustomizeSource](https://gitee.com/pcore/just-auth-spring-security-starter/blob/master/src/main/java/top/dcenter/ums/security/core/oauth/justauth/source/AuthCustomizeSource.java): 抽象类, 实现此自定义的 AuthCustomizeSource 且注入 ioc 容器的同时, 必须实现 AuthCustomizeRequest , 会自动集成进 OAuth2 Login 逻辑流程中, 只需要像 JustAuth 默认实现的第三方登录一样, 配置相应的属性(ums.oauth.customize.[clientId|clientSecret]等属性)即可.
    
    - [AuthCustomizeRequest](https://gitee.com/pcore/just-auth-spring-security-starter/blob/master/src/main/java/top/dcenter/ums/security/core/oauth/justauth/request/AuthCustomizeRequest.java): 抽象类, 实现此自定义的 AuthCustomizeRequest 同时, 必须实现 AuthCustomizeSource 或 AuthGitlabPrivateSource 且注入 ioc 容器, 会自动集成进 OAuth2 Login 逻辑流程中, 只需要像 JustAuth 默认实现的第三方登录一样, 配置相应的属性(ums.oauth.customize.[clientId|clientSecret]等属性)即可.

- [OneClickLoginService](https://gitee.com/pcore/just-auth-spring-security-starter/blob/master/src/main/java/top/dcenter/ums/security/core/oauth/oneclicklogin/service/OneClickLoginService.java): 一键登录功能开启时, `必须实现`此接口, 根据 accessToken 从服务商获取用户手机号.

------
## 五、`Jackson 序列化与反序列化`

- 添加一些 Authentication 与 UserDetails 子类的反序列化器, 以解决 redis 缓存不能反序列化此类型的问题,
具体配置 redis 反序列器的配置请看 [RedisCacheAutoConfiguration.getJackson2JsonRedisSerializer()](https://gitee.com/pcore/just-auth-spring-security-starter/blob/master/src/main/java/top/dcenter/ums/security/core/oauth/config/RedisCacheAutoConfiguration.java) 方法.

```java
// 示例
Jackson2JsonRedisSerializer jackson2JsonRedisSerializer = new Jackson2JsonRedisSerializer(Object.class);
ObjectMapper objectMapper = new ObjectMapper();
// Auth2Jackson2Module 为此项目实现的反序列化配置     
objectMapper.registerModules(new CoreJackson2Module(), new WebJackson2Module(), new Auth2Jackson2Module());
jackson2JsonRedisSerializer.setObjectMapper(om);
```
- 注意: [UmsUserDetailsService](https://gitee.com/pcore/just-auth-spring-security-starter/blob/master/src/main/java/top/dcenter/ums/security/core/oauth/service/UmsUserDetailsService.java)
的注册用户方法返回的 `UserDetails` 的默认实现 `User` 已实现反序列化器, 如果是开发者**自定义的子类**, **需开发者自己实现反序列化器**.

------
## 六、`快速开始(Quick Start)`：

### 1. 添加依赖:

```xml
<dependency>
    <groupId>top.dcenter</groupId>
    <artifactId>justAuth-spring-security-starter</artifactId>
    <version>latest</version>
</dependency>

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <version>2.3.4.RELEASE</version>
</dependency>

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.21</version>
</dependency>

<dependency>
    <groupId>org.apache.httpcomponents</groupId>
    <artifactId>httpclient</artifactId>
    <version>4.5.12</version>
</dependency>
```
#### 依赖说明: 如果是 JDK-1.8 环境, 任选一种 HTTP 工具依赖，项目内如果已有，请忽略。另外需要特别注意，如果项目中已经引入了低版本的依赖，请先排除低版本以后来，引入高版本或者最新版本的依赖

- `hutool-http`
```xml
<dependency>
    <groupId>cn.hutool</groupId>
    <artifactId>hutool-http</artifactId>
    <version>5.2.5</version>
</dependency>
```
- `httpclient`
```xml
<dependency>
	<groupId>org.apache.httpcomponents</groupId>
  	<artifactId>httpclient</artifactId>
  	<version>4.5.12</version>
</dependency>
```
- `okhttp`
```xml
<dependency>
  <groupId>com.squareup.okhttp3</groupId>
  <artifactId>okhttp</artifactId>
  <version>4.4.1</version>
</dependency>
```
### 2. config:

```yaml
server:
  port: 9090

spring:
  profiles:
    active: dev
  # mysql
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://127.0.0.1:3306/ums?useSSL=false&useUnicode=true&characterEncoding=UTF-8&zeroDateTimeBehavior=convertToNull&serverTimezone=Asia/Shanghai
    username: root
    password: 123456

# session 简单配置
  session:
    # session 存储模式设置, 要导入相应的 spring-session 类的依赖, 默认为 none, 分布式应用把 session 放入 redis 等中间件
    store-type: none
    # session 过期时间
    timeout: PT300s

# ums core
ums:
  # ================ 第三方授权登录相关配置 ================
  oauth:
    # 是否支持第三方授权登录功能, 默认: true
    enabled: true
    # 抑制反射警告, 支持 JDK11, 默认: false , 在确认 WARNING: An illegal reflective access operation has occurred 安全后, 可以打开此设置, 可以抑制反射警告.
    suppress-reflect-warning: true
    # 第三方服务商: providerId, 支持所有 JustAuth 支持的第三方授权登录, 目前有 32 家第三方授权登录
    github:
      # 根据是否有设置 clientId 来动态加载相应 JustAuth 的 AuthXxxRequest
      client-id: 4d4ee00e82f669f2ea8d
      client-secret: 953ddbe871a08d6924053531e89ecc01d87195a8
    gitee:
      client-id: dcc38c801ee88f43cfc1d5c52ec579751c12610c37b87428331bd6694056648e
      client-secret: e60a110a2f6e7c930c2d416f802bec6061e19bfa0ceb0df9f6b182b05d8f5a58
    # 第三方登录授权登录 url 前缀, 不包含 ServletContextPath，默认为 /auth2/authorization.
    auth-login-url-prefix: /auth2/authorization
    # 第三方登录回调处理 url 前缀 ，也就是 RedirectUrl 的前缀, 不包含 ServletContextPath，默认为 /auth2/login.
    redirect-url-prefix: /auth2/login
    # 第三方登录回调的域名, 例如：http://localhost:9090 默认为 "http://127.0.0.1"，
    # redirectUrl 直接由 {domain}/{servletContextPath}/{redirectUrlPrefix}/{providerId}(ums.oauth.[qq/gitee/weibo])组成
    domain: http://localhost:9090
    # 第三方授权登录成功后的默认权限, 多个权限用逗号分开, 默认为: "ROLE_USER"
    default-authorities: ROLE_USER

# 用于 JustAuth 的代理(HttpClient)设置
    proxy:      
      # 用于国内代理(HttpClient)超时, 默认 PT3S
      timeout: PT3S
      # 用于国外网站代理(HttpClient)超时, 默认 PT15S
      foreign-timeout: PT150S  
---
spring:
  profiles: dev
  mvc:
    throw-exception-if-no-handler-found: true

#debug: true

server:
  port: 9090
  servlet:
    context-path: /demo
```
### 3. 必须实现 UmsUserDetailsService 接口:

#### UserDetailsServiceImpl.java

```java
import me.zhyd.oauth.model.AuthUser;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.security.core.GrantedAuthority;
import org.springframework.security.core.authority.AuthorityUtils;
import org.springframework.security.core.userdetails.User;
import org.springframework.security.core.userdetails.UserCache;
import org.springframework.security.core.userdetails.UserDetails;
import org.springframework.security.core.userdetails.UsernameNotFoundException;
import org.springframework.security.crypto.password.PasswordEncoder;
import org.springframework.stereotype.Service;
import top.dcenter.ums.security.core.oauth.enums.ErrorCodeEnum;
import top.dcenter.ums.security.core.oauth.exception.RegisterUserFailureException;
import top.dcenter.ums.security.core.oauth.exception.UserNotExistException;
import top.dcenter.ums.security.core.oauth.service.UmsUserDetailsService;

import java.util.List;

/**
 *  用户密码与手机短信登录与注册服务：<br><br>
 *  1. 用于第三方登录与手机短信登录逻辑。<br><br>
 *  2. 用于用户密码登录逻辑。<br><br>
 *  3. 用户注册逻辑。<br><br>
 * @author YongWu zheng
 * @version V1.0  Created by 2020/9/20 11:06
 */
@Service
public class UserDetailsServiceImpl implements UmsUserDetailsService {
    
    private final Logger log = LoggerFactory.getLogger(this.getClass());

@SuppressWarnings("SpringJavaAutowiredFieldsWarningInspection")
    @Autowired(required = false)
    private UserCache userCache;
    /**
     * 用于密码加解密
     */
    @SuppressWarnings("SpringJavaAutowiredFieldsWarningInspection")
    @Autowired
    private PasswordEncoder passwordEncoder;

@SuppressWarnings("AlibabaUndefineMagicConstant")
    @Override
    public UserDetails loadUserByUsername(String username) throws UsernameNotFoundException {

try
        {
            // 从缓存中查询用户信息:
            // 从缓存中查询用户信息
            if (this.userCache != null)
            {
                UserDetails userDetails = this.userCache.getUserFromCache(username);
                if (userDetails != null)
                {
                    return userDetails;
                }
            }
            // 根据用户名获取用户信息

// 获取用户信息逻辑。。。
            // ...

// 示例：只是从用户登录日志表中提取的信息，
            log.info("Demo ======>: 登录用户名：{}, 登录成功", username);
            return new User(username,
                            passwordEncoder.encode("admin"),
                            true,
                            true,
                            true,
                            true,
                            AuthorityUtils.commaSeparatedStringToAuthorityList("ROLE_VISIT, ROLE_USER"));

}
        catch (Exception e)
        {
            String msg = String.format("Demo ======>: 登录用户名：%s, 登录失败: %s", username, e.getMessage());
            log.error(msg);
            throw new UserNotExistException(ErrorCodeEnum.QUERY_USER_INFO_ERROR, e, username);
        }
    }

@Override
    public UserDetails registerUser(AuthUser authUser, String username, String defaultAuthority, String decodeState) throws RegisterUserFailureException {

// 第三方授权登录不需要密码, 这里随便设置的, 生成环境按自己的逻辑
        String encodedPassword = passwordEncoder.encode(authUser.getUuid());

// 这里的 decodeState 可以根据自己实现的 top.dcenter.ums.security.core.oauth.service.Auth2StateCoder 接口的逻辑来传递必要的参数.
        // 比如: 第三方登录成功后的跳转地址
        final RequestAttributes requestAttributes = RequestContextHolder.getRequestAttributes();
        // 假设 decodeState 就是 redirectUrl, 我们直接把 redirectUrl 设置到 request 上
        // 后续经过成功处理器时直接从 requestAttributes.getAttribute("redirectUrl", RequestAttributes.SCOPE_REQUEST) 获取并跳转
        requestAttributes.setAttribute("redirectUrl", decodeState, RequestAttributes.SCOPE_REQUEST);
        // 当然 decodeState 也可以传递从前端传到后端的用户信息, 注册到本地用户
        
        List<GrantedAuthority> grantedAuthorities = AuthorityUtils.commaSeparatedStringToAuthorityList(defaultAuthority);

// ... 用户注册逻辑

log.info("Demo ======>: 用户名：{}, 注册成功", username);

// @formatter:off
        UserDetails user = User.builder()
                               .username(username)
                               .password(encodedPassword)
                               .disabled(false)
                               .accountExpired(false)
                               .accountLocked(false)
                               .credentialsExpired(false)
                               .authorities(grantedAuthorities)
                               .build();
        // @formatter:off

// 把用户信息存入缓存
        if (userCache != null)
        {
            userCache.putUserInCache(user);
        }

return user;
    }

@Override
    public UserDetails loadUserByUserId(String userId) throws UsernameNotFoundException {
        UserDetails userDetails = loadUserByUsername(userId);
        User.withUserDetails(userDetails);
        return User.withUserDetails(userDetails).build();
    }

/**
     * {@link #existedByUsernames(String...)} usernames 生成规则.
     * 如需自定义重新实现此逻辑
     * @param authUser     第三方用户信息
     * @return  返回一个 username 数组
     */
    @Override
    public String[] generateUsernames(AuthUser authUser) {
        return new String[]{
                authUser.getUsername(),
                // providerId = authUser.getSource()
                authUser.getUsername() + "_" + authUser.getSource(),
                // providerUserId = authUser.getUuid()
                authUser.getUsername() + "_" + authUser.getSource() + "_" + authUser.getUuid()
        };
    }

@Override
    public List<Boolean> existedByUsernames(String... usernames) throws UsernameNotFoundException {
        // ... 在本地账户上查询 userIds 是否已被使用
        List<Boolean> list = new ArrayList<>();
        list.add(true);
        list.add(false);
        list.add(false);

return list;
    }

}

```

### 4. 必须添加 top.dcenter.ums.security.core.oauth.config.Auth2AutoConfigurer 到 HttpSecurity

#### WebSecurityConfig.java

```java
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.HttpMethod;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;
import org.springframework.security.crypto.factory.PasswordEncoderFactories;
import org.springframework.security.crypto.password.PasswordEncoder;
import top.dcenter.ums.security.core.oauth.config.Auth2AutoConfigurer;
import top.dcenter.ums.security.core.oauth.properties.Auth2Properties;

/**
 * web security config
 * @author YongWu zheng
 * @version V2.0  Created by 2020/10/18 22:39
 */
@Configuration
public class WebSecurityConfig extends WebSecurityConfigurerAdapter {

@Autowired
    private Auth2AutoConfigurer auth2AutoConfigurer;
    @Autowired
    private Auth2Properties auth2Properties;

@Bean
    public PasswordEncoder passwordEncoder() {
        /*
            默认为 BCryptPasswordEncoder 的实现了添加随机 salt 算法，并且能从hash后的字符串中获取 salt 进行原始密码与hash后的密码的对比
            支持格式:
            {bcrypt}$2a$10$dXJ3SW6G7P50lGmMkkmwe.20cQQubK3.HZWzG3YB1tlRy.fqvM/BG
            {noop}password
            {pbkdf2}5d923b44a6d129f3ddf3e3c8d29412723dcbde72445e8ef6bf3b508fbf17fa4ed4d6b99ca763d8dc
            {scrypt}$e0801$8bWJaSu2IKSn9Z9kM+TPXfOc/9bdYSrN1oD9qfVThWEwdRTnO7re7Ei+fUZRJ68k9lTyuTeUp4of4g24hHnazw==$OAOec05+bXxvuu/1qZ6NUR+xQYvYv7BeL1QxwRpY5Pc=
            {sha256}97cde38028ad898ebc02e690819fa220e88c62e0699403e94fff291cfffaf8410849f27605abcbc0
         */
        return PasswordEncoderFactories.createDelegatingPasswordEncoder();
    }

@Override
    protected void configure(HttpSecurity http) throws Exception {

http.formLogin()
            .loginPage("/login.html")
            .defaultSuccessUrl("/index.html");
        http.logout().logoutSuccessUrl("/login.html");

http.csrf().disable();

// ========= start: 使用 justAuth-spring-security-starter 必须步骤 ========= 
        // 添加 Auth2AutoConfigurer 使 OAuth2(justAuth) login 生效.
        http.apply(this.auth2AutoConfigurer);

// 放行第三方登录入口地址与第三方登录回调地址
        // @formatter:off
        http.authorizeRequests()
                .antMatchers(HttpMethod.GET,
                             auth2Properties.getRedirectUrlPrefix() + "/*",
                             auth2Properties.getAuthLoginUrlPrefix() + "/*")
                .permitAll();
        // @formatter:on
        // ========= end: 使用 justAuth-spring-security-starter 必须步骤 =========

http.authorizeRequests().anyRequest().permitAll();
    }
}
```

### 4. 前端页面 :

#### login.html: 放在 classpath:/static

```html
<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>登录</title>

</head>
<body>
<h2>登录页面</h2>
<h3>社交登录</h3>
<a href="/demo/auth2/authorization/gitee">gitee登录</a>
<a href="/demo/auth2/authorization/github">github登录</a>
<a href="/demo/auth2/authorization/qq">qq登录</a>
</body>
</html>
```
#### index.html: 放在 classpath:/static

```html
<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>index</title>
</head>
<body>
hello world!<br>
    <form action="/demo/logout?logout" method="post">
        <input type="submit" value="退出登录post"/>
    </form>

<br>
<br>
<a href="/demo/auth2/authorization/gitee">gitee登录</a>
<a href="/demo/auth2/authorization/github">github登录</a>
<a href="/demo/auth2/authorization/qq">qq登录</a>
</body>
</html>
```
### 5. 访问前端页面

- 浏览器访问 `http://localhost:9090/demo/login.html`, 至此集成了：第三方登录([justAuth-spring-security-starter](https://gitee.com/pcore/just-auth-spring-security-starter)); 实现快速开发。
- 详细配置配置在: [justAuth-security-oauth2-example](https://gitee.com/pcore/just-auth-spring-security-starter/tree/master/demo/justAuth-security-oauth2-example)
------

## 七、`时序图`: 随着版本迭代会有出入

![第三方授权登录](doc/OAuth2Login.png)

------
## 八、`属性配置列表`

###  OAuth2 / refreshToken 定时任务 / JustAuth 配置属性

| **属性**                                                     | **类型**       | **默认值**           | **描述**                                                     | **可选项**            |
| ------------------------------------------------------------ | -------------- | -------------------- | ------------------------------------------------------------ | --------------------- |
| ums.oauth.autoSignUp                                            | Boolean        | true                 | 第三方授权登录后如未注册用户是否支持自动注册功能, 默认: true                       | true/false            |
| ums.oauth.signUpUrl                                            | String        | /signUp.html                 | 第三方授权登录后如未注册用户不支持自动注册功能, 则跳转到此 url 进行注册逻辑, 此 url 必须开发者自己实现; 默认: `/signUp.html`; 例如: 1. 设置值 `"/signUp"`, 则跳转指定到 `"/signUp"` 进行注册. 2. 想返回自定义 json 数据到前端, 这里要设置 null , 在 `Auth2LoginAuthenticationFilter` 设置的 `AuthenticationSuccessHandler` 上处理返回 json; 判断是否为临时用户的条件是: `Authentication.getPrincipal()` 是否为 `TemporaryUser` 类型.                       |             |
| ums.oauth.temporaryUserPassword                                            | String        | ""                 | 用于第三方授权登录时, 未开启自动注册且用户是第一次授权登录的临时用户密码, 默认为: "". 注意: 生产环境更换密码                       |             |
| ums.oauth.temporaryUserAuthorities                                            | String        | "ROLE_TEMPORARY_USER"                 | 用于第三方授权登录时, 未开启自动注册且用户是第一次授权登录的临时用户的默认权限, 多个权限用逗号分开, 默认为: "ROLE_TEMPORARY_USER"                       |             |
| ums.oauth.domain                                             | String         | http://127.0.0.1     | 第三方登录回调的域名, 例如：https://localhost 默认为 "http://127.0.0.1"， redirectUrl 直接由 `{domain}/{servletContextPath}/{redirectUrlPrefix}/{providerId}(ums.oauth.[qq/gitee/weibo])`组成 |                       |
| ums.oauth.redirectUrlPrefix                                  | String         | /oauth/login         | 第三方登录回调处理 url 前缀 ，也就是 `RedirectUrl` 的前缀, 不包含 `ServletContextPath`，默认为 `/oauth/login` |                       |
| ums.oauth.authLoginUrlPrefix                                 | String         | /oauth/authorization | 第三方登录授权登录 url 前缀, 不包含 `ServletContextPath`，默认为 `/oauth/authorization` |                       |
| ums.oauth.temporaryUserAuthorities                                 | String         | ROLE_USER            | 第三方授权登录成功后的默认权限, 多个权限用逗号分开, 默认为: "ROLE_USER" |                       |
| ums.oauth.suppressReflectWarning                | Boolean                 | false                                  | 抑制反射警告, 支持 JDK11, 默认: false , 在确认 WARNING: An illegal reflective access operation has occurred 安全后, 可以打开此设置, 可以抑制反射警告. | true/false                         |
| ums.oauth.enableUserConnectionAndAuthTokenTable | Boolean | true | 是否支持内置的第三方登录用户表(`user_connection`) 和 第三方登录 `token `表(`auth_token`). 默认: `true`. 注意: 如果为 `false`, 则必须重新实现 `ConnectionService `接口. | true/false |
| ums.oauth.enableAuthTokenTable | Boolean | true | 是否支持内置的第三方登录 `token `表(`auth_token`). 默认: `true`. | true/false |
| **refreshToken 定时任务**                                    |                |                      |                                                              |                       |
| ums.oauth.refreshTokenJobCron                                | String         | 0 * 2 * * ?          | A cron-like expression.<br/>       `0 * 2 * * ?` 分别对应: `second/minute/hour/day of month/month/day of week`<br/>       <br/>默认为: "0 * 2 * * ?", 凌晨 2 点启动定时任务, 支持分布式(分布式 IOC 容器中必须有 `RedisConnectionFactory`, 也就是说, 是否分布式执行依据 IOC 容器中是否有 `RedisConnectionFactory`) |                       |
| ums.oauth.enableRefreshTokenJob                              | Boolean        | false                | 是否支持定时刷新 `AccessToken` 定时任务, 考虑到很多应用都有自己的定时任务应用, 默认: `false`. `RefreshTokenJob` 接口的实现已注入 IOC 容器, 方便自定义定时任务接口时调用. 支持分布式(分布式 IOC 容器中必须有 `RedisConnectionFactory`, 也就是说, 是否分布式执行依据 IOC 容器中是否有 `RedisConnectionFactory`) | true/false            |
| ums.oauth.batchCount                                         | Integer        | 1000                 | 定时刷新 `accessToken` 任务时, 批处理数据库的记录数. 注意: 分布式应用时, 此配置不同服务器配置必须是一样的. `batchCount` 大小需要根据实际生产环境进行优化 |                       |
| ums.oauth.remainingExpireIn                                  | Integer        | 24                   | `accessToken` 的剩余有效期内进行刷新 `accessToken`, 默认: 24, 单位: 小时. 注意: 需要根据实际生产环境进行优化 |                       |
| **justAuth**                                                 |                |                      |                                                              |                       |
| ums.oauth.justAuth.ignoreCheckState                          | Boolean        | false                | 忽略校验 state 参数，默认不开启。当 ignoreCheckState 为 true 时， me.zhyd.oauth.request.AuthDefaultRequest.login(AuthCallback) 将不会校验 state 的合法性。<br/>使用场景：当且仅当使用自实现 state 校验逻辑时开启<br/>以下场景使用方案仅作参考： 1. 授权、登录为同端，并且全部使用 JustAuth 实现时，该值建议设为 false; 2. 授权和登录为不同端实现时，比如前端页面拼装 authorizeUrl，并且前端自行对state进行校验， 后端只负责使用code获取用户信息时，该值建议设为 true; 如非特殊需要，不建议开启这个配置<br/>该方案主要为了解决以下类似场景的问题： | true/false            |
| ums.oauth.justAuth.timeout                                   | Duration       | PT180S               | 默认 state 缓存过期时间：3分钟(PT180S) 鉴于授权过程中，根据个人的操作习惯，或者授权平台的不同（google等），每个授权流程的耗时也有差异，不过单个授权流程一般不会太长 本缓存工具默认的过期时间设置为3分钟，即程序默认认为3分钟内的授权有效，超过3分钟则默认失效，失效后删除 |                       |
| ums.oauth.justAuth.cacheType                                 | StateCacheType | SESSION              | JustAuth state 缓存类型, 默认 session                        | DEFAULT/SESSION/REDIS |
| ums.oauth.justAuth.cacheKeyPrefix                            | String         | JUST_AUTH:           | JustAuth state 缓存 key 前缀                                 |                       |
| **proxy**                                                    |                |                      |                                                              |                       |
| ums.oauth.proxy.enable                                       | Boolean        | false                | 是否支持代理, 默认为: false. 当为 false 时, 其他属性都失效.  | true/false            |
| ums.oauth.proxy.proxy                                        | Proxy.Type     | HTTP                 | 针对国外服务可以单独设置代理类型, 默认 Proxy.Type.HTTP       | HTTP/DIRECT/SOCKS     |
| ums.oauth.proxy.hostname                                     | String         |                      | 代理 host, enable = true 时生效.                             |                       |
| ums.oauth.proxy.port                                         | Integer        |                      | 代理端口, enable = true 时生效.                              |                       |
| ums.oauth.proxy.timeout                                      | Duration       | PT3S                 | 代理超时, 默认 PT3S                                          |                       |
| ums.oauth.proxy.foreignTimeout                               | Duration       | PT15S                | 用于国外网站代理超时, 默认 PT15S                             |                       |
| **github**                                                   |                |                      |                                                              |                       |
| ums.oauth.github.clientId                                    | String         |                      | `client Id`                                                  |                       |
| ums.oauth.github.clientSecret                                | String         |                      | `client Secret`                                              |                       |
| ums.oauth.github.scopes                                  | List<String>         |                | 支持自定义授权平台的 scope 内容, 格式参考对应的 AuthScope.getScope() 的子类. 注意: 会自动添加默认的 scope 设置.                                          |                       |
| **weibo**                                                    |                |                      |                                                              |                       |
| ums.oauth.weibo.clientId                                     | String         |                      | `client Id`                                                  |                       |
| ums.oauth.weibo.clientSecret                                 | String         |                      | `client Secret`                                              |                       |
| ums.oauth.weibo.scopes                                  | List<String>         |                | 支持自定义授权平台的 scope 内容, 格式参考对应的 AuthScope.getScope() 的子类. 注意: 会自动添加默认的 scope 设置.                                          |                       |
| **gitee**                                                    |                |                      |                                                              |                       |
| ums.oauth.gitee.clientId                                     | String         |                      | `client Id`                                                  |                       |
| ums.oauth.gitee.clientSecret                                 | String         |                      | `client Secret`                                              |                       |
| ums.oauth.gitee.scopes                                  | List<String>         |                | 支持自定义授权平台的 scope 内容, 格式参考对应的 AuthScope.getScope() 的子类. 注意: 会自动添加默认的 scope 设置.                                          |                       |
| **dingtalk**                                                 |                |                      |                                                              |                       |
| ums.oauth.dingtalk.clientId                                  | String         |                      | `client Id`                                                  |                       |
| ums.oauth.dingtalk.clientSecret                              | String         |                      | `client Secret`                                              |                       |
| **baidu**                                                    |                |                      |                                                              |                       |
| ums.oauth.baidu.clientId                                     | String         |                      | `client Id`                                                  |                       |
| ums.oauth.baidu.clientSecret                                 | String         |                      | `client Secret`                                              |                       |
| ums.oauth.baidu.scopes                                  | List<String>         |                | 支持自定义授权平台的 scope 内容, 格式参考对应的 AuthScope.getScope() 的子类. 注意: 会自动添加默认的 scope 设置.                                          |                       |
| **coding**                                                   |                |                      |                                                              |                       |
| ums.oauth.coding.clientId                                    | String         |                      | `client Id`                                                  |                       |
| ums.oauth.coding.clientSecret                                | String         |                      | `client Secret`                                              |                       |
| ums.oauth.coding.codingGroupName                             | String         |                      | 使用 Coding 登录时，需要传该值。<br/>团队域名前缀，比如以“ https://justauth.coding.net/ ”为例，``codingGroupName = justauth` |                       |
| ums.oauth.coding.scopes                                  | List<String>         |                | 支持自定义授权平台的 scope 内容, 格式参考对应的 AuthScope.getScope() 的子类. 注意: 会自动添加默认的 scope 设置.                                          |                       |
| **oschina**                                                  |                |                      |                                                              |                       |
| ums.oauth.oschina.clientId                                   | String         |                      | `client Id`                                                  |                       |
| ums.oauth.oschina.clientSecret                               | String         |                      | `client Secret`                                              |                       |
| **alipay**                                                   |                |                      |                                                              |                       |
| ums.oauth.alipay.clientId                                    | String         |                      | `client Id`                                                  |                       |
| ums.oauth.alipay.clientSecret                                | String         |                      | `client Secret`                                              |                       |
| ums.oauth.alipay.alipayPublicKey                             | String         |                      | 支付宝公钥：当选择支付宝登录时，该值可用 对应“RSA2(SHA256)密钥”中的“支付宝公钥” |                       |
| ums.oauth.alipay.proxyHost                             | String         |                      | 支付宝: 支付宝有自己的代理, 默认代理对支付宝不生效, 代理主机: |                       |
| ums.oauth.alipay.proxyPort                             | Integer         |                      | 支付宝: 支付宝有自己的代理, 默认代理对支付宝不生效, 代理端口: |                       |
| **qq**                                                       |                |                      |                                                              |                       |
| ums.oauth.qq.clientId                                        | String         |                      | `client Id`                                                  |                       |
| ums.oauth.qq.clientSecret                                    | String         |                      | `client Secret`                                              |                       |
| ums.oauth.qq.unionId                                         | String         |                      | 是否需要申请 unionId，默认: false. 目前只针对qq登录 注：qq授权登录时，获取 unionId 需要单独发送邮件申请权限。如果个人开发者账号中申请了该权限，可以将该值置为true，在获取openId时就会同步获取unionId 参考链接：http://wiki.connect.qq.com/unionid%E4%BB%8B%E7%BB%8D |                       |
| ums.oauth.qq.scopes                                  | List<String>         |                | 支持自定义授权平台的 scope 内容, 格式参考对应的 AuthScope.getScope() 的子类. 注意: 会自动添加默认的 scope 设置.                                          |                       |
| **wechatOpen**                                               |                |                      |                                                              |                       |
| ums.oauth.wechatOpen.clientId                                | String         |                      | `client Id`                                                  |                       |
| ums.oauth.wechatOpen.clientSecret                            | String         |                      | `client Secret`                                              |                       |
| **wechatMp**                                                 |                |                      |                                                              |                       |
| ums.oauth.wechatMp.clientId                                  | String         |                      | `client Id`                                                  |                       |
| ums.oauth.wechatMp.clientSecret                              | String         |                      | `client Secret`                                              |                       |
| ums.oauth.wechatMp.scopes                                  | List<String>         |                | 支持自定义授权平台的 scope 内容, 格式参考对应的 AuthScope.getScope() 的子类. 注意: 会自动添加默认的 scope 设置.                                          |                       |
| **taobao**                                                   |                |                      |                                                              |                       |
| ums.oauth.taobao.clientId                                    | String         |                      | `client Id`                                                  |                       |
| ums.oauth.taobao.clientSecret                                | String         |                      | `client Secret`                                              |                       |
| ums.oauth.taobao.scopes                                  | List<String>         |                | 支持自定义授权平台的 scope 内容, 格式参考对应的 AuthScope.getScope() 的子类. 注意: 会自动添加默认的 scope 设置.                                          |                       |
| **google**                                                   |                |                      |                                                              |                       |
| ums.oauth.google.clientId                                    | String         |                      | `client Id`                                                  |                       |
| ums.oauth.google.clientSecret                                | String         |                      | `client Secret`                                              |                       |
| ums.oauth.google.scopes                                  | List<String>         |                | 支持自定义授权平台的 scope 内容, 格式参考对应的 AuthScope.getScope() 的子类. 注意: 会自动添加默认的 scope 设置.                                          |                       |
| **facebook**                                                 |                |                      |                                                              |                       |
| ums.oauth.facebook.clientId                                  | String         |                      | `client Id`                                                  |                       |
| ums.oauth.facebook.clientSecret                              | String         |                      | `client Secret`                                              |                       |
| ums.oauth.facebook.scopes                                  | List<String>         |                | 支持自定义授权平台的 scope 内容, 格式参考对应的 AuthScope.getScope() 的子类. 注意: 会自动添加默认的 scope 设置.                                          |                       |
| **github**                                                   |                |                      |                                                              |                       |
| ums.oauth.github.clientId                                    | String         |                      | `client Id`                                                  |                       |
| ums.oauth.github.clientSecret                                | String         |                      | `client Secret`                                              |                       |
| ums.oauth.github.scopes                                  | List<String>         |                | 支持自定义授权平台的 scope 内容, 格式参考对应的 AuthScope.getScope() 的子类. 注意: 会自动添加默认的 scope 设置.                                          |                       |
| **douyin**                                                   |                |                      |                                                              |                       |
| ums.oauth.douyin.clientId                                    | String         |                      | `client Id`                                                  |                       |
| ums.oauth.douyin.clientSecret                                | String         |                      | `client Secret`                                              |                       |
| **linkedin**                                                 |                |                      |                                                              |                       |
| ums.oauth.linkedin.clientId                                  | String         |                      | `client Id`                                                  |                       |
| ums.oauth.linkedin.clientSecret                              | String         |                      | `client Secret`                                              |                       |
| ums.oauth.linkedin.scopes                                  | List<String>         |                | 支持自定义授权平台的 scope 内容, 格式参考对应的 AuthScope.getScope() 的子类. 注意: 会自动添加默认的 scope 设置.                                          |                       |
| **microsoft**                                                |                |                      |                                                              |                       |
| ums.oauth.microsoft.clientId                                 | String         |                      | `client Id`                                                  |                       |
| ums.oauth.microsoft.clientSecret                             | String         |                      | `client Secret`                                              |                       |
| ums.oauth.microsoft.scopes                                  | List<String>         |                | 支持自定义授权平台的 scope 内容, 格式参考对应的 AuthScope.getScope() 的子类. 注意: 会自动添加默认的 scope 设置.                                          |                       |
| **mi**                                                       |                |                      |                                                              |                       |
| ums.oauth.mi.clientId                                        | String         |                      | `client Id`                                                  |                       |
| ums.oauth.mi.clientSecret                                    | String         |                      | `client Secret`                                              |                       |
| ums.oauth.mi.scopes                                  | List<String>         |                | 支持自定义授权平台的 scope 内容, 格式参考对应的 AuthScope.getScope() 的子类. 注意: 会自动添加默认的 scope 设置.                                          |                       |
| **toutiao**                                                  |                |                      |                                                              |                       |
| ums.oauth.toutiao.clientId                                   | String         |                      | `client Id`                                                  |                       |
| ums.oauth.toutiao.clientSecret                               | String         |                      | `client Secret`                                              |                       |
| **teambition**                                               |                |                      |                                                              |                       |
| ums.oauth.teambition.clientId                                | String         |                      | `client Id`                                                  |                       |
| ums.oauth.teambition.clientSecret                            | String         |                      | `client Secret`                                              |                       |
| **renren**                                                   |                |                      |                                                              |                       |
| ums.oauth.renren.clientId                                    | String         |                      | `client Id`                                                  |                       |
| ums.oauth.renren.clientSecret                                | String         |                      | `client Secret`                                              |                       |
| ums.oauth.renren.scopes                                  | List<String>         |                | 支持自定义授权平台的 scope 内容, 格式参考对应的 AuthScope.getScope() 的子类. 注意: 会自动添加默认的 scope 设置.                                          |                       |
| **pinterest**                                                |                |                      |                                                              |                       |
| ums.oauth.pinterest.clientId                                 | String         |                      | `client Id`                                                  |                       |
| ums.oauth.pinterest.clientSecret                             | String         |                      | `client Secret`                                              |                       |
| ums.oauth.pinterest.scopes                                  | List<String>         |                | 支持自定义授权平台的 scope 内容, 格式参考对应的 AuthScope.getScope() 的子类. 注意: 会自动添加默认的 scope 设置.                                          |                       |
| **stackOverflow**                                            |                |                      |                                                              |                       |
| ums.oauth.stackOverflow.clientId                             | String         |                      | `client Id`                                                  |                       |
| ums.oauth.stackOverflow.clientSecret                         | String         |                      | `client Secret`                                              |                       |
| ums.oauth.stackOverflow.stackOverflowKey                     | String         |                      | Stack Overflow Key                                           |                       |
| ums.oauth.stackOverflow.scopes                                  | List<String>         |                | 支持自定义授权平台的 scope 内容, 格式参考对应的 AuthScope.getScope() 的子类. 注意: 会自动添加默认的 scope 设置.                                          |                       |
| **huawei**                                                   |                |                      |                                                              |                       |
| ums.oauth.huawei.clientId                                    | String         |                      | `client Id`                                                  |                       |
| ums.oauth.huawei.clientSecret                                | String         |                      | `client Secret`                                              |                       |
| ums.oauth.huawei.scopes                                  | List<String>         |                | 支持自定义授权平台的 scope 内容, 格式参考对应的 AuthScope.getScope() 的子类. 注意: 会自动添加默认的 scope 设置.                                          |                       |
| **wechatEnterprise 企业微信二维码版**                                         |                |                      |                                                              |                       |
| ums.oauth.wechatEnterprise.clientId                          | String         |                      | `client Id`                                                  |                       |
| ums.oauth.wechatEnterprise.clientSecret                      | String         |                      | `client Secret`                                              |                       |
| ums.oauth.wechatEnterprise.agentId                           | String         |                      | 企业微信，授权方的网页应用ID                                 |                       |
| **kujiale**                                                  |                |                      |                                                              |                       |
| ums.oauth.kujiale.clientId                                   | String         |                      | `client Id`                                                  |                       |
| ums.oauth.kujiale.clientSecret                               | String         |                      | `client Secret`                                              |                       |
| ums.oauth.kujiale.scopes                                  | List<String>         |                | 支持自定义授权平台的 scope 内容, 格式参考对应的 AuthScope.getScope() 的子类. 注意: 会自动添加默认的 scope 设置.                                          |                       |
| **gitlab**                                                   |                |                      |                                                              |                       |
| ums.oauth.gitlab.clientId                                    | String         |                      | `client Id`                                                  |                       |
| ums.oauth.gitlab.clientSecret                                | String         |                      | `client Secret`                                              |                       |
| ums.oauth.gitlab.scopes                                  | List<String>         |                | 支持自定义授权平台的 scope 内容, 格式参考对应的 AuthScope.getScope() 的子类. 注意: 会自动添加默认的 scope 设置.                                          |                       |
| **meituan**                                                  |                |                      |                                                              |                       |
| ums.oauth.meituan.clientId                                   | String         |                      | `client Id`                                                  |                       |
| ums.oauth.meituan.clientSecret                               | String         |                      | `client Secret`                                              |                       |
| **eleme**                                                    |                |                      |                                                              |                       |
| ums.oauth.eleme.clientId                                     | String         |                      | `client Id`                                                  |                       |
| ums.oauth.eleme.clientSecret                                 | String         |                      | `client Secret`                                              |                       |
| **twitter**                                                  |                |                      |                                                              |                       |
| ums.oauth.twitter.clientId                                   | String         |                      | `client Id`                                                  |                       |
| ums.oauth.twitter.clientSecret                               | String         |                      | `client Secret`                                              |                       |
| **jd**                                                       |                |                      |                                                              |                       |
| ums.oauth.jd.clientId                                        | String         |                      | `client Id`                                                  |                       |
| ums.oauth.jd.clientSecret                                    | String         |                      | `client Secret`                                              |                       |
| ums.oauth.jd.scopes                                  | List<String>         |                | 支持自定义授权平台的 scope 内容, 格式参考对应的 AuthScope.getScope() 的子类. 注意: 会自动添加默认的 scope 设置.                                          |                       |
| **aliyun**                                                   |                |                      |                                                              |                       |
| ums.oauth.aliyun.clientId                                    | String         |                      | `client Id`                                                  |                       |
| ums.oauth.aliyun.clientSecret                                | String         |                      | `client Secret`                                              |                       |
| **feishu**                                                   |                |                      |                                                              |                       |
| ums.oauth.feishu.clientId                                    | String         |                      | `client Id`                                                  |                       |
| ums.oauth.feishu.clientSecret                                | String         |                      | `client Secret`                                              |                       |
| **xmly 喜马拉雅**                                                   |                |                      |                                                              |                       |
| ums.oauth.xmly.clientId                                    | String         |                      | `client Id`                                                  |                       |
| ums.oauth.xmly.clientSecret                                | String         |                      | `client Secret`                                              |                       |
| ums.oauth.xmly.deviceId                                  | String         |                | 喜马拉雅：设备ID, `设备唯一标识ID `                                           |                       |
| ums.oauth.xmly.clientOsType                                  | Integer         |                | 喜马拉雅：客户端操作系统类型，`1-iOS系统，2-Android系统，3-Web`                                           |                       |
| ums.oauth.xmly.packId                                  | String         |                | 喜马拉雅：客户端包名，如果 `AuthConfig#getClientOsType()` 为1或2时必填。对`Android`客户端是包名，对`IOS`客户端是`Bundle ID `           |                       |
| **wechatEnterpriseWeb 企业微信网页版**                                                   |                |                      |                                                              |                       |
| ums.oauth.wechatEnterpriseWeb.clientId                          | String         |                      | `client Id`                                                  |                       |
| ums.oauth.wechatEnterpriseWeb.clientSecret                      | String         |                      | `client Secret`                                              |                       |
| ums.oauth.wechatEnterpriseWeb.agentId                           | String         |                      | 企业微信，授权方的网页应用ID                                 |                       |
| ums.oauth.wechatEnterpriseWeb.scopes                                  | List<String>         |                | 支持自定义授权平台的 scope 内容, 格式参考对应的 AuthScope.getScope() 的子类. 注意: 会自动添加默认的 scope 设置.                                          |                       |
| **customize**                                                   |                |                      |                                                              |                       |
| ums.oauth.customize.clientId                                    | String         |                      | `client Id`                                                  |                       |
| ums.oauth.customize.clientSecret                                | String         |                      | `client Secret`                                              |                       |
| ums.oauth.customize.customizeProviderId                                | String         |                      | 自定义第三方授权登录, 当 `Auth2Properties#customize` 时有效, 此字段必须以驼峰方式命名. 比如此字段的值为 `umsCustomize`, 那么 `/auth2/authorization/customize` 会替换为 `/auth2/authorization/umsCustomize`                                              |                       |
| ums.oauth.customize.customizeIsForeign                                | Boolean         | false                     | 自定义第三方授权登录, 当 `Auth2Properties#customize` 时有效, 设置第三方是否在国外, 默认: `false`. 如果为 `false` 时, 设置 `HttpConfig` 的超时时间为 `ums.oauth.proxy.timeout` 的值. 如果为 `true` 时, 设置 `HttpConfig` 的超时时间为 `ums.oauth.proxy.foreignTimeout` 的值.                                             | true/false                      |
| **gitlabPrivate**                                                   |                |                      |                                                              |                       |
| ums.oauth.gitlabPrivate.clientId                                    | String         |                      | `client Id`                                                  |                       |
| ums.oauth.gitlabPrivate.clientSecret                                | String         |                      | `client Secret`                                              |                       |
    
------

###  线程池属性

| **属性**                                                     | **类型**                       | **默认值**                                 | **描述**                                                     | **可选项**                                                   |
| ------------------------------------------------------------ | ------------------------------ | ------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
| **accessTokenRefreshJob**                                    |                                |                                            |                                                              |                                                              |
| ums.executor.accessTokenRefreshJob.corePoolSize              | Integer                        | 0                                          | 线程池中空闲时保留的线程数, 默认: 0                          |                                                              |
| ums.executor.accessTokenRefreshJob.keepAliveTime             | Integer                        | 10                                         | keep alive time, 默认: 10                                    |                                                              |
| ums.executor.accessTokenRefreshJob.timeUnit                  | TimeUnit                       | TimeUnit.MILLISECONDS                      | keepAliveTime 时间单位, 默认: 毫秒                           | MILLISECONDS/MICROSECONDS/MILLISECONDS/SECONDS/MINUTES/HOURS/DAYS |
| ums.executor.accessTokenRefreshJob.poolName                  | String                         | accessTokenJob                             | 线程池名称, 默认: accessTokenJob                             |                                                              |
| ums.executor.accessTokenRefreshJob.rejectedExecutionHandlerPolicy | RejectedExecutionHandlerPolicy | ABORT                                      | 拒绝策略, 默认: ABORT                                        | ABORT/CALLER_RUNS/DISCARD_OLDEST/DISCARD                     |
| ums.executor.accessTokenRefreshJob.executorShutdownTimeout   | Duration                       | PT10S                                      | 线程池关闭过程的超时时间, 默认: PT10S                        |                                                              |
| **refreshToken**                                             |                                |                                            |                                                              |                                                              |
| ums.executor.refreshToken.corePoolSize                       | Integer                        | 0                                          | 线程池中空闲时保留的线程数, 默认: 0                          |                                                              |
| ums.executor.refreshToken.maximumPoolSize                    | Integer                        | Runtime.getRuntime().availableProcessors() | 最大线程数, 默认: 本机核心数                                 |                                                              |
| ums.executor.refreshToken.keepAliveTime                      | Integer                        | 5                                          | keep alive time, 默认: 5                                     |                                                              |
| ums.executor.refreshToken.timeUnit                           | TimeUnit                       | TimeUnit.SECONDS                           | keepAliveTime 时间单位, 默认: 秒                             | MILLISECONDS/MICROSECONDS/MILLISECONDS/SECONDS/MINUTES/HOURS/DAYS |
| ums.executor.refreshToken.blockingQueueCapacity              | Integer                        | maximumPoolSize * 2                        | blocking queue capacity, 默认: maximumPoolSize * 2           |                                                              |
| ums.executor.refreshToken.poolName                           | String                         | refreshToken                               | 线程池名称, 默认: refreshToken                               |                                                              |
| ums.executor.refreshToken.rejectedExecutionHandlerPolicy     | RejectedExecutionHandlerPolicy | CALLER_RUNS                                | 拒绝策略, 默认: CALLER_RUNS 注意: 一般情况下不要更改默认设置, 没有实现 RefreshToken 逻辑被拒绝执行后的处理逻辑, 除非自己实现RefreshTokenJob.refreshTokenJob() 对 RefreshToken 逻辑被拒绝执行后的处理逻辑. | ABORT/CALLER_RUNS/DISCARD_OLDEST/DISCARD                     |
| ums.executor.refreshToken.executorShutdownTimeout            | Duration                       | PT10S                                      | 线程池关闭过程的超时时间, 默认: PT10S                        |                                                              |
| **updateConnection**                                         |                                |                                            |                                                              |                                                              |
| ums.executor.updateConnection.corePoolSize                   | Integer                        | 5                                          | 线程池中空闲时保留的线程数, 默认: 5                          |                                                              |
| ums.executor.updateConnection.maximumPoolSize                | Integer                        | Runtime.getRuntime().availableProcessors() | 最大线程数, 默认: 本机核心数                                 |                                                              |
| ums.executor.updateConnection.keepAliveTime                  | Integer                        | 10                                         | keep alive time, 默认: 10                                    |                                                              |
| ums.executor.updateConnection.timeUnit                       | TimeUnit                       | TimeUnit.SECONDS                           | keepAliveTime 时间单位, 默认: 秒                             | MILLISECONDS/MICROSECONDS/MILLISECONDS/SECONDS/MINUTES/HOURS/DAYS |
| ums.executor.updateConnection.blockingQueueCapacity          | Integer                        | maximumPoolSize * 2                        | blocking queue capacity, 默认: maximumPoolSize * 2           |                                                              |
| ums.executor.updateConnection.poolName                       | String                         | updateConnection                           | 线程池名称, 默认: updateConnection                           |                                                              |
| ums.executor.updateConnection.rejectedExecutionHandlerPolicy | RejectedExecutionHandlerPolicy | CALLER_RUNS                                | 拒绝策略, 默认: CALLER_RUNS 注意: 一般情况下不要更改默认设置, 除非自己实现Auth2LoginAuthenticationProvider更新逻辑; 改成 ABORT 也支持, 默认实现 Auth2LoginAuthenticationProvider 是异步更新被拒绝执行后, 会执行同步更新. | ABORT/CALLER_RUNS/DISCARD_OLDEST/DISCARD                     |
| ums.executor.updateConnection.executorShutdownTimeout        | Duration                       | PT10S                                      | 线程池关闭过程的超时时间, 默认: PT10S                        |                                                              |

------

### 对第三方授权登录用户信息与 token 的持久化（jdbc）数据是否缓存到 redis 的配置

| **属性**                                     | **类型**    | **默认值** | **描述**                                                     | **可选项** |
| -------------------------------------------- | ----------- | ---------- | ------------------------------------------------------------ | ---------- |
| ums.cache.redis.open                         | Boolean     | false      | Redis cache is open, 默认 false                              | true/false |
| ums.cache.redis.useIocRedisConnectionFactory | Boolean     | false      | 是否使用 spring IOC 容器中的 RedisConnectionFactory， 默认： false. 如果使用 spring IOC 容器中的 RedisConnectionFactory，则要注意 cache.database-index 要与 spring.redis.database 一样 | true/false |
| **cache**                                    |             |            |                                                              |            |
| ums.cache.redis.cache.databaseIndex          | Integer     | 0          | redis cache 存放的 database index, 默认: 0                   |            |
| ums.cache.redis.cache.defaultExpireTime      | Duration    | PT200S     | 设置缓存管理器管理的缓存的默认过期时间, 默认: 200, 单位: 秒  |            |
| ums.cache.redis.cache.entryTtl               | Duration    | PT180S     | cache ttl 。使用 0 声明一个永久的缓存。 默认: 180, 单位: 秒 取缓存时间的 20% 作为动态的随机变量上下浮动, 防止同时缓存失效而缓存击穿 |            |
| ums.cache.redis.cache.cacheNames             | Set<String> |            | Names of the default caches to consider for caching operations defined in the annotated class. |            |

------

### 第三方授权登录用户信息表 user_connection sql 配置

| **属性**                                        | **类型** | **默认值**                                                   | **描述**                                                     | **可选项** |
| ----------------------------------------------- | -------- | ------------------------------------------------------------ | ------------------------------------------------------------ | ---------- |
| **数据库初始化相关语句**      |          |                                                              |                                                              |            |
| ums.repository.enableStartUpInitializeTable                         | Boolean     | true      | 是否在启动时检查并自动创建 `userConnectionTableName` 与 `authTokenTableName`, 默认: `TRUE`   | true/false |
| ums.repository.queryDatabaseNameSql          | String   | select database();                                              | 查询数据库名称, 默认为 `mysql` 查询语句.                                |            |
| ums.repository.authTokenTableName          | String   | auth_token                                              | 第三方登录 `AuthTokenPo` 数据库表名称.                                |            |
| ums.repository.queryAuthTokenTableExistSql          | String   | SELECT COUNT(1) FROM information_schema.tables WHERE table_name = '%s' AND table_schema = '%s';                                              | 查询户 `authTokenTableName` 在数据库中是否存在的语句。  注意： `sql` 语句中的 `%s` 必须写上，且 `%s` 的顺序必须与后面的字段名称所对应的含义对应 :  `authTokenTableName` , `database`                                |            |
| ums.repository.createAuthTokenTableSql          | String   | 创建 authTokenTableName 的建表语句                                             | 创建 `authTokenTableName` 的建表语句。  注意： `sql` 语句中的 `%s` 必须写上，且 %s 的顺序必须与后面的字段名称所对应的含义对应 :  `authTokenTableName`                                |            |
| **自定义第三方登录用户表及相关 CURD 语句**      |          |                                                              |                                                              |            |
| ums.repository.userConnectionTableName          | String   | user_connection                                              | 第三方登录用户数据库表名称，                                 |            |
| ums.repository.userIdColumnName                 | String   | userId                                                       | 第三方登录用户数据库用户表用户唯一 ID 字段名称， 默认为 userId |            |
| ums.repository.providerIdColumnName             | String   | providerId                                                   | 第三方登录用户数据库用户表服务商 providerId 字段名称， 默认为 providerId |            |
| ums.repository.providerUserIdColumnName         | String   | providerUserId                                               | 第三方登录用户数据库用户表服务商用户 providerUserId 字段名称， 默认为 providerUserId |            |
| ums.repository.rankColumnName                   | String   | rank                                                         | 第三方登录用户数据库用户表 rank 字段名称， 默认为 `rank`。  注意：因为 MySQL 8.0 版本 rank 是个关键字。一定要用 ` 包裹。 |            |
| ums.repository.displayNameColumnName            | String   | displayName                                                  | 第三方登录用户数据库用户表用户显示名称 displayName 字段名称， 默认为 displayName |            |
| ums.repository.profileUrlColumnName             | String   | profileUrl                                                   | 第三方登录用户数据库用户表用户主页 profileUrl 字段名称， 默认为 profileUrl |            |
| ums.repository.imageUrlColumnName               | String   | imageUrl                                                     | 第三方登录用户数据库用户表用户头像 imageUrl 字段名称， 默认为 imageUrl |            |
| ums.repository.accessTokenColumnName            | String   | accessToken                                                  | 第三方登录用户数据库用户表用户 accessToken 字段名称， 默认为 accessToken |            |
| ums.repository.tokenIdColumnName                | String   | tokenId                                                      | 第三方登录用户数据库用户表用户 tokenId 字段名称， 默认为 tokenId |            |
| ums.repository.refreshTokenColumnName           | String   | refreshToken                                                 | 第三方登录用户数据库用户表用户显 refreshToken 字段名称， 默认为 refreshToken |            |
| ums.repository.expireTimeColumnName             | String   | expireTime                                                   | 第三方登录用户数据库用户表用户过期时间 expireTime 字段名称， 默认为 expireTime |            |
| ums.repository.creatUserConnectionTableSql      | String   | "CREATE TABLE %s (" + "\t%s varchar(255) NOT NULL,\n" + "\t%s varchar(255) NOT NULL,\n" + "\t%s varchar(255) NOT NULL,\n" + "\t%s int NOT NULL,\n" + "\t%s varchar(255),\n" + "\t%s varchar(512),\n" + "\t%s varchar(512),\n" + "\t%s varchar(512) NOT NULL,\n" + "\t%s varchar(512),\n" + "\t%s varchar(512),\n" + "\t%s bigint,\n" + "\tPRIMARY KEY (%s, %s, %s),\n" + "\tunique KEY `idx_userId_providerId_rank`(%s, %s, %s),\n" + "\tKEY `idx_providerId_providerUserId_rank` (%s, %s, %s)\n" + "\t) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;"; | 第三方登录用户数据库用户表创建语句。  修改第三方登录用户数据库用户表创建语句时，要注意：修改字段名称可以直接修改上面的字段名称即可，不用修改建表语句，不可以减少字段，但可以另外增加字段。  用户需要对第三方登录的用户表与 curd 的 sql 语句结构进行更改时, 必须实现对应的 UsersConnectionRepositoryFactory， 如果需要，请实现 UsersConnectionRepositoryFactory，可以参考 Auth2JdbcUsersConnectionRepositoryFactory。  注意： sql 语句中的 %s 必须写上，且 %s 的顺序必须与后面的字段名称所对应的含义对应 :  tableName、  userIdColumnName、  providerIdColumnName、  providerUserIdColumnName、  rankColumnName、  displayNameColumnName、  profileUrlColumnName、  imageUrlColumnName、  accessTokenColumnName、  tokenIdColumnName、  refreshTokenColumnName、  expireTimeColumnName、  userIdColumnName、  providerIdColumnName、  providerUserIdColumnName、  userIdColumnName、  providerIdColumnName、  rankColumnName、  providerIdColumnName、  providerUserIdColumnName、  rankColumnName、 |            |
| ums.repository.queryUserConnectionTableExistSql | String   | SELECT COUNT(1) FROM information_schema.tables WHERE table_schema='%s' AND table_name = '%s' | 第三方登录用户数据库用户表查询 userIds 的查询语句。  注意： sql 语句中的 %s 必须写上，问号必须与指定的 %s 相对应,%s按顺序会用对应的 :  databaseName、  tableName |            |
| ums.repository.findUserIdsWithConnectionSql     | String   | select %s from %s where %s = ? and %s = ?                    | 第三方登录用户数据库用户表查询 userIds 的查询语句。  注意： sql 语句中的 %s 必须写上，问号必须与指定的 %s 相对应,%s按顺序会用对应的 :  userIdColumnName、  tableName、  providerIdColumnName、  providerUserIdColumnName |            |
| ums.repository.findUserIdsConnectedToSql        | String   | select %s from %S where %s = :%s and %s in (:%s)             | 通过第三方服务提供商提供的 providerId 与 providerUserIds 从数据库用户表查询 userIds 的查询语句。  注意： sql 语句中的 %s 必须写上，问号必须与指定的 %s 相对应,%s按顺序会用对应的 :  userIdColumnName、  tableName、  providerIdColumnName、  providerUserIdColumnName |            |
| ums.repository.selectFromUserConnectionSql      | String   | select %s, %s, %s, %s, %s, %s, %s, %s, %s, %s from %s        | 通过第三方服务提供商提供的 providerId 与 providerUserIds 从数据库用户表查询 userIds 的查询语句。  注意： sql 语句中的 %s 必须写上，问号必须与指定的 %s 相对应, %s按顺序会用对应的 :  userIdColumnName、  providerIdColumnName、  providerUserIdColumnName、  displayNameColumnName、  profileUrlColumnName、  imageUrlColumnName、  accessTokenColumnName、  tokenIdColumnName、  refreshTokenColumnName、  expireTimeColumnName、  tableName |            |
| ums.repository.updateConnectionSql              | String   | update %s set %s = ?, %s = ?, %s = ?, %s = ?, %s = ?, %s = ?, %s = ? where %s = ? and %s = ? and %s = ? | 第三方登录用户数据库用户表更新语句。  注意： sql 语句中的 %s 必须写上，问号必须与指定的 %s 相对应, %s按顺序会用对应的 :  tableName、  displayNameColumnName、  profileUrlColumnName、  imageUrlColumnName、  accessTokenColumnName、  tokenIdColumnName、  refreshTokenColumnName、  expireTimeColumnName、  userIdColumnName、  providerIdColumnName、  providerUserIdColumnName |            |
| ums.repository.addConnectionSql                 | String   | insert into %s(%s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s)  values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?) | 第三方登录用户数据库用户表添加用户语句。  注意： sql 语句中的 %s 必须写上，问号必须与指定的 %s 相对应, %s按顺序会用对应的 :  tableName、  userIdColumnName、  providerIdColumnName、  providerUserIdColumnName、  rankColumnName、  displayNameColumnName、  profileUrlColumnName、  imageUrlColumnName、  accessTokenColumnName、  tokenIdColumnName、  refreshTokenColumnName、  expireTimeColumnName |            |
| ums.repository.addConnectionQueryForRankSql     | String   | select coalesce(max(%s) + 1, 1) as %s from %s where %s = ? and %s = ? | 第三方登录用户数据库用户表查询添加用户时的所需 rank 的值。  注意： sql 语句中的 %s 必须写上，问号必须与指定的 %s 相对应,%s按顺序会用对应的 :  rankColumnName、  rankColumnName、  tableName、  userIdColumnName、  providerIdColumnName |            |
| ums.repository.removeConnectionsSql             | String   | delete from %s where %s = ? and %s = ?                       | 第三方登录用户数据库用户表根据 userId 与 providerId 删除多个用户。  注意： sql 语句中的 %s 必须写上，问号必须与指定的 %s 相对应,%s按顺序会用对应的 :  tableName、  userIdColumnName、  providerIdColumnName |            |
| ums.repository.removeConnectionSql              | String   | delete from %s where %s = ? and %s = ? and %s = ?            | 第三方登录用户数据库用户表根据 userId、providerId、providerUserId 删除一个用户。  注意： sql 语句中的 %s 必须写上，问号必须与指定的 %s 相对应,%s按顺序会用对应的 :  tableName、  userIdColumnName、  providerIdColumnName、  providerUserIdColumnName |            |

## 九、参与贡献

1. Fork [本项目](https://gitee.com/pcore/just-auth-spring-security-starter)
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request

## 友情链接
[一个基于aws s3快速集成多storage client的启动器](https://gitee.com/opcooc/opcooc-storage-spring-boot-starter)

mj-study/justAuth-spring-security-starter

简介

发行版

贡献者

近期动态

mj-study/justAuth-spring-security-starter .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

mj-study/justAuth-spring-security-starter