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