Java框架快速入门: Spring Security+OAuth2之密码验证规则与自定义注解

微服务安全实战:基于Spring Authorization Server与OAuth2.1构建统一授权中心 在分布式系统架构中,身份认证与授权管理是保障服务间安全通信的核心基础。OAuth 2.1作为行业标准授权框架,通过代理授权机制,实现了资源访问权限的安全委派。其核心价值在于提供了一套标准化的流程,确保客户端应用在无需接触用户凭证的前提下,安全获取访问令牌,从而访问受保护资源。这一机制特别适用于微服务、单页应用和第三方应用集成等场景。Spring Authorization Server作为Spring生态官方推出的授权服务器实现,完全遵循OAuth 2.1与OpenID Connect 1.0规范,提供了生 阅读详情

概述

在企业级安全开发中,密码策略往往非常复杂:禁止连续字母、连续数字、键盘序列、必须包含大小写与特殊字符,同时密码和确认密码必须一致。

如果直接在业务逻辑中硬编码这些规则,代码会迅速腐化。本文将介绍如何基于 Passay 密码策略库与 Jakarta Bean Validation 自定义注解,将密码验证逻辑彻底从业务代码中剥离,并实现类级别的复合属性校验。

纲要

  • Passay 框架简介与依赖引入
  • 单个属性校验:@PasswordConstraint 注解与验证器
    • 使用 PasswordValidator 组装多重规则
    • 规则:长度、大写、小写、特殊字符、禁止连续序列、禁止键盘连续序列
  • 多属性复合校验:@PasswordMatch 类级别注解
    • 校验 password 与 confirmPassword 一致性
  • DTO 层应用示例
  • 自定义验证流程可视化

Passay:专业密码策略库

Passay 提供了丰富的预置规则(Rule),并允许通过 PasswordValidator 灵活组装。相比于手写正则,它更易读、易维护,且对连续序列、键盘序列等复杂规则提供了开箱即用的支持。

引入依赖

在 pom.xml 中添加 passay 和 spring-boot-starter-validation(后者提供验证框架支持):

<properties>
    <passay.version>1.6.0</passay.version>
</properties>

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-validation</artifactId>
    </dependency>
    <dependency>
        <groupId>org.passay</groupId>
        <artifactId>passay</artifactId>
        <version>${passay.version}</version>
    </dependency>
</dependencies>

自定义密码验证注解 @PasswordConstraint

为了让密码规则注解化,我们首先定义一个作用于字段的约束注解。

package com.example.validation.annotation;

import com.example.validation.validator.PasswordConstraintValidator;
import jakarta.validation.Constraint;
import jakarta.validation.Payload;
import java.lang.annotation.*;

@Documented
@Constraint(validatedBy = PasswordConstraintValidator.class)
@Target({ElementType.FIELD, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
public @interface PasswordConstraint {
    String message() default "密码不符合安全规则";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

验证器实现:引入 Passay 规则

验证器内部使用 PasswordValidator 组合规则,包括:

  • 长度:8~30 位
  • 字符规则:至少一个大写字母、一个小写字母、一个特殊字符
  • 非连续序列:不允许 5 个连续字母或数字
  • 键盘序列:不允许 QWERTY 键盘上的 5 个连续字符(如 qwert)
package com.example.validation.validator;

import com.example.validation.annotation.PasswordConstraint;
import jakarta.validation.ConstraintValidator;
import jakarta.validation.ConstraintValidatorContext;
import org.passay.*;

import java.util.Arrays;

public class PasswordConstraintValidator implements ConstraintValidator<PasswordConstraint, String> {

    private final PasswordValidator passwordValidator;

    public PasswordConstraintValidator() {
        this.passwordValidator = new PasswordValidator(Arrays.asList(
                // 长度规则 8-30
                new LengthRule(8, 30),
                // 至少一个大写字母
                new CharacterRule(EnglishCharacterData.UpperCase, 1),
                // 至少一个小写字母
                new CharacterRule(EnglishCharacterData.LowerCase, 1),
                // 至少一个特殊字符
                new CharacterRule(EnglishCharacterData.Special, 1),
                // 不允许5个连续字母
                new IllegalSequenceRule(EnglishSequenceData.Alphabetical, 5, false),
                // 不允许5个连续数字
                new IllegalSequenceRule(EnglishSequenceData.Numerical, 5, false),
                // 不允许QWERTY键盘序列5个连续
                new IllegalSequenceRule(EnglishSequenceData.USQwerty, 5, false),
                // 不允许包含空白字符
                new WhitespaceRule()
        ));
    }

    @Override
    public boolean isValid(String password, ConstraintValidatorContext context) {
        if (password == null) {
            return false;
        }
        RuleResult result = passwordValidator.validate(new PasswordData(password));
        return result.isValid();
    }
}

类级别复合校验 @PasswordMatch

密码与确认密码必须相等,这属于类中两个属性的复合校验。我们定义类级别的注解 @PasswordMatch。

package com.example.validation.annotation;

import com.example.validation.validator.PasswordMatchValidator;
import jakarta.validation.Constraint;
import jakarta.validation.Payload;
import java.lang.annotation.*;

@Documented
@Constraint(validatedBy = PasswordMatchValidator.class)
@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
public @interface PasswordMatch {
    String message() default "密码与确认密码不一致";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

对应的验证器通过反射获取 password 和 confirmPassword 字段值进行比较:

package com.example.validation.validator;

import com.example.validation.annotation.PasswordMatch;
import jakarta.validation.ConstraintValidator;
import jakarta.validation.ConstraintValidatorContext;
import org.springframework.beans.BeanWrapperImpl;

public class PasswordMatchValidator implements ConstraintValidator<PasswordMatch, Object> {

    @Override
    public boolean isValid(Object value, ConstraintValidatorContext context) {
        Object password = new BeanWrapperImpl(value).getPropertyValue("password");
        Object confirmPassword = new BeanWrapperImpl(value).getPropertyValue("confirmPassword");
        if (password == null) {
            return false;
        }
        return password.equals(confirmPassword);
    }
}

DTO 应用与验证流程

将两个注解应用于 UserDto,其中 @PasswordMatch 作用于类上,@PasswordConstraint 作用于密码字段。

package com.example.dto;

import com.example.validation.annotation.PasswordConstraint;
import com.example.validation.annotation.PasswordMatch;
import jakarta.validation.constraints.Email;
import lombok.Data;

@Data
@PasswordMatch
public class UserDto {

    @Email(message = "邮箱格式不正确")
    private String email;

    @PasswordConstraint
    private String password;

    private String confirmPassword;
}

当请求进入 Controller 并使用 @Valid 触发校验时,执行流程如下:

PassayValidatorControllerClientPassayValidatorControllerClient委托 PasswordConstraintValidator比较 password 与 confirmPasswordalt[所有约束通过][存在违规]POST /register (UserDto)validate(UserDto)校验 @Email校验 @PasswordConstraintPasswordValidator.validate(password)RuleResult校验 @PasswordMatch (类级别)无违规注册成功ConstraintViolation 集合400 错误详情

项目结构概览

src/main/java/com/example/
├── dto
│   └── UserDto.java
├── validation
│   ├── annotation
│   │   ├── PasswordConstraint.java
│   │   └── PasswordMatch.java
│   └── validator
│       ├── PasswordConstraintValidator.java
│       └── PasswordMatchValidator.java

总结

通过 Passay 与自定义注解的结合,我们将复杂的密码策略封装为声明式校验,完全解耦业务代码。同时演示了类级别复合验证如何优雅地处理 “密码与确认密码” 的场景。

这套模式可扩展至任何需要多属性组合校验的 DTO,有效提高代码可读性与安全性。

SpringBoot实战:JWT与BCrypt构建安全认证体系 在Web应用开发中,用户认证与密码安全是保障系统安全性的基石。其核心原理在于通过可靠的机制验证用户身份并保护敏感凭证。JWT(JSON Web Token)作为一种无状态认证方案,通过数字签名生成自包含令牌,有效解决了分布式系统中的会话管理难题,提升了系统的扩展性与灵活性。而密码存储则需依赖单向哈希函数,传统的MD5算法因彩虹表攻击和计算速度过快等问题已不再安全,现代实践普遍采用加盐慢哈希技术。BCrypt作为当前Java领域的首选密码编码器,通过内置盐值和自适应成本因子,实现了强大的抗暴力破解能力。本文将 阅读详情

相关推荐

SpringBoot+Vue+MySQL 高校学科竞赛平台 完整可运行版(源码+文档)

本项目基于SpringBoot+Vue+MySQL构建高校学科竞赛管理平台,覆盖学生、教师、领队教师、管理员四大角色,实现竞赛发布、报名、刷题、评分、公示等全流程闭环管理。系统架构清晰,技术主流,配套完整源码、数据库脚本、万字论文、开题报告、答辩PPT及部署文档,支持一键运行,适用于毕业设计、课程设计及院系二次开发,真正实现“开箱即用”。

招风的黑耳优快云 343

Java安全实践:从认证授权原理到Spring Security与JWT实战

身份验证与授权是软件安全的基石,其核心在于准确识别用户身份并精确控制其访问权限。从原理层面看,认证解决“你是谁”的问题,通常依赖密码、令牌等凭证;授权则解决“你能做什么”的问题,常见模型包括基于角色的访问控制。在Java生态中,Spring Security框架已成为实现这些安全机制的主流选择,它提供了声明式的安全配置和全面的防护功能。对于现代分布式应用,JSON Web Token作为一种无状态令牌技术,能有效解决会话管理难题,但需注意其令牌泄露后的撤销等安全考量。本文将结合Spring Security

weixin_34082854的博客 463

[kriging](一)网上下载的kriging克里金的C++程序的初步调试

笔者在网上下载了一份克里金的C++程序,水平有限,正在逐步地调试中。 初步 克里金法现在在许多软件都已经有集成了,据笔者所知: arcgis : 看过有的arcgis培训视频里面简略介绍了里面的插值方法,有克里金。 surfer :笔者用过这个,效果很好。 gocad :听说有 landmark &jason :研究生时候用的专业的石油物探软件,里面有克里金法,万恶的开始。 pykrig...

FOREST优快云 5613

Spring Security入门实战:从认证授权到数据库集成与JWT整合

在Java Web开发中,认证与授权是保障应用安全的核心机制。认证解决“你是谁”的问题,通过验证用户凭证确认身份;授权则解决“你能做什么”的问题,基于角色或权限控制资源访问。Spring Security作为Spring官方安全框架,通过可定制的安全过滤器链,为请求提供层层安检,是实现这些机制的工业级解决方案。其技术价值在于提供了高度可配置、与Spring生态无缝集成的安全能力,能有效防御未授权访问、数据泄露等风险,广泛应用于电商、金融、企业后台等需要分级权限管理的场景。本文聚焦于Spring Securi

weixin_34184561的博客 397

PCB设计必看:铜皮厚度与载流能力对照表(附Excel计算工具)

本文深入解析了PCB设计中铜皮厚度与载流能力的核心关系,提供了基于IPC-2152标准的动态计算逻辑与实用Excel工具。文章不仅分享了载流对照表,更重点剖析了影响载流能力的关键因素(如铜厚、线宽、温升、布线层),并给出了高电流设计的实战技巧与测试验证方法,帮助工程师规避常见陷阱,实现从理论到实践的闭环设计。

weixin_29228781的博客 729

优化问题-半正定规划(Semi-Definite Program, SDP)

半正定规划(Semi-Definite Program, SDP)在MIMO无线通信相关的信号处理中具有广泛的应用,在某些场景可以分析证明SDP的得到的解释原问题的全局最优化或者次优解。

qq_33668008的博客 1万+

Spring Security PasswordEncoder源码深度解析与安全实践指南

在Web应用安全体系中,密码存储与验证是身份认证的核心环节,其原理基于密码学中的单向哈希函数。通过将用户明文密码转换为不可逆的哈希值,并引入随机盐值,可以有效抵御彩虹表攻击,确保即使数据库泄露,攻击者也难以还原原始密码。这一技术的工程价值在于为系统建立了基础的安全基线。Spring Security作为Java领域的主流安全框架,其PasswordEncoder接口正是这一原理的抽象实现,它定义了密码编码与匹配的明确契约,并内置了BCrypt、PBKDF2等多种主流算法实现,广泛应用于各类需要用户登录的企业

congsikuai0611的博客 698

从零到实战:用QCustomPlot在QT中绘制动态曲线图(含OpenGL加速配置)

本文详细介绍了如何在QT中使用QCustomPlot库绘制动态曲线图,并配置OpenGL加速以提升渲染性能。从环境搭建、动态数据可视化到OpenGL加速配置,手把手教你实现工业级动态曲线监控系统,适用于大数据量实时展示场景。

weixin_29019241的博客 354

SpringBoot实战:整合Spring Security、JWT与Redis构建企业级认证系统

在现代Web应用开发中,用户认证与授权是保障系统安全的核心机制。其原理是通过验证用户身份并控制资源访问权限,确保数据安全与业务合规。JWT(JSON Web Token)作为一种无状态令牌技术,通过数字签名实现安全的身份凭证传递,有效解决了分布式系统中的会话管理难题。结合Redis高性能缓存,可以进一步提升系统响应速度并实现令牌黑名单等高级功能。这种技术组合在电商、社交、企业后台等需要严格权限控制的场景中具有广泛应用价值。本文以SpringBoot框架为基础,通过整合Spring Security、JWT和

weixin_30482383的博客 444

跨时钟域传输数据——单bit和多bit信号(总结)

总结单bit和多bit信号的跨时钟域传输

qq_42135020的博客 1万+

UDP_千兆光通信(四)Tri Mode Ethernet MAC ip核

其中 Transmit Engine 从 AXI-Stream TX 接口接收数据,并添加前导码 Preamble、帧起始界定符 SFD、帧校验序列 FSC 等,并在必要时(长度小于最小 MAC 帧长度)填充数据,因此在使用 TEMAC 时,MAC 帧的这几个部分就不需要我们自己添加了(不过其他的 MAC 帧部分,可选的帧过滤器 Frame Filter 用于过滤与一组可配置过滤器匹配的帧,一般用于过滤掉目的 MAC 地址与本设备不一致的帧,TEMAC 默认开启帧过滤器。默认值为使用64位宽的计数器。

lzr232的博客 1778

Spring Security 6.4与Auth0 SDK构建模块化身份认证架构实战

身份认证是现代应用安全的核心基础,其原理在于验证用户身份并授予相应资源访问权限。在微服务与多租户架构盛行的今天,传统的单体认证方案在应对复杂权限体系和多样化登录方式时面临巨大挑战。Spring Security作为Java生态中权威的安全框架,其6.x版本在模块化设计和OAuth2支持上实现了质的飞跃,为构建灵活、可扩展的认证体系提供了坚实的技术基础。结合Auth0 Enterprise SDK提供的企业级身份治理能力,如多因素认证(MFA)和外部身份源联邦,开发者能够高效实现符合严格安全合规要求的认证解决

weixin_30352645的博客 507

QEMU理解与分析系列(11):QEMU内存机制

在物理机上,CPU 对于内存的访问在保护模式下通过分段分页的形式实现。在该模式下,CPU 访问时使用的是虚拟地址,通过 MMU 映射到物理地址,将虚拟地址转换为物理地址才能访问实际的物理内存。同样的,虚拟机模拟的物理机同样需要有上述的机制,也需要有从虚拟地址到物理地址的转换。这里需要注意,模拟的物理机的物理地址本质上是 qemu 的虚拟地址。

swh547的博客 50

DataEase企业级权限管理架构:构建精细化数据访问控制策略

在数据驱动的商业环境中,企业面临着数据安全与协作效率的双重挑战。DataEase作为开源BI工具,通过多层次、细粒度的权限控制架构,为企业构建了一套完整的数据安全访问解决方案。**数据权限管理**不仅关乎安全合规,更是提升团队协作效率和数据价值的关键基础设施。 ## 1. 行业挑战与需求分析:数据安全的三重困境 现代企业数据管理面临三大核心痛点,这些痛点直接催生了对精细化权限管理的迫切需求:

gitblog_00049的博客 264

PCB仿真软件:Altium Designer_(18).PCB设计中的热管理

在PCB设计中,热管理是一个至关重要的环节。随着电子设备的集成度越来越高,功耗和发热量也随之增加,不合理的热设计可能导致电路板过热,从而影响电路的性能和可靠性。热管理不仅能够提高电路板的使用寿命,还能确保电路在各种环境条件下的稳定工作。本节将详细介绍如何在Altium Designer中进行有效的热管理,包括热分析、热设计和热仿真等关键步骤。

kkchenjj的博客 1992

怀旧版电脑GBC模拟器

再现原版GBC掌机的界面,电脑运行连游戏界面都一样大小,很怀旧,很真实,(英文版)强烈推荐,很小的文件,很难才找到的。

InnoDB 内存结构总览:Change Buffer、AHI 与 Log Buffer

本文系统梳理InnoDB内存结构中的ChangeBuffer、Adaptive Hash Index(AHI)与LogBuffer。ChangeBuffer缓存二级索引页不在内存时的变更,减少随机IO,仅在页加载时合并;聚簇索引修改立即执行,因数据本身不可延后。AHI基于高频等值查询自动构建哈希索引,加速定位,仅支持等值操作。LogBuffer为redo log内存缓冲,配合磁盘日志实现崩溃恢复。三者均服务于性能优化,其中ChangeBuffer与AHI共享BufferPool空间,而LogBuffer独立

bksczm的博客 311

win10 跳过U8环境检测的IE WebControls.rar

win10 安装u8的时候 提示IE WebControls 不通过,这个工具可以欺骗u8的检查。 跳过U8环境检测的IE WebControls。提示导入失败后,重新检测通过。

信创环境下PageOffice文档控件适配与实践

信创适配做到文档控件这一层,拼的已经不是"有没有国产版本",而是同一个功能在两类终端上是否真的等价。等价的标准很具体:同一次点击能得到同样的结果,同一份公文能得到同样的版式,同一个项目不需要维护两套代码。这背后是三件并不轻松的工作:服务端用一套接口同时支撑两类终端,客户端把两种系统与四种芯片的安装包分发清楚,文档内核层由产品侧跟着 WPS 的版本走。浏览器这一层的压力,则被收进了产品自己的窗口里——升级节奏由产品掌握,不再交给运气。

zi_wu_xian的专栏 340

蓝牙模块HM-10手册

蓝牙模块HM-10手册,该手册对蓝牙模块HM-10进行了详细的介绍和使用方法以及一些AT指令。

C# WinForm 基于DirectShow.dll编写的程序,可边预览边保存视频,音频和图片

基于微软的DirectShow.dll的二次开发1.自动识别连接的摄像头跟麦克风且可以对其进行选择(默认选中第一个)2.可录制wmv和avi两种格式的视频并且都带有音频,avi可以录制的分辨率和帧数进行选择,wmv默认进行了淸晰度优化如不喜欢可去除代码中有相关提示3.可在预览点开之后进行拍照,也可边录制视频边拍照4.添加了视频和音频的压缩功能(酌情使用)这次二次开发发现C#对DirectShow的相关信息太少,这次做完也不敢藏私共享出来,还望大家指正

第三篇 第 6 课

前置:第三篇第 1 课(stdx 引入),第二篇第 1 课(std.regex)。环境:仓颉 SDK 1.2.0。本文所有代码与输出均逐行实测。

weixin_41618057的博客 557

【从零理解 Spring AI · 12】MCP 的两种角色:做客户端还是做服务端

上一篇讲了 MCP 的概念:标准协议、三大角色、M+N 替代 M×N。

nice_lcj520的博客 624

pcl2启动器下载(Minecraft PCL2 启动器 最新版 安装与使用说明)

摘要:PCL2(Plain Craft Launcher 2)是一款面向 Minecraft 的第三方启动器,支持正式版与快照版本管理、模组与整合包安装、Java 运行时自动匹配,绿色免安装、双击即可运行。适合在 Windows 上玩单机整合包、需要多版本共存或离线启动的用户使用

2611_96675819的博客 239

spring boot 4集成SQLLite,及其SQLLite的建库

spring boot 4集成SQLLite,及其SQLLite的建库

weixin_41463944的博客 256

Java 集合容器高频面试题全解:HashMap 树化阈值、1.7 死循环与 ConcurrentHashMap 演进(2026 招聘 JD 真题复盘)

HashMap 树化阈值 8 的泊松分布依据、退化阈值 6 的防抖设计、JDK 1.7 头插成环死循环的排查与修复、1.8 尾插后为何仍线程不安全、ConcurrentHashMap 放弃分段锁的原因与 ForwardingNode 协作扩容、computeIfAbsent 死锁陷阱、大集合找重复的场景题选型,附三层追问链自测。题目来源为 38 期公开招聘 JD 样本与字节、拼多多、建行、美团、快手公开面经。

蒙眼过河 436

spdlog 同步日志库使用详解

spdlog是一个轻量级 C++ 日志库,支持同步日志、异步日志、多线程日志、日志文件轮转和自定义日志格式。对于嵌入式 Linux 应用开发,我建议先使用。它可以帮我们完成:日志级别过滤。时间戳和线程 ID 输出。日志格式化。终端和文件输出。多线程安全写入。日志文件按大小或时间轮转。我们不需要自己实现互斥锁、文件写入、日志格式化和轮转等底层功能。

zengjiajun2006的博客 1127

JavaSE通关手册:数据类型与变量

代码无需额外处理,编译时编译器自动完成转换。

xys_678的博客 236

IDEA 简介:从零认识 IntelliJ IDEA

IDEA 全称,是由 JetBrains 公司开发的一款主流 Java 集成开发环境(IDE)。它集代码编辑、编译、调试、测试、版本控制、构建管理等功能于一体,被大量 Java 开发者视为日常开发的首选工具。所谓 IDE(Integrated Development Environment,集成开发环境),就是把写代码所需的各类工具整合到同一个界面中。相比只用文本编辑器加命令行编译,IDE 能显著减少重复操作,让开发者把精力集中在业务逻辑上。

ztI10的博客 194

Docker部署linkding:HTTPS与数据备份

部署私人书签库,除了让页面能够打开,还需要考虑几个实际问题:重建容器后数据是否保留、登录和保存是否正常、升级前怎样备份,以及出现 502 或 CSRF 错误时从哪里检查。本文使用 Docker Compose 部署 linkding,采用默认 SQLite 数据库,通过 Caddy 提供 HTTPS,并完成账户创建、数据持久化验证和备份。如果重建后账户或书签消失,应先检查是否换了项目目录、改了挂载路径,或者启动了另一套实例,不要急着重新初始化。遇到权限问题,应根据日志确认具体目录和运行用户,再调整权限。

tedcloud123的博客 200
上一篇: Java框架快速入门: Spring Security+OAuth2之字段验证与自定义验证注解实战
下一篇: Java框架快速入门: Spring Security+OAuth2之验证消息国际化
Wang's Blog
博客等级 码龄12年 7441粉丝 2427原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

Wang's Blog

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值