Импорт конфигурации realm#
Keycloak Admin CLI#
Импорт осуществляется при помощи утилиты
${keycloak_home}/bin/kcadm.sh. Данный инструмент не позволяет задавать логин и пароль суперадминистратору в целях безопасности. Утилита содержит ряд команд, которые доступны после успешного исполнения скриптаkcadm.sh.
Пример вывода после исполнения скрипта kcadm.sh:
$ kcadm.sh config credentials --server http://localhost:8080/auth --realm master --user admin
Enter password:
Logging into http://localhost:8080/auth as user admin of realm master
Any configured username can be used for login, but to perform admin operations the user
needs proper roles, otherwise operations will fail.
Usage: kcadm.sh COMMAND [ARGUMENTS]
Global options:
-x Print full stack trace when exiting with error
--help Print help for specific command
--config Path to the config file (~/.keycloak/kcadm.config by default)
Commands:
config Set up credentials, and other configuration settings using the config file
create Create new resource
get Get a resource
update Update a resource
delete Delete a resource
get-roles List roles for a user or a group
add-roles Add role to a user or a group
remove-roles Remove role from a user or a group
set-password Re-set password for a user
help This help
Use 'kcadm.sh help <command>' for more information about a given command.
Для версий keycloak на quarkus импорт можно осуществить при помощи исполнения следующей команды
${keycloak_home}/bin/kc.[sh|bat] start --import-realm. В директории{keycloak_home}/data/importсохраняются JSON файлы с настройками для создания realm (кроме realm Master), клиентов, пользователей и аутентификаторов. Примеры файлов.
Keycloak Admin API#
В спецификации Admin REST API есть endpoints по выгрузке, импорту необходимой информации, конфигурироыанию realm и сущностей realm.