蓝桉云顶

OAuth2.0 服务器搭建：Java实现

OAuth2.0 是一种广泛使用的授权框架，允许第三方应用在不暴露用户密码的情况下访问用户的资源，本文将详细介绍如何使用 Java 搭建一个 OAuth2.0 服务器，包括其基本概念、架构和具体实现步骤。

一、OAuth2.0 基本概念与架构

1. 角色定义

资源拥有者（Resource Owner）: 通常是用户，拥有受保护的资源。

客户端（Client）: 想要访问资源的第三方应用。

授权服务器（Authorization Server）: 认证资源拥有者并颁发访问令牌。

资源服务器（Resource Server）: 存储受保护的资源，验证访问令牌的有效性。

2. 授权流程

OAuth2.0 支持多种授权流程，最常用的是授权码模式（Authorization Code Grant），其流程如下：

1、用户向客户端发起请求。

2、客户端将用户重定向到授权服务器，附带客户端信息和回调 URL。

3、用户在授权服务器登录并同意授权。

4、授权服务器生成授权码并通过回调 URL 返回给客户端。

5、客户端使用授权码向授权服务器请求访问令牌。

6、授权服务器验证授权码，返回访问令牌和刷新令牌（可选）。

7、客户端使用访问令牌向资源服务器请求资源。

8、资源服务器验证令牌并返回资源。

二、Java 实现 OAuth2.0 服务器

1. 环境准备

JDK 8+

Maven

Spring Boot

Spring Security OAuth2

2. 创建 Spring Boot 项目

使用 Spring Initializr 创建一个新的 Spring Boot 项目，选择以下依赖：

Spring Web

Spring Security

OAuth2 Authorization Server

OAuth2 Client

3. 配置文件

在application.yml 中配置 OAuth2.0 相关参数：

server:
  port: 9999
spring:
  security:
    oauth2:
      authorization:
        registered-client:
          id: client-id
          secret: {noop}secret
          redirect-uri: http://localhost:8080/login/oauth2/code/callback
          authorization-grant-type: authorization_code
          authorization-grant-type: refresh_token
          authorization-grant-type: client_credentials
          authorization-grant-type: password
          authorization-grant-type: implicit
          scope: read,write
          token-settings:
            token-format: random_value
            access-token-time-to-live: 3600s
            refresh-token-time-to-live: 7d

4. 配置授权服务器

创建一个配置类来设置 OAuth2 授权服务器：

import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
import org.springframework.security.oauth2.config.annotation.configurers.ClientDetailsServiceConfigurer;
import org.springframework.security.oauth2.config.annotation.web.configuration.AuthorizationServerConfigurerAdapter;
import org.springframework.security.oauth2.config.annotation.web.configuration.EnableAuthorizationServer;
@Configuration
@EnableAuthorizationServer
public class AuthorizationServerConfig extends AuthorizationServerConfigurerAdapter {
    @Override
    public void configure(ClientDetailsServiceConfigurer clients) throws Exception {
        clients.inMemory()
               .withClient("client-id")
               .secret("{noop}secret")
               .authorizedGrantTypes("authorization_code", "refresh_token", "client_credentials", "password", "implicit")
               .scopes("read", "write")
               .redirectUris("http://localhost:8080/login/oauth2/code/callback");
    }
    @Override
    public void configure(HttpSecurity http) throws Exception {
        http
            .authorizeRequests()
            .antMatchers("/login").permitAll()
            .anyRequest().authenticated()
            .and()
            .formLogin();
    }
}

5. 配置资源服务器

创建一个配置类来设置 OAuth2 资源服务器：

import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
import org.springframework.security.oauth2.config.annotation.web.configuration.ResourceServerConfigurerAdapter;
@Configuration
@EnableWebSecurity
public class ResourceServerConfig extends ResourceServerConfigurerAdapter {
    @Override
    public void configure(HttpSecurity http) throws Exception {
        http
            .authorizeRequests()
            .anyRequest().authenticated();
    }
}

6. 启动应用

运行 Spring Boot 应用，授权服务器将监听在http://localhost:9999。

三、测试 OAuth2.0 授权流程

可以使用 Postman 或浏览器进行测试：

1、访问授权服务器的登录页面：[http://localhost:9999/login](http://localhost:9999/login)

2、登录后，获取授权码。

3、使用授权码请求访问令牌。

4、使用访问令牌访问受保护的资源。

四、FAQs

Q1: 如何更改访问令牌的有效期？

A1: 可以在application.yml 文件中修改token-settings 下的access-token-time-to-live 和refresh-token-time-to-live 属性，

spring:
  security:
    oauth2:
      authorization:
        token-settings:
          access-token-time-to-live: 7200s # 2小时
          refresh-token-time-to-live: 14d # 14天

Q2: 如何在授权码模式下添加额外的参数？

A2: 可以在ClientDetailsServiceConfigurer 中通过additionalInformation 方法添加额外的参数，

clients.inMemory()
       .withClient("client-id")
       .secret("{noop}secret")
       .authorizedGrantTypes("authorization_code", "refresh_token")
       .scopes("read", "write")
       .redirectUris("http://localhost:8080/login/oauth2/code/callback")
       .additionalInformation(Collections.singletonMap("custom_param", "custom_value"));

各位小伙伴们，我刚刚为大家分享了有关“oauth2.0服务器搭建 java”的知识，希望对你们有所帮助。如果您还有其他相关问题需要解决，欢迎随时提出哦！