17.8. 使用管理控制台导入和导出
您还可以使用管理控制台导入和导出域。此功能与前面部分中描述的其他 CLI 选项不同,因为管理控制台仅提供 部分 导出域的功能。在这种情况下,可以导出当前的域设置,以及客户端、角色和组等某些资源。无法 使用此方法导出该域的用户。
使用 Admin Console 导出时,realm 和 selected 资源始终导出到名为 realm-export.json
的文件中。另外,密码和客户端 secret 等所有敏感值都使用 *
符号屏蔽。
要使用管理控制台导出域,请执行以下步骤:
- 选择一个 realm。
- 点菜单中的 Realm settings。
指向域设置屏幕右上角的 Action 菜单,然后选择 Partial export。
一个资源列表以及 realm 配置一起会出现。
- 选择您要导出的资源。
- 单击 Export。
从管理控制台导出的域不适用于在服务器之间备份或数据传输。只有 CLI 导出适合服务器之间备份或数据传输。
如果域包含多个组、角色和客户端,则操作可能会导致服务器在一段时间内响应用户请求。请谨慎使用此功能,特别是在生产系统上。
同样,您可以导入之前导出的域。执行以下步骤:
- 点菜单中的 Realm settings。
指向域设置屏幕右上角的 Action 菜单,然后选择 Partial import。
此时会出现一个提示,您可以在其中选择要导入的文件。根据此文件,您可以看到您可以导入的资源以及 realm 设置。
- 点 Import。
如果导入的资源已存在,您还可以控制红帽构建的 Keycloak 应该做什么。这些选项存在:
- 导入失败
- 中止导入。
- skip
- 跳过重复资源而不中止进程
- 覆盖
- 将现有资源替换为正在导入的资源。
管理控制台部分导入也可以导入 CLI export
命令创建的文件。换句话说,可以使用管理控制台导入 CLI 创建的完整导出。如果文件中包含用户,则这些用户也可以导入到当前域中。