KeyCloak 9.0.2版本如何配置Username Policy？需用户名长度与数字限制

KeyCloak 9.0.2 原生没有内置的用户名策略可视化配置界面，要实现你提出的「用户名最小长度限制」「用户名含至少一个数字」需求，可通过以下两种方案实现：

方案一：自定义用户存储SPI（适合具备开发能力的场景） #

• 编写自定义用户存储提供者，在用户创建、更新用户名的环节加入规则校验：
  1. 实现UserStorageProvider接口，重写addUser或updateUser方法
  2. 在方法内添加校验逻辑：
     • 检查用户名长度是否达到设定的最小值（比如5位，可自行调整）
     • 检查用户名是否包含至少一个数字字符
  3. 若校验不通过，抛出对应的异常信息
  4. 将打包后的Jar文件部署到KeyCloak的standalone/deployments目录，随后在控制台启用该用户存储提供者

方案二：扩展认证流程（无需复杂开发，快速落地） #

通过添加脚本认证器，在用户注册或修改用户名的流程中插入校验逻辑：

1. 进入KeyCloak控制台的Authentication -> Flows页面，复制默认的Registration流程
2. 在复制后的流程中新增执行步骤，选择Script Authenticator类型
3. 编写Groovy脚本实现校验逻辑（示例如下，可按需调整参数）：

   def username = user.username
   // 最小长度校验，此处设为5，可自行修改
   if (username.length() < 5) {
       session.setAttribute("usernameError", "用户名长度不能少于5位")
       return false
   }
   // 数字包含校验
   if (!username.matches(".*\\d.*")) {
       session.setAttribute("usernameError", "用户名必须包含至少一个数字")
       return false
   }
   return true
   

4. 将该脚本步骤设为REQUIRED，并调整流程顺序，确保在用户提交信息后执行校验
5. 若需覆盖「修改用户名」场景，同理复制并修改Profile Edit流程，加入相同的校验步骤

补充说明 #

若允许版本升级，可考虑将KeyCloak升级至17及以上的Quarkus版本——后续版本在Realm Settings -> User Profile页面新增了原生用户名策略配置入口，可直接可视化设置长度、字符规则等限制，但升级前需注意业务兼容性。

内容的提问来源于stack exchange，提问作者J. Abel