Keycloak 19.0.2通过REST API创建默认类型客户端作用域失败

问题原因 #

你通过REST API创建默认类型的SAML客户端作用域时，指定的type字段值为小写的"default"，但Keycloak的API要求该字段使用大写枚举值，无法识别小写值导致作用域类型被设为None。

修复后的请求体 #

将请求中的type字段改为大写的"DEFAULT"即可解决问题，完整请求体如下：

{
  "attributes": {
    "display.on.consent.screen": "false",
    "include.in.token.scope": "false",
    "gui.order": "1"
  },
  "name": "example",
  "description": "example",
  "type": "DEFAULT",
  "protocol": "saml"
}

补充说明 #

Keycloak内部对客户端作用域类型采用枚举定义（有效值为DEFAULT、OPTIONAL等），虽然UI提交的请求表面显示为小写，但后端会自动转换为大写格式。直接传入小写值会触发默认逻辑，将作用域类型置为None。

内容的提问来源于stack exchange，提问作者Sirish Kumar Bethala