Настройки для повышения безопасности (Hardening)
В VK Dev Platform доступны настройки для повышения безопасности компонентов.
Они применяются так же, как и другие дополнительные настройки: в пользовательских параметрах answers_raw_custom_params файла ответов answers.yaml.
Подробнее — в разделе Подготовка файла ответов.
Часть настроек безопасности применяется по умолчанию — вступают в силу при развертывании, дополнительная настройка не требуется (подробнее — в разделе Настройки безопасности по умолчанию).
Другая часть настроек опциональна и включается вручную (подробнее — в разделе Опциональные настройки безопасности).
Дополнительная информация о настройках Hardening — в файлах roles/<РОЛЬ>/README.md внутри образа Shepherd для ролей:
- GitLab,
- Keycloak,
- Nexus,
- Redis,
- SonarQube,
- Zalando.
Следующие настройки безопасности применяются автоматически при развертывании VK Dev Platform 26.3.0 — включать их отдельно не нужно.
PostgreSQL передает логи в формате JSON (log_destination: jsonlog, logging_collector: on). Для разбора и отправки логов в Vector рядом с подом PostgreSQL работает sidecar-контейнер pg-log-forwarder.
На что обратить внимание:
- Ресурсы и образ sidecar настраиваются переменными
zalando_pg_log_forwarder_*(CPU, memory, docker image/tag). Доставка логов работает только при включенном observability-стеке. log_line_prefixзадавался Spilo и раньше — это не новая настройка безопасности. Переопределить параметры логирования можно вzalando_postgresql_additional_params.
Для PostgreSQL ограничены репликационные слоты WAL (Write-Ahead Log), чтобы они не переполнили диск:
max_slot_wal_keep_sizeвычисляется как 20% от размера PVC, но не меньше 256 MB и не больше 8192 MB.- Общий бюджет WAL на томе — 50% от размера PVC.
Также заданы тайм-ауты:
- тайм-аут простоя в открытой транзакции (
idle_in_transaction_session_timeout) — 30 минут; - TCP keepalive: простой до первого keepalive-пакета — 60 сек, интервал между пакетами — 10 сек, количество неотвеченных пакетов до разрыва соединения — 6.
На что обратить внимание:
- Переменные:
zalando_postgresql_parameters_max_slot_wal_keep_size_*,zalando_pg_cluster_wal_budget_percent,zalando_postgresql_parameters_idle_in_transaction_session_timeout,zalando_postgresql_parameters_tcp_keepalives_*. - Лимит касается только репликационных слотов, а не всего WAL. За ошибками архивации нужно следить отдельно.
Контейнер Redis запускается от непривилегированного пользователя (UID 1001, группа 1001). Применены стандартные ограничения безопасности Kubernetes:
- отключены лишние Linux capabilities;
- включен seccomp-профиль
RuntimeDefault; - запрещено повышение привилегий (privilege escalation);
umask 077— новые файлы доступны только владельцу.
Каталог данных и AOF-файлы защищены правами доступа.
На что обратить внимание:
- Фактические права: каталог
/data— 0750, AOF-файлы — 0600. RDB-снапшоты выключены, используется только AOF (Append-Only File). - Настройки контейнера и тома применяются при развертывании Redis, без включения ACL.
Уровень логирования Redis явно задан как notice через переменную redis_log_level.
На что обратить внимание:
Значение notice и ранее было уровнем логирования по умолчанию. Изменение в том, что теперь уровень задается явной переменной, которую можно переопределить.
Образ Keycloak собран с учетом требований безопасности:
- контейнер запускается от непривилегированного пользователя и группы
keycloak(UID/GID 1001:1001); - права на каталоги — 0750, на конфигурационные файлы — 0640, на бинарные файлы — 0540.
На что обратить внимание:
Изменения внесены в образ по результатам отчета hardening. Отдельной переменной инсталлятора для включения и выключения нет.
В области безопасности (realm) Keycloak:
- required action
delete_account(самостоятельное удаление учетной записи пользователем), если присутствует, отключается:enabled: false,defaultAction: false. userManagedAccessAllowed: false— отключен UMA (User-Managed Access).
На что обратить внимание:
- Настройки применяются при развертывании области безопасности, отдельных переменных для включения нет.
- UMA был фактически отключен и раньше — теперь это явно закреплено в конфигурации, а не берется из значения по умолчанию.
Эндпоинт метрик Keycloak /realms/<ОБЛАСТЬ_БЕЗОПАСНОСТИ>/metrics закрыт для внешних запросов на основном и административном Ingress.
На что обратить внимание:
Метрики остаются доступны внутри кластера Kubernetes. Блокировка реализуется через server-snippet конфигурацию Ingress — убедитесь, что ваш Ingress-контроллер поддерживает этот механизм.
Параметры токенов и сессий Keycloak заданы явными значениями:
- время жизни access token — 900 сек;
- время жизни access token для implicit flow — 900 сек;
- ротация refresh-токенов выключена;
- SSO-сессия: тайм-аут простоя (idle) — 1800 сек, максимальное время жизни (max) — 36000 сек;
- сессия клиента: idle/max —
-1(наследует значения SSO-сессии).
На что обратить внимание:
- Более строгие значения (300 сек) и включение ротации refresh-токенов настраиваются вручную (подробнее — в разделе ссылка).
- Значения на уровне области безопасности и на уровне клиента отличаются: отдельные клиенты (GitLab, Nexus, Samsara, SonarQube) могут переопределять параметры через собственные переменные.
Контейнер GitLab Proxy запускается от непривилегированного пользователя (UID/GID 1000). Включены runAsNonRoot, fsGroup: 1000 и seccomp-профиль RuntimeDefault.
В GitLab по умолчанию:
- новые проекты, группы и сниппеты создаются приватными (private);
- разрешенные источники импорта ограничены:
git,gitlab_project,manifest; - Gravatar (аватары по email) выключен.
На что обратить внимание:
Переопределить настройки можно через переменную gitlab_application_settings_extra. Эти настройки не переводят существующие проекты в приватные — применяется только к новым.
В образе Nexus исправлены права на каталоги и сохранен непривилегированный пользователь (UID 200). Роль Nexus при установке задает владельца /nexus-data — chown 200:200.
Контейнер SonarQube запускается с группой 1000 (fsGroup/runAsGroup). Sidecar-контейнер access-log работает:
- от непривилегированного пользователя;
- с ограниченными Linux capabilities;
- с seccomp-профилем;
- без повышения привилегий;
- с доступом только к каталогу logs.
На что обратить внимание:
Настройки применяются ролью SonarQube. При обновлении проверьте, что существующий PVC доступен поду с новыми правами (fsGroup).
Время жизни веб-сессии SonarQube ограничено 4320 минутами (3 суток).
На что обратить внимание:
Задается переменной sonarqube_web_session_timeout_in_minutes. Допустимый диапазон — от 6 до 4320 минут. Чтобы сделать сессию короче, задайте меньшее значение. Как это сделать — в разделе ссылка.
В SonarQube изменены учетные записи администраторов:
- локальный администратор —
local-admin; - администратор через SSO (Keycloak) —
sonarqube-admin; - прежняя учетная запись
adminдеактивируется.
При деактивации admin владение проектами, ALM-токенами и интеграция с VK Dev Platform (Samsara) переносятся на локального администратора.
На что обратить внимание:
Локальная учетная запись и SSO-учетная запись Keycloak — разные сущности. При переносе конфигурации сохраняйте действующие пароли и токены.
OIDC Proxy удаляет HTTP-заголовки аутентификации, переданные клиентом, до того, как запрос уйдет в backend. Это защищает от подмены данных пользователя (login, name, email).
На что обратить внимание:
Защита реализуется конфигурацией OIDC Proxy и применяется для Nexus и SonarQube.
Подробности — в файлах roles/<РОЛЬ>/README.md внутри образа Shepherd.
Следующие настройки применяйте только после успешного обновления VK Dev Platform до версии 26.3.0. Включайте их по одной — после каждой проверяйте работоспособность.
Общий алгоритм действий для каждой настройки:
- Сохраните конфигурацию и действующие секреты.
- Задайте параметры внутри единственного
answers_raw_custom_params(кромеanswers_keycloak_admin_ingress, который находится на верхнем уровне файла ответовanswers.yaml). - Запустите инициализацию (
shepherd init). - Проверьте файл секретов или входные данные (
shepherd secrets list). - Запустите полное развертывание (
shepherd deploy). - Проверьте применение настройки.
Более подробно включение настройки описано на примере Redis ACL.
Чтобы включить Redis ACL:
-
Сохраните конфигурацию и действующие секреты.
-
В файле
answers.yamlдобавьте общий переключательall_redis_acl_enabled: true. Базовая конфигурация связывает его сredis_acl_enabledи создает отдельные учетные записи для клиентовgitlabиsamsaraс соответствующими паролями. Если вы используете custom overrides, проверьте эти связи явно.answers_raw_custom_params:all_redis_acl_enabled: true -
Выполните
shepherd init, чтобы сгенерировать недостающие секреты, и проверьте имена ключей командойshepherd secrets list. Необходимые отсутствующие пароли сгенерируются автоматически, существующие сохранятся. -
Примените настройку полным развертыванием (
shepherd deploy), а не только тегом Redis: пользователь по умолчанию отключается, и клиенты должны перейти на собственные учетные записи и пароли. -
Проверьте вход и работу портала VK Dev Platform и GitLab, Redis probes и exporter. Учитывайте возможный перерыв в работе при переключении и заранее подготовьте план восстановления.
На что обратить внимание:
Переменная all_redis_acl_enabled включает ACL одновременно для Redis и его клиентов (GitLab, Samsara) с отдельными именами пользователей.
Чтобы развернуть PgBouncer для пула соединений с PostgreSQL и переключить клиентов на PgBouncer, задайте:
answers_raw_custom_params:all_zalando_pg_pooler_enabled: true
На что обратить внимание:
Значение по умолчанию — false. Переменная all_zalando_pg_pooler_enabled — общий переключатель: она одновременно разворачивает PgBouncer и переключает балансировщики нагрузки с PostgreSQL на PgBouncer. Настройка только zalando_pg_pooler_install развернет PgBouncer, но не переключит клиентов на него.
Чтобы включить ограничение памяти Redis, задайте:
answers_raw_custom_params:redis_maxmemory_enabled: trueredis_maxmemory_ratio: 0.8
На что обратить внимание:
- По умолчанию выключено.
- Максимальный объем памяти рассчитывается от memory limit пода Redis с учетом коэффициента
redis_maxmemory_ratio. - Политику вытеснения (eviction policy) согласуйте отдельно через переменную
redis_extra_flagsи проверьте поведение рабочей нагрузки.
Чтобы создать Pod Disruption Budget для Redis, задайте:
answers_raw_custom_params:redis_pdb_enabled: true
На что обратить внимание:
- При включении PDB штатные значения
redis_pdb_min_available: 1иredis_pdb_max_unavailable: 0рендерят толькоminAvailable: 1. - Если задаете положительный
redis_pdb_max_unavailable, обнулитеredis_pdb_min_available— Kubernetes не допускает одновременного указания обоих полей. - Для Redis с одним экземпляром значение
minAvailable: 1запрещает вытеснение единственного пода и может блокировать вывод узла из эксплуатации (drain).
Чтобы вынести административную консоль Keycloak на отдельный домен keycloak-admin.<домен> и закрыть разделы администрирования на основном домене, задайте на верхнем уровне файла answers.yaml:
answers_keycloak_admin_ingress: true
При необходимости дополнительно задайте:
all_dns_records_extra.keycloak_admin— доменное имя для административной консоли;keycloak_admin_whitelist— список CIDR-подсетей, которым разрешен доступ к административной консоли.
На что обратить внимание:
- Параметр включает отдельный Ingress для административной консоли. Для нового домена заранее подготовьте DNS-запись и TLS-сертификат.
- На основном Ingress блокируются пути
/adminи/realms/master. После включения проверьте, что инсталлятор и администраторы сохранили доступ. - Блокировка реализуется через server-snippet Ingress — убедитесь, что ваш Ingress-контроллер поддерживает этот механизм.
Чтобы отключить учетную запись администратора Keycloak, создаваемую по умолчанию, и заменить ее локальной учетной записью local-admin, задайте:
answers_raw_custom_params:keycloak_disable_default_admin: true
На что обратить внимание:
При включении создается учетная запись local-admin, в которую копируются права администратора из области безопасности master. Прежняя учетная запись по умолчанию удаляется. Пароль local-admin задается в переменной keycloak_local_admin_password в Kubernetes Secret. Перед включением убедитесь, что у вас есть альтернативный административный доступ к Keycloak.
Чтобы создать дополнительных администраторов Keycloak, задайте список учетных записей в переменной keycloak_local_admins_extra:
answers_raw_custom_params:keycloak_local_admins_extra:- username: "admin2"firstName: "Иван"lastName: "Иванов"email: "admin2@example.com"
На что обратить внимание:
Для всех дополнительных администраторов используется временный пароль из переменной keycloak_local_admins_extra_default_password, который хранится в Kubernetes Secret. Измените его после первого входа. После выполнения shepherd init проверьте, что условные ключи сгенерированы.
Чтобы сократить время жизни токенов и включить ротацию refresh-токенов, задайте:
answers_raw_custom_params:keycloak_access_token_lifespan: 300keycloak_access_token_lifespan_for_implicit_flow: 300keycloak_revoke_refresh_token: true
На что обратить внимание:
- Это рекомендуемые значения для повышения безопасности, а не значения по умолчанию. По умолчанию время жизни токена — 900 секунд, ротация refresh-токенов выключена.
- Отдельные клиенты (GitLab, Nexus, Samsara, SonarQube) могут переопределять время жизни токенов собственными переменными.
- Служебному клиенту Shepherd оставьте время жизни токена не меньше 900 секунд — задается в
keycloak_shepherd_client_access_token_lifespan.
Чтобы настроить тайм-ауты сессий Keycloak, задайте согласованные значения в переменных:
keycloak_sso_session_idle_timeout— тайм-аут простоя SSO-сессии;keycloak_sso_session_max_lifespan— максимальное время жизни SSO-сессии;keycloak_client_session_idle_timeout— тайм-аут простоя сессии клиента;keycloak_client_session_max_lifespan— максимальное время жизни сессии клиента.
На что обратить внимание:
- Отдельные клиенты могут переопределять эти параметры через собственные переменные
<СЕРВИС>_keycloak_client_session_*— проверяйте их отдельно. - Не применяйте ограничения сессий, заданные для пользователей, к сервисным учетным записям (service accounts) — им нужны более длинные сессии.
Чтобы ограничить типы и размеры пользовательских SSH-ключей в GitLab, задайте ограничения в переменной gitlab_application_settings_extra:
answers_raw_custom_params:gitlab_application_settings_extra:dsa_key_restriction: -1rsa_key_restriction: 2048ecdsa_key_restriction: 256ed25519_key_restriction: 256ecdsa_sk_key_restriction: 256ed25519_sk_key_restriction: 256
Здесь -1 полностью запрещает тип ключа, число задает минимальный размер в битах.
На что обратить внимание:
- Это ограничения типов и размеров пользовательских SSH-ключей, а не список транспортных SSH cipher suites (шифров соединения).
- Не добавляйте запрет уровня видимости
public— он нарушает сценарий создания репозиториев из шаблонов.
Чтобы ограничить частоту создания объектов в GitLab (rate limits), задайте соответствующие поля в переменной gitlab_application_settings_extra.
На что обратить внимание:
Значения согласуйте с нагрузкой и интеграциями вашего окружения. Полный список поддерживаемых полей — в файле roles/gitlab/README.md.
Чтобы сократить время жизни веб-сессии SonarQube, задайте sonarqube_web_session_timeout_in_minutes.
На что обратить внимание:
Допустимый диапазон — от 6 до 4320 минут (3 суток). По умолчанию — 4320. После изменения проверьте вход и работу SSO.
Опциональные настройки безопасности, доступные с релиза 26.2.0, сохраняются и задаются в переменных:
zalando_postgres_pg_hba_password_encryption— по умолчаниюmd5, переход наscram-sha-256требует совместимости клиентов и корректного состояния хешей паролей.nexus_custom_encryption_key— кастомный ключ шифрования для секретов в БД, смена уже установленного ключа не поддерживается.nexus_oidc_proxy_haproxy_timeout_*,*_oidc_proxy_haproxy_global_extraи*_defaults_extra— тайм-ауты и дополнительные параметры HAProxy для Nexus и SonarQube.
Это отдельные настройки, не обязательные для версии 26.3.0.
Подробности — в файлах roles/<РОЛЬ>/README.md внутри образа Shepherd.