Запуск проекта для разработчика. Запуск в режиме Standalone#

В этом руководстве объясняются методы настройки KeyCloak.SE, а также способы запуска и применения предпочтительной конфигурации.

KeyCloak.SE загружает конфигурацию из четырех различных источников конфигурации:

  1. параметры командной строки

  2. переменные среды

  3. созданный пользователем файл .conf

  4. файл keycloak.conf, расположенный в каталоге conf.

Источники конфигурации имеют приоритет по убыванию: параметры командной строки имеют приоритет над переменными среды. Переменные среды имеют приоритет над параметрами, заданными с помощью определенного файла конфигурации. Параметры из определенного конфигурационного файла имеют приоритет над параметрами, определенными в conf/keycloak.conf. Когда один и тот же ключ конфигурации найден в нескольких источниках конфигурации, применяемое значение берется из источника конфигурации с наивысшим порядком приоритета.

Необходимо развернуть скомпилированные модули в директорию /providers:

Обязательные модули:

  • kcse-common-security.jar;

  • kcse-commons-lib.jar;

  • kcse-commons-runnable.jar;

  • kcse-core.jar;

  • kcse-keycloak-attribute-manager.jar;

  • kcse-keycloak-rest-module.jar;

  • com.google.code.gson:gson:2.8.6;

  • org.json:json:20210307;

  • org.apache.commons:commons-text:1.8;

  • org.glassfish:jakarta.json:1.1.6.

Остальные модули также должны быть размещены в этой папке.

При первом запуске необходимо добавить хотя бы одного пользователя при помощи скрипта add-user-keycloak.sh (add-user-keycloak.bat) в папке bin.

Порт сервиса для доступа к UI настраивается в конфигурационных файлах kc.sh.

Запуска сервиса осуществляется стартовым скриптом bin/kc.sh (kc.bat)

Пример запуска: bin/kc.[sh|bat] start

В случае успешного старта в консоли будет сообщение следующего содержания:

16:18:12,106 INFO  [io.quarkus] (main) Keycloak 18.0.2 on JVM (powered by Quarkus 2.7.5.Final) started in 7.871s. Listening on: http://0.0.0.0:8080 and https://0.0.0.0:8443

Теперь в браузере можно перейти к UI сервиса по ссылке http://localhost:8443 (порт ранее настраивается в конфигах kc.sh)

UI