Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

第 6 章 使用 CLI 自动化客户端注册

客户端注册 CLI 是应用程序开发人员的命令行界面(CLI)工具，用于在与红帽构建的 Keycloak 集成时以自助服务方式配置新客户端。它旨在与红帽构建的 Keycloak 客户端注册 REST 端点交互。

需要为任何应用程序创建或获取客户端配置才能使用红帽构建的 Keycloak。您通常为每个托管在唯一主机名上的新应用程序配置新客户端。当应用程序与红帽构建的 Keycloak 交互时，应用程序会使用客户端 ID 标识自己，以便红帽构建的 Keycloak 可以提供登录页面、单点登录(SSO)会话管理和其他服务。

您可以使用客户端注册 CLI 从命令行配置应用程序客户端，您可以在 shell 脚本中使用它。

要允许特定用户使用 客户端注册 CLI，红帽构建的 Keycloak 管理员通常使用管理控制台配置具有正确角色的新用户，或配置新客户端和客户端 secret 以授予对客户端注册 REST API 的访问权限。

流程

  1. 以 admin 用户身份登录管理控制台（例如 ，http://localhost:8080/admin）。
  2. 选择要管理的域。
  3. 如果要使用现有用户，请选择该用户要编辑的用户；否则，请创建新用户。
  4. 选择 Role Mappings > Client Roles > realm-management。如果您位于 master 域中，请选择 NAME-realm，其中 NAME 是目标域的名称。您可以向 master 域中的用户授予任何其他域的访问权限。

  5. 选择 Available Roles > manage-client 来授予一组完整的客户端管理权限。另一种选择 view-clients 用于只读，或选择 create-client 来创建新客户端。

    注意

    这些权限授予用户在不使用 Initial Access Token 或 Registration Access Token 的情况下执行操作的权限。

无法向用户分配任何 realm-management 角色。在这种情况下，用户仍然可以使用客户端注册 CLI 登录，但在没有初始访问令牌的情况下无法使用它。在没有令牌的情况下尝试执行任何操作会导致 403 Forbidden 错误。

管理员可以通过 Realm Settings > Client Registration > Initial Access Token 菜单从 Admin 控制台中发出 Initial Access Tokens。

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat