Keycloak 21.1.1添加用户注册自定义字段：找不到User Profile Enabled选项

为什么master域看不到User Profile Enabled选项 #

Keycloak 21.x版本中，User Profile功能默认全局启用，且针对master管理域，该功能是强制开启的，因此不会在master域的设置中显示开关选项——你无需手动启用，直接配置自定义字段即可。

自定义注册字段的配置步骤 #

如果你要给业务领域的用户注册流程添加自定义字段，操作步骤如下：

• 登录Keycloak管理员控制台，切换到目标业务领域（而非master域）
• 左侧菜单栏进入Realm Settings，切换到User Profile标签页
• 点击Configure a new attribute按钮，填写以下关键参数：
  • Name：字段的内部标识（如employeeId）
  • Display name：注册表单上显示的名称（如员工编号）
  • Required：勾选则表示注册时必须填写
  • Display in registration form：勾选后该字段会出现在用户注册页面
  • 根据需求配置其他验证规则或属性选项
• 保存配置后，访问用户注册页面，即可看到新增的自定义字段

官方文档相关内容翻译（启用用户配置文件部分） #

启用用户配置文件

用户配置文件功能支持自定义用户属性、验证规则，以及注册和账户管理表单的展示。默认情况下，该功能在所有领域中处于启用状态。对于主领域，该功能强制启用，无法被禁用。

若需为非主领域禁用该功能，可按以下步骤操作：

1. 登录管理控制台
2. 选择目标领域
3. 进入Realm Settings -> Features标签页
4. 找到User Profile选项，取消勾选即可禁用

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