Keycloak配置OIDC标准声明用户属性及字段适配的优化方法问询

一、更高效创建OIDC标准声明对应的属性 #

不用靠试错折腾，Keycloak本身提供了现成的OIDC声明映射机制，直接用就行：

• 进入目标Realm的「客户端」菜单，选中你的应用客户端，切换到「映射器」标签页
• 点击「创建」，选「用户属性」类型的映射器：
  • 要是用Keycloak内置属性（比如firstName），直接在「用户属性」栏填firstName，「Token声明名称」填OIDC标准的given_name，保存后就自动完成映射，不用在用户资料里重复建属性
  • 要是需要新增自定义属性（比如birthdate），先在Realm的「用户资料」里创建这个属性，再回到客户端映射器，按上面的方式把它映射到OIDC的birthdate声明即可
• 另外，在Realm设置的「用户声明」里，能全局统一管理所有客户端的OIDC声明映射，适合多客户端共用的场景

二、无需自定义主题/验证器配置字段类型与约束 #

在Realm的「用户资料」里创建或编辑属性时，用内置配置就能搞定类型和约束，完全不用改主题或写自定义验证器：

• 字段类型设置：
  • 生日：创建属性时「类型」选「日期」，注册界面会自动变成日期选择器
  • 性别：「类型」选「枚举」，然后在「枚举值」里加选项（比如male=男、female=女、other=其他），界面直接渲染成下拉列表
• 约束规则配置：
  • 必填：勾选「必填」选项，注册时会强制用户填写
  • 格式校验：在「正则表达式」栏填验证规则（比如邮箱、手机号格式），Keycloak会自动做校验
  • 长度限制：通过「最小长度」「最大长度」设置字符串属性的长度范围

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