如何通过kcadm CLI工具配置Keycloak客户端注册策略的可信主机？

我来帮你搞定用kcadm CLI在Keycloak里添加可信主机的事儿，其实步骤不算复杂，跟着下面的操作来就行：

1. 先完成kcadm管理员身份验证 #

首先得确保你已经通过kcadm登录到Keycloak服务器，获取管理员令牌。根据你的Keycloak版本，命令略有不同：

• 对于Keycloak 16及更早版本：

  kcadm config credentials --server http://your-keycloak-url/auth --realm master --user admin --password your-admin-password
  

• 对于Keycloak 17+（Quarkus版本）：

  kcadm config credentials --server http://your-keycloak-url/admin --realm master --user admin --password your-admin-password
  

记得把命令里的your-keycloak-url、admin、your-admin-password替换成你自己的实际信息。

2. 获取目标Realm的客户端注册策略列表 #

切换到你要配置的Realm，获取所有客户端注册策略，找到其中类型为trustedHosts的策略ID：

kcadm get client-registration-policies -r your-realm-name

替换your-realm-name为你的目标Realm名称。执行后会返回JSON格式的策略列表，找到类似下面的条目，记下它的id值：

{
  "id": "abc123-def456-ghi789",
  "name": "Trusted Hosts",
  "type": "trustedHosts",
  "config": {
    "hosts": ["existing-host.com", "another-host.com"]
  },
  "enabled": true
}

3. 更新可信主机配置 #

现在有两种方式来添加新的可信主机：

方式一：通过JSON文件更新 #

先把当前的可信主机策略配置导出到本地文件：

kcadm get client-registration-policies/abc123-def456-ghi789 -r your-realm-name > trusted-hosts-policy.json

替换abc123-def456-ghi789为你刚才拿到的策略ID，your-realm-name还是目标Realm名称。

打开导出的trusted-hosts-policy.json文件，找到config.hosts数组，添加你要新增的可信主机，比如：

"config": {
  "hosts": ["existing-host.com", "another-host.com", "new-trusted-host.com"]
}

然后用这个文件更新策略：

kcadm update client-registration-policies/abc123-def456-ghi789 -r your-realm-name -f trusted-hosts-policy.json

方式二：直接通过命令行参数更新 #

如果不想用文件，也可以直接在命令行里指定更新内容（注意这里是覆盖原有数组，所以要把所有现有主机和新主机都列出来）：

kcadm update client-registration-policies/abc123-def456-ghi789 -r your-realm-name -s 'config.hosts=["existing-host.com","another-host.com","new-trusted-host.com"]'

4. 验证配置是否生效 #

执行完更新命令后，可以再次获取策略配置，确认新的主机已经添加进去：

kcadm get client-registration-policies/abc123-def456-ghi789 -r your-realm-name

检查返回的config.hosts数组，应该能看到你刚添加的主机。

注意： 如果你是Keycloak 17+，确保所有命令里的服务器路径都用/admin而不是/auth，不然会报错哦。

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