如何通过admin-cli将角色添加至Keycloak 3.4.3的默认领域角色列表

我刚好处理过类似的Keycloak 3.x版本的配置需求，给你一步步拆解怎么用admin-cli完成这个操作：

步骤1：通过admin-cli登录Keycloak管理端 #

首先得先让admin-cli获得操作权限，如果你是直接在Docker容器内操作，先进入容器终端：

docker exec -it <你的Keycloak容器名称> /bin/bash

然后执行登录命令（替换占位符为你的实际信息）：

/opt/jboss/keycloak/bin/kcadm.sh config credentials \
  --server http://localhost:8080/auth \
  --realm master \
  --user <管理员用户名> \
  --password <管理员密码>

步骤2：获取目标角色的ID #

要添加为默认角色的目标角色，我们需要先拿到它的ID。假设你的目标领域是my-realm，角色名为my-auto-assign-role，执行以下命令：

/opt/jboss/keycloak/bin/kcadm.sh get realms/my-realm/roles/my-auto-assign-role --fields id

执行后会返回类似{"id": "abc123-def456-ghi789"}的结果，把这个ID记下来。

步骤3：将目标角色添加到领域默认角色列表 #

Keycloak 3.4.3的领域默认角色存储在realm的defaultRoles字段中，我们可以用kcadm.sh update命令直接追加这个角色：

/opt/jboss/keycloak/bin/kcadm.sh update realms/my-realm \
  -s "defaultRoles+=abc123-def456-ghi789"

这里的abc123-def456-ghi789替换成你刚才拿到的角色ID。

步骤4：验证配置是否生效 #

执行以下命令查看领域的默认角色列表，确认目标角色已经被添加进去：

/opt/jboss/keycloak/bin/kcadm.sh get realms/my-realm --fields defaultRoles

返回的数组里应该包含你刚才添加的角色ID或角色名（取决于Keycloak返回格式）。

完成以上步骤后，新用户通过网页注册表单注册时，就会自动获得这个指定的领域角色了。

内容的提问来源于stack exchange，提问作者Flv N.