Управление доступом к cluster-wide-ресурсам

Что делать, если PersistentVolumeClaim отклонён с ошибкой «is not available to project»?

Указанный в spec.storageClassName StorageClass недоступен проекту. Вебхук отклоняет такой запрос с сообщением вида:

[multitenancy] PersistentVolumeClaim "<OBJECT_NAME>" references "<RESOURCE_NAME>" which is not available to project "<PROJECT_NAME>". Ask the cluster administrator to grant it.

Чтобы просмотреть доступные StorageClass, выполните следующую команду:

d8 k get available storageclasses -n <PROJECT_NAME> -o yaml

Если нужного StorageClass нет в списке, используйте доступный или попросите администратора кластера добавить его в ClusterResourceGrantPolicy.

Аналогичным образом можно проверить доступность других cluster-wide-ресурсов (например, ClusterIssuer, ClusterRole, LoadBalancerClass) с помощью соответствующего AvailableClusterResource.

Как узнать, какие политики доступа применяются к проекту?

Политика ClusterResourceGrantPolicy применяется к неймспейсу проекта, если совпали все заданные в ней селекторы: spec.projectSelector сопоставляется с лейблами Project, spec.namespaceSelector — с лейблами неймспейса. Политика без обоих селекторов является библиотечной и применяется только через параметр spec.grantPolicies шаблона проекта. Подробнее — в подразделе «Как политика выбирает неймспейсы».

Чтобы просмотреть все политики и их селекторы, выполните следующую команду:

d8 k get clusterresourcegrantpolicies -o yaml

Полученный список cluster-wide-ресурсов, доступных конкретному проекту, можно просмотреть с помощью AvailableClusterResource:

d8 k get available -n <PROJECT_NAME>

Что произойдёт с существующими объектами после ограничения доступа?

Существующие объекты продолжат использовать ранее заданные значения. При обновлении объекта проверяются только новые значения, поэтому изменение политики доступа не нарушает работу уже созданных объектов. То же действует при включении управления доступом на существующем кластере: перед созданием политик доступа изменять существующие объекты не требуется.

Если существующий объект должен использовать другой cluster-wide-ресурс, явно измените соответствующее поле на доступное проекту значение.

Если существующий объект использует cluster-wide-ресурс, который больше не доступен проекту, срабатывает алерт ClusterResourceGrantPolicyViolation.

Что означает алерт ClusterResourceGrantPolicyViolation?

Алерт означает, что один или несколько существующих объектов в проекте используют cluster-wide-ресурс, который больше не доступен проекту согласно текущим политикам.

Такие объекты продолжают работать. Чтобы устранить расхождение, предоставьте проекту доступ к используемому cluster-wide-ресурсу или измените объект так, чтобы он использовал доступный ресурс.

Подробную информацию о нарушениях можно посмотреть на дашборде Grafana в разделе «Security» → «Cluster Resource Grant Violations». Для мониторинга используется метрика d8_cluster_objects_grant_violated; её отдаёт контроллер модуля по тем же правилам доступности, что и вебхук /is-granted.

Как разрешить все StorageClasses, кроме отдельных?

Чтобы запретить отдельные StorageClass, оставив остальные доступными, используйте параметр denied или deniedSelector. Запрет имеет приоритет над разрешением.

Пример настройки приведён в подразделе «Запрет отдельных ресурсов».

Что происходит, если ClusterResourceGrantPolicy отсутствует?

Если для ресурса не задана ни одна политика ClusterResourceGrantPolicy, его доступность определяется регистрацией: ресурс доступен всем проектам, если в GrantableClusterResourceDefinition задано defaultAvailability: All (значение по умолчанию) и ресурс не попадает под фильтры excluded или reserved.

Например, определение clusterroles, поставляемое Deckhouse Platform, исключает все ClusterRole без лейбла rbac.deckhouse.io/delegatable: "true", поэтому такие роли недоступны в RoleBinding даже при отсутствии политик.

Чтобы ограничить доступ, создайте ClusterResourceGrantPolicy и укажите проекты и доступные им cluster-wide-ресурсы.

Я создал ClusterResourceGrantPolicy, но ничего не изменилось — почему?

Проверьте по порядку:

  1. Соответствие селекторам. Убедитесь, что spec.projectSelector политики соответствует лейблам Project, а spec.namespaceSelector — лейблам неймспейса:

    Получить информацию о проекте и его лейблы:

    d8 k get project <PROJECT_NAME> --show-labels
    

    Отфильтровать неймспейсы по лейблу projects.deckhouse.io/project=<PROJECT_NAME> и показать их лейблы:

    d8 k get ns -l projects.deckhouse.io/project=<PROJECT_NAME> --show-labels
    

    В манифесте v1alpha1 поле spec.projectSelector — это spec.namespaceSelector версии v1alpha2. Также проверьте условия в статусе политики. Условие SelectorsValid принимает значение False, если селектор некорректен. Условие NewNamespacesCovered принимает значение False, если ограничение не распространяется на новый дополнительный неймспейс проекта. Условие AllowedEffective принимает значение False, если GrantableClusterResourceDefinition исключает имя из allowed, например ClusterRole без лейбла rbac.deckhouse.io/delegatable: "true". Это имя указано в сообщении (подробнее — в разделе «Ограничение ClusterRole для проекта»).

  2. Доступные ресурсы проекта. Проверьте, отражает ли AvailableClusterResource ожидаемые настройки политики:

    d8 k get available <RESOURCE_NAME> -n <PROJECT_NAME> -o yaml
    
  3. Регистрация cluster-wide-ресурса. Убедитесь, что для значения resourceName существует соответствующий ресурс GrantableClusterResourceDefinition.

  4. Регистрация ссылки. Если ожидается проверка определённого поля, убедитесь, что оно зарегистрировано с помощью GrantableClusterResourceReference и ссылка успешно связана с соответствующим GrantableClusterResourceDefinition.

Описание состояния регистрации приведено в разделе «Проверка состояния регистрации ресурса».

Как управление доступом к cluster-wide-ресурсам взаимодействует с RBAC?

Это независимые механизмы. RBAC определяет, кто может выполнять операции с объектом, а механизм управления доступом к cluster-wide-ресурсам — какие cluster-wide-ресурсы может использовать этот объект.

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

Что произойдёт при отключении модуля multitenancy-manager?

После отключения модуля проверка доступности cluster-wide-ресурсов и автоматическая подстановка значений по умолчанию не выполняются. Существующие объекты при этом не изменяются.

Проверка полей с расширением x-deckhouse-grantable-resource в настройках приложений Deckhouse Platform также не выполняется.

Роль d8:dict модуля user-authz продолжает работать.