keycloak-russian-providers
Провайдеры авторизации российских социальных сетей для Keycloak.
Please find english version here.
Библиотека провайдеров российских социальных сетей для Keycloak
Посмотреть на это в действии можно здесь - тут используется docker образ из нашей директории на Docker Hub.
Совместимость
Библиотека провайдеров проверялась на следующих версиях Keycloak:
- 26.0.0
- 25.0.2
- 24.0.1
- 23.0.6
- 22.0.3
- 21.1.1
- 21.0.1
- 17.0.0
- 16.1.1
- 15.0.2
- 13.0.0
- 12.0.1
- 11.0.3
- 10.0.0
- 8.0.1
- 4.8.3.Final
- 4.5.0.Final
- 4.4.0.Final
- 3.4.3.Final
Таблица поддерживаемых версий:
Версия библиотеки | Версия Keycloak | Репозиторий |
---|---|---|
26.0.0.rsp | 26.0.0 | Maven Central |
25.0.2.rsp-2 | 25.0.2 | Maven Central |
24.0.1.rsp-3 | 24.0.1 | Maven Central |
23.0.6.rsp-3 | 23.0.6 | Maven Central |
22.0.3.rsp | 22.0.3 | Maven Central |
21.1.1.rsp | 21.1.1 | Maven Central |
1.0.46 | 21.0.1 | Maven Central |
1.0.43 | 17.0.0 | Maven Central |
1.0.42 | 16.1.1 | Maven Central |
1.0.38 | 15.0.2 | Maven Central |
1.0.37 | 13.0.0 | Maven Central |
1.0.32 | 12.0.4 | Maven Central |
1.0.28 | 12.0.0 | Playa Repository |
1.0.26 | 12.0.1 | Playa Repository |
1.0.25 | 11.0.3 | Playa Repository |
1.0.21 | 10.0.0 | Playa Repository |
1.0.17 | 8.0.1 | Playa Repository |
1.0.16 | 6.0.1 | Playa Repository |
1.0.15 | 4.8.3.Final | Playa Repository |
1.0.1 | 4.5.0.Final | Playa Repository |
Установка провайдеров авторизации в Keycloak
Если вы используете Docker:
- вы можете загрузить готовый Keycloak с этим модулем и парой дополнительных тем с Docker Hub: https://github.com/playa-ru/keycloak-russian
docker pull playaru/keycloak-russian
- или соберите проект с профилем
и переменной с указанием токена к GitHub (у токена должны быть выданы права чтение репозитория), получится готовый образ. Например, сборка образа Keycloak:docker
mvn install -Pdocker -Dtoken.github=XXX
Если вы не используете Docker
Можно установить библиотеку провайдеров в ваш Keycloak самостоятельно.
Keycloak <= 16.1.1
Для этого нужно будет вручную выполнить шаги, описанные в Dockerfile, в целом следуя инструкции:
- Соберите проект из исходников с помощью Maven, или возьмите готовый keycloak-russian-providers.jar в нашем репозитории.
- Скопируйте
в [директорию]keycloak-russian-providers.jar
.${keycloak.home.dir}/standalone/deployments - Скопируйте содержимое директории
в/src/main/resources/themes/base/admin/resources/partials${keycloak.home.dir}/themes/base/admin/resources/partials - Добавьте переводы необходимые для темы, для этого необходимо дополнить файлы:
( из файла${keycloak.home.dir}/themes/base/admin/messages/admin-messages_en.custom
)src/main/resources/theme/base/admin/messages/admin-messages_en.custom
( из файла${keycloak.home.dir}/themes/base/admin/messages/admin-messages_ru.custom
)src/main/resources/theme/base/admin/messages/admin-messages_ru.custom
( из файла${keycloak.home.dir}/themes/base/login/messages/messages_en.properties
)src/main/resources/theme/base/login/messages/messages_en.custom
( из файла${keycloak.home.dir}/themes/base/login/messages/messages_ru.properties
)src/main/resources/theme/base/login/messages/messages_ru.custom
Keycloak 17.0.0 - 20.0.5
Для установки модуля авторизации через ЕСИА необходимо выполнить следующие шаги:
- Соберите проект из исходников с помощью Maven, или возьмите готовый keycloak-russian-providers.jar в нашем репозитории.
- Скопируйте
файл в директориюkeycloak-russian-providers.jar/providers - Разархивируйте стандартные темы в папку
(стандартные темы находятся по пути/themes
, где/lib/lib/main/org.keycloak.keycloak-themes-${keycloak-version}
версия Keycloak)keycloak-version - Скопируйте содержимое директории
в/src/main/resources/themes/base/admin/resources/partials${keycloak.home.dir}/themes/base/admin/resources/partials - Добавьте переводы необходимые для темы, для этого необходимо дополнить файлы:
( из файла${keycloak.home.dir}/themes/base/admin/messages/admin-messages_en.custom
)src/main/resources/theme/base/admin/messages/admin-messages_en.custom
( из файла${keycloak.home.dir}/themes/base/admin/messages/admin-messages_ru.custom
)src/main/resources/theme/base/admin/messages/admin-messages_ru.custom
( из файла${keycloak.home.dir}/themes/base/login/messages/messages_en.properties
)src/main/resources/theme/base/login/messages/messages_en.custom
( из файла${keycloak.home.dir}/themes/base/login/messages/messages_ru.properties
)src/main/resources/theme/base/login/messages/messages_ru.custom - Выполнить установку новых модулей для этого необходимо выполнить команду /bin/kc.sh build
Keycloak >= 21.1.1
- Соберите проект из исходников с помощью Maven, или возьмите готовый keycloak-russian-providers.jar в нашем репозитории.
- Скопируйте
файл в директориюkeycloak-russian-providers.jar/providers - Скачайте обновленную версию библиотеки
с github. Шаблон формирования версии библиотекиkeycloak-admin-ui${keycloak-version}.rsp - Скопируйте
вkeycloak-admin-ui/lib/lib/main/org.keycloak.keycloak-admin-ui-${keycloak-version}.jar - Выполнить установку новых модулей для этого необходимо выполнить команду /bin/kc.sh build
Keycloak >= 23.0.0
- Соберите проект из исходников с помощью Maven, или возьмите готовый keycloak-russian-providers.jar в нашем репозитории.
- Скопируйте
файл в директориюkeycloak-russian-providers.jar/providers - Выполнить установку новых модулей для этого необходимо выполнить команду /bin/kc.sh build
Описание
Popular russian mail (Yandex, Mail.ru) and social networks (VK, OK) identity providers for Keycloak Identity and Access Management server.
Языки
Java
- Dockerfile
- HTML