Keycloak v19注册页面自定义属性：动态加载出生国家选项方案咨询

可行方案：扩展RegistrationProvider并注入自定义属性 #

完全可以通过重写Keycloak的注册提供者（RegistrationProvider）实现，核心逻辑是在后端注册流程中获取国家列表，将其作为自定义属性传递给FTL模板，前端直接渲染选项，无需JS调用API。

具体实现步骤 #

1. 创建自定义RegistrationProvider类
   继承默认的DefaultRegistrationProvider，重写buildRegistrationPage方法，在其中调用外部API获取国家列表并注入模板上下文：

public class CustomRegistrationProvider extends DefaultRegistrationProvider {
    public CustomRegistrationProvider(KeycloakSession session, RegistrationProviderFactory factory) {
        super(session, factory);
    }

    @Override
    public Response buildRegistrationPage(EventBuilder event) {
        // 替换为实际的API调用逻辑获取国家列表
        List<String> countryList = fetchCountriesFromAPI();
        // 将列表放入模板可访问的上下文
        getForm().setAttribute("countryList", countryList);
        return super.buildRegistrationPage(event);
    }

    private List<String> fetchCountriesFromAPI() {
        // 示例：模拟API返回的国家列表，实际替换为HTTP请求逻辑
        List<String> countries = new ArrayList<>();
        countries.add("中国");
        countries.add("美国");
        countries.add("日本");
        return countries;
    }
}

2. 实现RegistrationProviderFactory
   创建工厂类注册自定义提供者：

public class CustomRegistrationProviderFactory implements RegistrationProviderFactory {
    @Override
    public RegistrationProvider create(KeycloakSession session) {
        return new CustomRegistrationProvider(session, this);
    }

    @Override
    public String getId() {
        return "custom-registration"; // 自定义提供者唯一ID
    }

    @Override
    public void init(Config.Scope config) {}

    @Override
    public void postInit(KeycloakSessionFactory factory) {}

    @Override
    public void close() {}
}

3. 配置Keycloak加载自定义提供者

• 将编译后的jar包放入Keycloak的providers目录
• 进入Keycloak管理后台对应Realm，在Authentication > Flows中找到注册流程，将默认注册执行步骤替换为自定义的custom-registration提供者

4. 在FTL模板中渲染下拉框
   在自定义主题的register.ftl中直接使用上下文属性渲染选项：

<div class="form-group">
    <label for="birthCountry">出生国家</label>
    <select id="birthCountry" name="birthCountry" class="form-control">
        <#list countryList as country>
            <option value="${country}">${country}</option>
        </#list>
    </select>
</div>

方案优势 #

相比前端JS方案，这种后端注入的方式：

• 避免页面加载后下拉框短暂为空的体验问题
• 减少前端篡改参数的风险，后端可直接校验提交值
• 符合Keycloak后端驱动模板渲染的设计逻辑

关于重写FreeMarkerLoginFormsProvider的问题 #

你之前重写该类未成功，大概率是因为没有正确注册提供者或模板未正确读取上下文属性。相比之下，扩展RegistrationProvider更贴合注册流程的职责范围，实现更直接。

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