spring boot 统一认证平台

原创

mob64ca12ec3a08 2024-11-26 06:46:52 ©著作权

文章标签 spring java xml 文章分类 spring boot 后端开发

©著作权归作者所有：来自51CTO博客作者mob64ca12ec3a08的原创作品，请联系作者获取转载授权，否则将追究法律责任

Spring Boot 统一认证平台实现指南

在现代应用中，统一认证平台（Single Sign-On, SSO）是一个非常重要的概念。它允许用户在多个应用系统上只需登录一次，即可访问所有相关的应用。本文将指导你如何实现一个简单的基于 Spring Boot 的统一认证平台。

1. 流程概述

在开始之前，我们先了解整个实现的流程。以下表格列出了主要的步骤：

步骤	操作	描述
1	创建 Spring Boot 项目	初始化 Spring Boot 项目
2	添加依赖	添加必要的依赖项
3	配置安全性	使用 Spring Security 配置安全
4	实现认证接口	提供用户登录的 REST API
5	设计客户端应用	创建能够消费认证服务的前端
6	测试与验证	确保一切正常运行

2. 各步骤详细说明

1. 创建 Spring Boot 项目

首先，可以使用 Spring Initializr 创建一个新的 Spring Boot 项目。选择 Maven 或 Gradle，然后添加以下依赖：

Spring Web
Spring Security
Spring Data JPA
H2 Database（或其他数据库）

2. 添加依赖

在 pom.xml 中，加入以下依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-security</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
<dependency>
    <groupId>com.h2database</groupId>
    <artifactId>h2</artifactId>
    <scope>runtime</scope>
</dependency>

3. 配置安全性

创建一个 SecurityConfig 配置类，用于配置 Spring Security。

import org.springframework.context.annotation.Bean;
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.config.annotation.web.configuration.WebSecurityConfigurerAdapter;

@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {

    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http
            .csrf().disable() // 禁用 CSRF 保护，以便于测试
            .authorizeRequests()
                .antMatchers("/login").permitAll() // 允许 /login 访问
                .anyRequest().authenticated() // 其他请求需要认证
            .and()
            .formLogin() // 基于表单的登录
                .loginPage("/login") // 指定登录页面
                .permitAll();
    }
}

4. 实现认证接口

创建控制器来处理用户的认证请求。

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;

@Controller
public class AuthController {

    @GetMapping("/login")
    public String login() {
        return "login"; // 返回登录视图
    }
}

5. 设计客户端应用

在 resources/templates 中创建 login.html 页面，让用户输入用户名和密码：

<!DOCTYPE html>
<html>
<head>
    <title>Login</title>
</head>
<body>
    <h2>Login</h2>
    <form method="post" action="/login">
        <div>
            <label for="username">Username:</label>
            <input type="text" id="username" name="username">
        </div>
        <div>
            <label for="password">Password:</label>
            <input type="password" id="password" name="password">
        </div>
        <button type="submit">Login</button>
    </form>
</body>
</html>

6. 测试与验证

启动 Spring Boot 应用，通过访问 http://localhost:8080/login 来测试登录。如果成功，你应该被重定向到一个受保护的区域。

3. 数据库设计

为了更好地管理用户信息，我们可以使用数据库来存储用户信息。下面是用户数据模型的 ER 图:

erDiagram
    USERS {
        int id PK "主键"
        string username "用户名"
        string password "密码"
        string email "邮箱"
        string role "角色"
    }