Keycloak 23.0.0注册自定义插件咨询：邮箱/域名验证与属性添加

一、邮箱验证：无需额外插件 #

Keycloak 23.0.0 默认自带邮箱验证能力，只需在Realm设置→登录页面开启对应配置：

• 勾选「要求验证邮箱」选项，用户注册后会自动收到验证邮件，完成验证后方可登录。
• 可自定义验证邮件的模板内容，适配你的Chrome扩展场景需求。

二、域名验证：两种可行实现方式 #

1. 自定义用户存储SPI（原生扩展，无插件依赖） #

如果不想依赖第三方插件，可通过Keycloak的SPI机制实现域名校验：

• 编写实现UserRegistrationProvider接口的自定义扩展，在用户注册流程中加入邮箱域名的白名单/黑名单校验逻辑。
• 将代码打包为JAR文件，部署到Keycloak的providers目录下，重启服务后在Realm的用户存储中启用该扩展。

2. 第三方开源插件 #

社区有适配Keycloak 23.x版本的域名验证插件：

• Keycloak Domain Restriction：支持配置允许或禁止的邮箱域名列表，用户注册时自动触发域名校验。
• 这类插件可直接从开源仓库获取，部署后在Realm的认证→流程中添加对应的验证步骤即可生效。

三、解决无法添加用户属性的问题 #

Keycloak 23.0.0 默认支持用户属性添加，若无法操作，优先排查以下配置：

1. 管理员权限检查：确认当前操作的管理员账号拥有「管理用户属性」的权限，可在角色→默认角色中查看realm-admin的权限配置。
2. 用户属性配置：在Realm设置→用户属性页面添加自定义属性字段，按需开启「允许用户编辑」「必填」等规则。
3. 若配置排查后仍有问题，可使用Keycloak Attribute Manager类插件，简化属性管理流程，支持批量添加或编辑用户属性。

总结 #

• 邮箱验证直接使用Keycloak原生功能即可；
• 域名验证可根据需求选择自定义SPI开发或第三方插件集成；
• 用户属性添加问题优先排查权限与配置，必要时借助辅助插件解决。

内容的提问来源于stack exchange，提问作者Yureshwar Ravuri