Keycloak 20.0.2自定义协议映射器位置及添加方法咨询

Keycloak从17版本切换到新管理控制台后，自定义映射器的创建逻辑有了调整，不再像16版本那样直接在客户端下添加，而是通过**客户端范围（Client Scopes）**来管理，具体操作步骤如下：

方法一：创建全局自定义客户端范围并关联到客户端 #

• 打开Keycloak管理控制台，左侧菜单栏点击Client Scopes
• 点击右上角的Create，输入一个易识别的范围名称（例如custom-user-claims），完成创建
• 进入刚创建的客户端范围，切换到Mappers标签页
• 点击Add mapper，选择By configuration（这就是自定义映射器的入口，之前你看到的预定义是By predefined选项）
• 选择对应的映射器类型（比如User Attribute、Hardcoded Claim等），根据需求填写配置项（比如属性名称、声明名称、是否包含在ID Token/Access Token中），保存即可
• 回到目标客户端，切换到Client Scopes标签页，在Available Client Scopes列表找到你创建的自定义范围，点击Add selected将其移到Assigned Client Scopes
• 若需要该范围的映射器默认生效，可切换到Default Client Scopes标签，将自定义范围从Optional列表移到Default列表

方法二：创建客户端专属的自定义映射器 #

如果只需要给单个客户端添加专属映射器，也可以直接在客户端内创建专属范围：

• 进入目标客户端，切换到Client Scopes标签页
• 点击页面上方的Create按钮（注意不是右侧的Add按钮），创建一个属于该客户端的专属范围
• 进入这个专属范围，按照方法一中的步骤添加自定义映射器即可，无需额外关联

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