Keycloak：如何通过REST API启用unmanagedAttributePolicy？

要在使用python-keycloak创建Realm时设置UnmanagedAttributePolicy，可以通过以下两种方式实现：

1. 创建Realm时直接注入配置字段 #

python-keycloak的create_realm方法默认可能未封装unmanagedAttributePolicy参数，但你可以手动构造包含该字段的Realm配置字典，再传递给方法：

from keycloak import KeycloakAdmin

# 初始化Admin客户端
keycloak_admin = KeycloakAdmin(
    server_url="http://your-keycloak-url/auth/",
    username='admin',
    password='admin',
    realm_name="master",
    verify=True
)

# 构造Realm配置，添加unmanagedAttributePolicy字段
realm_config = {
    "realm": "your-new-realm",
    "enabled": True,
    # 其他必要配置...
    "unmanagedAttributePolicy": "ALLOW_ALL"  # 可选值：ALLOW_ALL/ALLOW_LIST/DENY_ALL/DENY_LIST
}

# 创建Realm
keycloak_admin.create_realm(payload=realm_config)

2. 创建Realm后更新配置 #

如果上述方法不生效，也可以先创建Realm，再通过更新接口设置该属性：

# 先创建基础Realm
keycloak_admin.create_realm(payload={"realm": "your-new-realm", "enabled": True})

# 更新Realm配置，添加unmanagedAttributePolicy
update_payload = {"unmanagedAttributePolicy": "ALLOW_ALL"}
keycloak_admin.update_realm(realm_name="your-new-realm", payload=update_payload)

说明 #

• unmanagedAttributePolicy的可选值对应Keycloak的策略：
  • ALLOW_ALL：允许所有自定义用户属性
  • ALLOW_LIST：仅允许指定列表内的属性
  • DENY_ALL：拒绝所有自定义属性
  • DENY_LIST：拒绝指定列表内的属性
• 如果使用的python-keycloak版本较旧，建议先升级到最新版，避免因API封装不全导致的问题。

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