Что такое Keycloak
Keycloak — сервер идентификации и доступа для приложений. Он централизует вход, пользователей, группы и правила аутентификации. Сотрудник проходит один согласованный путь входа, а приложение получает результат по стандартному протоколу. Сам Keycloak не меняет код приложения: клиентскую интеграцию настраивают или разрабатывают отдельно.
Realms и границы доступа
Realm изолирует пользователей, клиентов, роли и настройки входа. Его не нужно создавать для каждого отдела автоматически: слишком много realms усложняют администрирование, а слишком мало — смешивают разные зоны доверия. Структуру определяют по владельцам данных, политикам и интеграциям.
Приложения, OIDC и SAML
Приложение регистрируют как client, задают допустимые адреса возврата, секреты, scopes и роли. OIDC обычно удобен для современных web- и мобильных приложений, SAML — для совместимых корпоративных систем. После входа важно проверить logout, срок сессии и то, какие права приложение действительно читает из токена.
Пользователи и федерация каталогов
Учётные записи ведут локально или подключают внешний каталог. Группы и роли помогают передавать права, но источник истины и правило отключения уволенного сотрудника выбирают до синхронизации. При identity brokering отдельно проверяют привязку внешней учётной записи к существующему пользователю.
MFA и сценарии входа
Authentication flows задают шаги входа, включая OTP и WebAuthn. Новый flow сначала проверяют на тестовой группе, иначе можно одновременно заблокировать пользователей и администраторов. Для критичных систем заранее сохраняют аварийную административную процедуру.
Размещение и отказоустойчивость
Keycloak написан на Java, запускается на Quarkus и в production работает с внешней базой, например PostgreSQL. Для кластера применяется распределённый кеш Infinispan. Ресурсы зависят от числа активных сессий, частоты входов, клиентов и требований к высокой доступности; универсальный VPS-профиль без нагрузочного теста был бы ложным ориентиром.
Внедрение и миграция
Начинают с одного приложения и группы пользователей. Проверяют вход, назначение роли, истечение токена, MFA, восстановление доступа и выход. Перенос учётных записей может потребовать сброса паролей или поэтапной федерации — это зависит от текущего источника и допустимого формата данных. Доработка клиентского приложения оценивается отдельно от настройки Keycloak.
Эксплуатация и стоимость
Следят за входами, ошибками, задержкой базы, состоянием кеша и сроком сертификатов. Перед обновлением фиксируют версию, сохраняют базу и конфигурацию, затем проверяют тестовых клиентов. Лицензия открытая, но эксплуатация общей точки входа требует постоянного внимания и процедуры восстановления, а не только работающего контейнера.
Вопросы и ответы
Интерфейс Keycloak
Личный кабинет и администрирование
Снимки официального руководства показывают клиентов, пользователей и flow входа.
Личный кабинет
Снимки из официального руководства Keycloak, проверены 2 октября 2026 года. Часть экранов относится к предыдущим версиям и может отличаться от 26.8.0.