第 11 章 客户端注册 CLI
客户端注册 CLI 是应用程序开发人员在与红帽构建的 Keycloak 集成时,用来以自助服务方式配置新客户端的命令行界面(CLI)工具。它旨在与红帽构建的 Keycloak 客户端注册 REST 端点交互。
必须为任何应用程序创建或获取客户端配置,才能使用红帽构建的 Keycloak。您通常会为托管在唯一主机名的每个新应用配置新客户端。当应用程序与红帽构建的 Keycloak 交互时,应用程序会用客户端 ID 标识自己,因此红帽构建的 Keycloak 可以提供登录页面、单点登录(SSO)会话管理和其他服务。
您可以使用 客户端注册 CLI 从命令行配置应用程序客户端,您可以在 shell 脚本中使用它。
要允许特定用户使用 客户端注册 CLI
,红帽构建的 Keycloak 管理员通常使用 Admin Console 配置具有适当角色的新用户,或者配置新客户端和客户端 secret 以授予客户端注册 REST API 的访问权限。
11.1. 配置一个新的常规用户以用于客户端注册 CLI
流程
-
以
admin
用户身份登录管理控制台(例如 http://localhost:8080)。 - 选择要管理的域。
- 如果要使用现有用户,请选择该用户进行编辑;否则,创建一个新用户。
-
选择 角色映射,分配角色。在选项列表中,单击 Filter by client。在搜索栏中,键入
manage-clients
。选择角色,或者您位于 master 域中,请选择带有 NAME-realm 的文件,其中NAME
是目标域的名称。您可以为 master 域中的用户授予任何其他域的访问权限。 - 单击 Assign 以授予一组完整的客户端管理权限。另一个选择是,为只读选择 view-clients 或 create-client 来创建新客户端。
选择 Available Roles,manage-client 来授予一组完整的客户端管理权限。另一个选择是,为只读选择 view-clients 或 create-client 来创建新客户端。
注意这些权限授予用户在不使用 Initial Access Token 或 Registration Access Token 的情况下执行操作的能力(如需更多信息,请参阅 客户端注册服务 )。
无法为用户分配任何 realm-management
角色。在这种情况下,用户仍可使用 客户端注册 CLI 登录,但在没有 Initial Access Token 的情况下无法使用它。在没有令牌的情况下尝试执行任何操作会导致 403 Forbidden 错误。
管理员可以从 Initial Access Token 选项卡中的 Clients 区域发布 Initial Access Tokens。