身份认证与应用安全 / 系统课时
用 BCrypt 保存密码摘要
用 BCrypt 保存密码摘要
用户密码不能以明文入库,也不应该使用适合高速计算的普通摘要算法直接保存。本节使用 Spring Security 的 BCryptPasswordEncoder 完成密码摘要生成与校验,并通过可运行示例观察随机盐值带来的结果差异。
学习目标
- 使用
BCryptPasswordEncoder生成并校验密码摘要。 - 理解同一明文密码为什么会得到不同的 BCrypt 字符串。
- 避免重新编码后直接比较字符串等常见密码校验错误。
BCryptPasswordEncoder 的两个核心操作
密码保存只需要区分两个动作:注册或修改密码时调用 encode 生成摘要;登录时调用 matches 判断明文密码是否与已经保存的摘要匹配。摘要不是加密后的密码,因此不存在“解密取回原密码”的操作。
下面的 Java 程序假设项目已经引入 Spring Security,并直接演示同一密码连续编码两次后的结果。
import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
import org.springframework.security.crypto.password.PasswordEncoder;
public class BcryptDemo {
public static void main(String[] args) {
PasswordEncoder encoder = new BCryptPasswordEncoder();
String rawPassword = "S3cur3-Pass!";
// 同一明文连续编码两次,用于观察随机盐值带来的差异。
String hash1 = encoder.encode(rawPassword);
String hash2 = encoder.encode(rawPassword);
System.out.println(hash1.length());
System.out.println(hash2.length());
System.out.println(hash1.equals(hash2));
System.out.println(encoder.matches(rawPassword, hash1));
System.out.println(encoder.matches("wrong-password", hash1));
}
}预期输出
60
60
false
true
false两个摘要字符串的具体内容每次运行都会变化,因此不应该把某个固定 BCrypt 结果写进预期输出。关键现象是:两个摘要长度相同但内容通常不同,而 matches 仍能识别正确密码。
为什么相同密码会得到不同摘要
BCrypt 在编码时会生成随机盐值,并把算法版本、成本因子、盐值和计算结果一起编码进最终字符串。默认情况下,BCryptPasswordEncoder 使用成本强度 10;盐值不同,即使输入的明文完全相同,最终摘要通常也不同。
登录校验时不需要单独保存盐值。matches 会从数据库中的 BCrypt 字符串读取其参数和盐值,再使用用户本次提交的明文执行对应计算,最后判断结果是否匹配。
因此下面这种思路是错误的:登录时再次调用 encode,再用字符串相等判断新旧摘要。新的 encode 会生成新的随机盐值,正确密码也几乎不会得到与数据库完全相同的字符串。
注册和登录分别怎么处理
注册或修改密码时,应用接收明文密码后调用 encode,只把返回的摘要写入数据库。明文密码在完成必要处理后不应进入日志、缓存或持久化字段。
登录时先根据用户名读取用户记录,再把请求中的明文密码和数据库里的 password_hash 传给 matches。如果账号同时存在禁用或锁定规则,还应由认证层统一完成状态检查,而不是让前端决定账号能否继续登录。
成本因子不是越大越好
BCrypt 的成本因子决定一次计算需要付出多少工作量。提高成本可以增加离线暴力尝试的代价,但也会同步增加正常注册和登录的 CPU 时间。成本每提高一级,计算量大致会显著增加,因此生产值应通过目标硬件上的压测确定,而不是盲目设置一个很大的数字。
如果需要显式指定强度,可以构造 new BCryptPasswordEncoder(strength)。无论使用默认值还是自定义值,都应该让认证接口在预期并发量下保持可接受的响应时间,再决定最终配置。
最容易写错的地方
密码存储通常只需要坚持几条边界:不要保存明文密码;不要用快速通用摘要替代专门的密码哈希;不要自己维护固定盐值;不要比较两次 encode 的字符串;登录校验始终使用 matches。
BCrypt 摘要本身已经携带完成校验所需的信息,所以数据库只需保存最终摘要。应用掌握的真正秘密只有用户在本次请求中提交的明文密码,而它只应短暂存在于认证过程内。