VK Dev Platform logo
Помощь
Обновлена 6 ноября 2026 г. в 11:18

Настройки для повышения безопасности (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

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.

Ограничение WAL-слотов PostgreSQL

Для 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. За ошибками архивации нужно следить отдельно.

Non-root контейнер Redis

Контейнер 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

Уровень логирования Redis явно задан как notice через переменную redis_log_level.

На что обратить внимание:

Значение notice и ранее было уровнем логирования по умолчанию. Изменение в том, что теперь уровень задается явной переменной, которую можно переопределить.

Образ Keycloak

Образ Keycloak собран с учетом требований безопасности:

  • контейнер запускается от непривилегированного пользователя и группы keycloak (UID/GID 1001:1001);
  • права на каталоги — 0750, на конфигурационные файлы — 0640, на бинарные файлы — 0540.

На что обратить внимание:

Изменения внесены в образ по результатам отчета hardening. Отдельной переменной инсталлятора для включения и выключения нет.

Required actions и UMA в Keycloak

В области безопасности (realm) Keycloak:

  • required action delete_account (самостоятельное удаление учетной записи пользователем), если присутствует, отключается: enabled: false, defaultAction: false.
  • userManagedAccessAllowed: false — отключен UMA (User-Managed Access).

На что обратить внимание:

  • Настройки применяются при развертывании области безопасности, отдельных переменных для включения нет.
  • UMA был фактически отключен и раньше — теперь это явно закреплено в конфигурации, а не берется из значения по умолчанию.

Доступ к метрикам Keycloak

Эндпоинт метрик Keycloak /realms/<ОБЛАСТЬ_БЕЗОПАСНОСТИ>/metrics закрыт для внешних запросов на основном и административном Ingress.

На что обратить внимание:

Метрики остаются доступны внутри кластера Kubernetes. Блокировка реализуется через server-snippet конфигурацию Ingress — убедитесь, что ваш Ingress-контроллер поддерживает этот механизм.

Токены и сессии Keycloak

Параметры токенов и сессий 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

Контейнер GitLab Proxy запускается от непривилегированного пользователя (UID/GID 1000). Включены runAsNonRoot, fsGroup: 1000 и seccomp-профиль RuntimeDefault.

Видимость проектов и импорт в GitLab

В GitLab по умолчанию:

  • новые проекты, группы и сниппеты создаются приватными (private);
  • разрешенные источники импорта ограничены: git, gitlab_project, manifest;
  • Gravatar (аватары по email) выключен.

На что обратить внимание:

Переопределить настройки можно через переменную gitlab_application_settings_extra. Эти настройки не переводят существующие проекты в приватные — применяется только к новым.

Права каталогов Nexus

В образе Nexus исправлены права на каталоги и сохранен непривилегированный пользователь (UID 200). Роль Nexus при установке задает владельца /nexus-data — chown 200:200.

Контейнер SonarQube

Контейнер SonarQube запускается с группой 1000 (fsGroup/runAsGroup). Sidecar-контейнер access-log работает:

  • от непривилегированного пользователя;
  • с ограниченными Linux capabilities;
  • с seccomp-профилем;
  • без повышения привилегий;
  • с доступом только к каталогу logs.

На что обратить внимание:

Настройки применяются ролью SonarQube. При обновлении проверьте, что существующий PVC доступен поду с новыми правами (fsGroup).

Веб-сессия SonarQube

Время жизни веб-сессии SonarQube ограничено 4320 минутами (3 суток).

На что обратить внимание:

Задается переменной sonarqube_web_session_timeout_in_minutes. Допустимый диапазон — от 6 до 4320 минут. Чтобы сделать сессию короче, задайте меньшее значение. Как это сделать — в разделе ссылка.

Администраторы SonarQube

В SonarQube изменены учетные записи администраторов:

  • локальный администратор — local-admin;
  • администратор через SSO (Keycloak) — sonarqube-admin;
  • прежняя учетная запись admin деактивируется.

При деактивации admin владение проектами, ALM-токенами и интеграция с VK Dev Platform (Samsara) переносятся на локального администратора.

На что обратить внимание:

Локальная учетная запись и SSO-учетная запись Keycloak — разные сущности. При переносе конфигурации сохраняйте действующие пароли и токены.

Заголовки аутентификации в OIDC Proxy

OIDC Proxy удаляет HTTP-заголовки аутентификации, переданные клиентом, до того, как запрос уйдет в backend. Это защищает от подмены данных пользователя (login, name, email).

На что обратить внимание:

Защита реализуется конфигурацией OIDC Proxy и применяется для Nexus и SonarQube.

Подробности — в файлах roles/<РОЛЬ>/README.md внутри образа Shepherd.

Опциональные настройки безопасности

Следующие настройки применяйте только после успешного обновления VK Dev Platform до версии 26.3.0. Включайте их по одной — после каждой проверяйте работоспособность.

Общий алгоритм действий для каждой настройки:

  1. Сохраните конфигурацию и действующие секреты.
  2. Задайте параметры внутри единственного answers_raw_custom_params (кроме answers_keycloak_admin_ingress, который находится на верхнем уровне файла ответов answers.yaml).
  3. Запустите инициализацию (shepherd init).
  4. Проверьте файл секретов или входные данные (shepherd secrets list).
  5. Запустите полное развертывание (shepherd deploy).
  6. Проверьте применение настройки.

Более подробно включение настройки описано на примере Redis ACL.

Redis ACL

Чтобы включить Redis ACL:

  1. Сохраните конфигурацию и действующие секреты.

  2. В файле answers.yaml добавьте общий переключатель all_redis_acl_enabled: true. Базовая конфигурация связывает его с redis_acl_enabled и создает отдельные учетные записи для клиентов gitlab и samsara с соответствующими паролями. Если вы используете custom overrides, проверьте эти связи явно.

    answers_raw_custom_params:  all_redis_acl_enabled: true
  3. Выполните shepherd init, чтобы сгенерировать недостающие секреты, и проверьте имена ключей командой shepherd secrets list. Необходимые отсутствующие пароли сгенерируются автоматически, существующие сохранятся.

  4. Примените настройку полным развертыванием (shepherd deploy), а не только тегом Redis: пользователь по умолчанию отключается, и клиенты должны перейти на собственные учетные записи и пароли.

  5. Проверьте вход и работу портала VK Dev Platform и GitLab, Redis probes и exporter. Учитывайте возможный перерыв в работе при переключении и заранее подготовьте план восстановления.

На что обратить внимание:

Переменная all_redis_acl_enabled включает ACL одновременно для Redis и его клиентов (GitLab, Samsara) с отдельными именами пользователей.

PgBouncer для компонентов

Чтобы развернуть 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 maxmemory

Чтобы включить ограничение памяти Redis, задайте:

answers_raw_custom_params:  redis_maxmemory_enabled: true  redis_maxmemory_ratio: 0.8

На что обратить внимание:

  • По умолчанию выключено.
  • Максимальный объем памяти рассчитывается от memory limit пода Redis с учетом коэффициента redis_maxmemory_ratio.
  • Политику вытеснения (eviction policy) согласуйте отдельно через переменную redis_extra_flags и проверьте поведение рабочей нагрузки.

Redis PDB

Чтобы создать 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 admin на отдельном домене

Чтобы вынести административную консоль 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-контроллер поддерживает этот механизм.

Замена default admin Keycloak

Чтобы отключить учетную запись администратора 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 admins

Чтобы создать дополнительных администраторов 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 проверьте, что условные ключи сгенерированы.

Keycloak token hardening

Чтобы сократить время жизни токенов и включить ротацию refresh-токенов, задайте:

answers_raw_custom_params:  keycloak_access_token_lifespan: 300  keycloak_access_token_lifespan_for_implicit_flow: 300  keycloak_revoke_refresh_token: true

На что обратить внимание:

  • Это рекомендуемые значения для повышения безопасности, а не значения по умолчанию. По умолчанию время жизни токена — 900 секунд, ротация refresh-токенов выключена.
  • Отдельные клиенты (GitLab, Nexus, Samsara, SonarQube) могут переопределять время жизни токенов собственными переменными.
  • Служебному клиенту Shepherd оставьте время жизни токена не меньше 900 секунд — задается в keycloak_shepherd_client_access_token_lifespan.

Keycloak session hardening

Чтобы настроить тайм-ауты сессий 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) — им нужны более длинные сессии.

GitLab SSH key policy

Чтобы ограничить типы и размеры пользовательских SSH-ключей в GitLab, задайте ограничения в переменной gitlab_application_settings_extra:

answers_raw_custom_params:  gitlab_application_settings_extra:    dsa_key_restriction: -1    rsa_key_restriction: 2048    ecdsa_key_restriction: 256    ed25519_key_restriction: 256    ecdsa_sk_key_restriction: 256    ed25519_sk_key_restriction: 256

Здесь -1 полностью запрещает тип ключа, число задает минимальный размер в битах.

На что обратить внимание:

  • Это ограничения типов и размеров пользовательских SSH-ключей, а не список транспортных SSH cipher suites (шифров соединения).
  • Не добавляйте запрет уровня видимости public — он нарушает сценарий создания репозиториев из шаблонов.

GitLab rate limits

Чтобы ограничить частоту создания объектов в GitLab (rate limits), задайте соответствующие поля в переменной gitlab_application_settings_extra.

На что обратить внимание:

Значения согласуйте с нагрузкой и интеграциями вашего окружения. Полный список поддерживаемых полей — в файле roles/gitlab/README.md.

SonarQube shorter session

Чтобы сократить время жизни веб-сессии SonarQube, задайте sonarqube_web_session_timeout_in_minutes.

На что обратить внимание:

Допустимый диапазон — от 6 до 4320 минут (3 суток). По умолчанию — 4320. После изменения проверьте вход и работу SSO.

Zalando Postgres, OIDC Proxy, Nexus

Опциональные настройки безопасности, доступные с релиза 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.

Была ли статья полезна?