Доступно с ограничениями в редакциях: Open/CE, Core, BE, SE, SE+

Доступно без ограничений в редакциях:  Ultimate/EE, Certified Core/CSE Lite (1.73), Certified Pro/CSE Pro (1.73)

Входит в расширения: Продвинутая защита инфраструктуры

Стадия жизненного цикла модуля: General Availability

В модуле реализовано 9 алертов.

Модуль включен по умолчанию в наборах модулей: Default, Managed. Модуль выключен по умолчанию в наборе модулей Minimal.

Как явно включить или отключить модуль...

Явно включить или выключить модуль можно одним из следующих способов:

  • С помощью веб-интерфейса Deckhouse. В разделе «Система» → «Управление системой» → «Deckhouse» → «Модули», откройте модуль admission-policy-engine, включите (или выключите) переключатель «Модуль включен». Сохраните изменения.

    Пример:

    Интерфейс включения и выключения модуля

  • С помощью Deckhouse CLI (d8).

    Используйте команду d8 system module enable для включения модуля, или d8 system module disable для выключения модуля (требуется Deckhouse CLI (d8), настроенный на работу с кластером).

    Пример включения модуля admission-policy-engine:

    d8 system module enable admission-policy-engine
    
  • С помощью ModuleConfig admission-policy-engine.

    Установите spec.enabled в true или false в ModuleConfig admission-policy-engine (создайте его, при необходимости).

    Пример манифеста для включения модуля admission-policy-engine:

    apiVersion: deckhouse.io/v1alpha1
    kind: ModuleConfig
    metadata:
      name: admission-policy-engine
    spec:
      enabled: true
    

Как настроить модуль...

Настроить модуль можно одним из следующих способов:

  • С помощью веб-интерфейса Deckhouse.

    В разделе «Система» → «Управление системой» → «Deckhouse» → «Модули», откройте модуль admission-policy-engine, включите переключатель «Дополнительные настройки». Заполните необходимые поля формы на вкладке «Конфигурация», или укажите настройки модуля в формате YAML на вкладке «YAML», не включая секцию settings. Сохраните изменения.

    Пример:

    Интерфейс настройки модуля

    Вы также можете отредактировать объект ModuleConfig admission-policy-engine на вкладке «YAML» в окне настроек модуля («Система» → «Управление системой» → «Deckhouse» → «Модули», откройте модуль admission-policy-engine), указав версию схемы в параметре spec.version и необходимые параметры модуля в секции spec.settings.

  • С помощью Deckhouse CLI (d8) (требуется Deckhouse CLI (d8), настроенный на работу с кластером).

    Отредактируйте существующий ModuleConfig admission-policy-engine (подробнее о настройке Deckhouse читайте в документации), выполнив следующую команду:

    d8 k edit mc admission-policy-engine
    

    Внесите необходимые изменения в секцию spec.settings. При необходимости укажите версию схемы в параметре spec.version. Сохраните изменения.

    Вы также можете создать файл манифеста ModuleConfig admission-policy-engine, используя пример ниже. Заполните секцию spec.settings необходимыми параметрами модуля. При необходимости укажите версию схемы в параметре spec.version.

    Примените манифест с помощью следующей команды (укажите имя файла манифеста):

    d8 k apply -f <FILENAME>
    

    Пример файла манифеста ModuleConfig admission-policy-engine:

    apiVersion: deckhouse.io/v1alpha1
    kind: ModuleConfig
    metadata:
      name: admission-policy-engine
    spec:
      version: 1
      enabled: true
      settings: # Параметры модуля из раздела "Параметры" ниже.
    

Параметры

Версия схемы: 1

  • settings
    объект
    • settings.denyVulnerableImages
      объект

      Доступно в редакциях: Ultimate/EE, Certified Core/CSE Lite (1.73), Certified Pro/CSE Pro (1.73)

      Настройки Trivy-провайдера.

      Trivy-провайдер запрещает создание ресурсов Pod, Deployment, StatefulSet и DaemonSet с образами, содержащими уязвимости, в неймспейсах с лейблом security.deckhouse.io/trivy-provider: "".

      Проверяются образы всех контейнеров, включая init-контейнеры и ephemeral-контейнеры. Поэтому подключение ephemeral-контейнера командой kubectl debug будет отклонено, если его образ содержит уязвимости недопустимого уровня.

      Устарело. Эти настройки были перенесены в модуль operator-trivy. Мигрируйте конфигурацию.

      • settings.denyVulnerableImages.allowedSeverityLevels
        массив строк

        Список допустимых уровней критичности уязвимости.

        Не будут запрещены образы контейнеров, содержащие только уязвимости указанных уровней.

        • Элемент массива
          строка

          Допустимые значения: UNKNOWN, LOW, MEDIUM, HIGH, CRITICAL

      • settings.denyVulnerableImages.enabled
        булевый

        Включить Trivy-провайдер.

        По умолчанию: false

      • settings.denyVulnerableImages.registrySecrets
        массив объектов

        Список дополнительных секретов для доступа к приватным хранилищам образов контейнеров.

        По умолчанию для загрузки образов для сканирования используется секрет deckhouse-registry.

        По умолчанию: []

        • settings.denyVulnerableImages.registrySecrets.name
          строка

          Обязательный параметр

        • settings.denyVulnerableImages.registrySecrets.namespace
          строка

          Обязательный параметр

      • settings.denyVulnerableImages.storageClass
        строка

        Имя StorageClass, который используется Trivy-провайдером.

        Если значение не задано, будет использоваться StorageClass, заданный в глобальном параметре settings.modules.storageClass.

        Глобальный параметр settings.modules.storageClass применяется только при включении модуля. Изменение глобального параметра при включенном модуле не приведет к перезаказу диска.

        Внимание. Если указать значение, отличное от текущего StorageClass, используемого существующим PersistentVolumeClaim, диск будет перезаказан, и все данные удалятся.

        Если указать false, вместо PVC будет принудительно использоваться emptyDir.

        Примеры:

        storageClass: ceph-ssd
        
        storageClass: 'false'
        
    • settings.imageSignatureVerification
      объект

      Доступно в редакциях: SE+, Ultimate/EE, Certified Core/CSE Lite (1.73), Certified Pro/CSE Pro (1.73)

      Настройки проверки подписей образов, которая задаётся политикой verifyImageSignatures ресурса SecurityPolicy.

      • settings.imageSignatureVerification.registryCredentialsCacheTTLSeconds
        целочисленный

        Время в секундах, в течение которого учётные данные приватного хранилища образов, прочитанные из поля dockerCfg ресурса SecurityPolicy, хранятся в кеше.

        После изменения dockerCfg проверка подписей использует прежние учётные данные, пока не истечёт срок записи в кеше. Меньшее значение быстрее применяет новые учётные данные, но чаще читает секрет из Kubernetes API.

        По умолчанию: 300

        Допустимые значения: 30 <= X <= 43200

        Примеры:

        registryCredentialsCacheTTLSeconds: 300
        
        registryCredentialsCacheTTLSeconds: 3600
        
    • settings.podSecurityStandards
      объект

      Настройки политик Pod Security Standards (PSS).

      • settings.podSecurityStandards.controllerValidation
        булевый

        Применяет ограничения к контроллерам, создающим поды (Deployment, StatefulSet, DaemonSet, Job, CronJob, ReplicationController), в дополнение к подам.

        Установите значение true (по умолчанию), чтобы проверять и поды, и контроллеры, либо false — чтобы проверять только поды и не проверять контроллеры.

        Как сообщается о нарушении в контроллере, задаёт параметр controllerValidationEnforcement.

        Параметр задаёт значение по умолчанию для всех ограничений, которые читают спецификацию пода, включая созданные из ресурсов OperationPolicy и SecurityPolicy. Политика переопределяет его собственной секцией spec.controllerValidation.

        По умолчанию: true

      • settings.podSecurityStandards.controllerValidationEnforcement
        строка

        Действие для контроллера, создающего поды, который нарушает политику с enforcementAction: Deny.

        • Warn — контроллер принимается с предупреждением, а поды, которые он создаёт, запрещаются. Значение используется по умолчанию на переходный период, пока рабочие нагрузки приводятся в соответствие с проверкой контроллеров.
        • Policy — контроллер проверяется с действием политики, поэтому запрещающая политика запрещает и контроллер. После переходного периода это значение станет значением по умолчанию.

        Политика с другим действием сохраняет его для контроллеров: Warn предупреждает, а Dryrun только фиксирует нарушение.

        Параметр действует для Pod Security Standards и задаёт значение по умолчанию для ресурсов OperationPolicy и SecurityPolicy. Политика переопределяет его параметром spec.controllerValidation.mode. Параметр действует, если controllerValidation равен true.

        По умолчанию: Warn

        Допустимые значения: Warn, Policy

      • settings.podSecurityStandards.controllerValidationExcludedPolicies
        массив строк

        Правила Pod Security Standards, которые проверяются только на подах.

        Правила называются так же, как параметры SecurityPolicy, в виде которых стандарты опубликованы в объектах d8-pod-security-baseline и d8-pod-security-restricted. Исключённое правило проверяется только на подах в обоих стандартах. Параметр действует, если controllerValidation имеет значение true.

        Некоторые правила проверяются одним ограничением и исключаются вместе: если указано любое правило группы, на подах проверяется вся группа. Группы правил: allowHostPID с allowHostIPC и allowHostNetwork с allowedHostPorts.

        По умолчанию: []

        Пример:

        controllerValidationExcludedPolicies:
        - allowPrivilegeEscalation
        - requiredDropCapabilities
        
        • Элемент массива
          строка

          Допустимые значения: allowPrivileged, allowPrivilegeEscalation, allowHostPID, allowHostIPC, allowHostNetwork, allowedHostPorts, allowedAppArmor, allowedCapabilities, requiredDropCapabilities, allowedHostPaths, allowedProcMount, seLinux, allowedUnsafeSysctls, seccompProfiles, allowedVolumes, runAsUser

      • settings.podSecurityStandards.defaultPolicy
        строка

        Определяет политику Pod Security Standards по умолчанию для всех несистемных неймспейсов:

        • Privileged — политика без ограничений. Данная политика допускает эскалацию привилегий;
        • Baseline — политика с минимальными ограничениями, ограничивающая использование эскалаций привилегий;
        • Restricted — политика с максимальными ограничениями, соответствующая актуальным рекомендациям по безопасному запуску приложений в кластере.

        По умолчанию: Baseline

        Допустимые значения: Privileged, Baseline, Restricted

      • settings.podSecurityStandards.enforcementAction
        строка

        Действие, которое будет выполнено по результатам проверки ограничений:

        • Deny — запрет;
        • Dryrun — отсутствие действия. Применяется при отладке. Информацию о событии можно посмотреть в веб-интерфейсе Deckhouse или с помощью d8 k;
        • Warn — аналогично Dryrun, но дополнительно к информации о событии будет выведена информация о том, из-за какого ограничения (constraint) был бы запрет действия, если бы вместо Warn использовался Deny.

        Действует в прикладных неймспейсах. Неймспейсы с именами d8-* и kube-* модуль обслуживает сам: нарушение там фиксируется, а нагрузка запускается, если владеющий неймспейсом модуль не включил принудительное применение.

        По умолчанию: Deny

        Допустимые значения: Warn, Deny, Dryrun

      • settings.podSecurityStandards.policies
        объект

        Определяет дополнительные параметры политик

        • settings.podSecurityStandards.policies.hostPorts
          объект

          Настройки ограничения HostPort.

          • settings.podSecurityStandards.policies.hostPorts.knownRanges
            массив объектов

            Список диапазонов портов, которые будут разрешены в привязке hostPort.

            • settings.podSecurityStandards.policies.hostPorts.knownRanges.max
              целочисленный
            • settings.podSecurityStandards.policies.hostPorts.knownRanges.min
              целочисленный