Стадия жизненного цикла модуля: Preview
Управление доступом к 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, но ничего не изменилось — почему?
Проверьте по порядку:
-
Соответствие селекторам. Убедитесь, что
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 для проекта»). -
Доступные ресурсы проекта. Проверьте, отражает ли AvailableClusterResource ожидаемые настройки политики:
d8 k get available <RESOURCE_NAME> -n <PROJECT_NAME> -o yaml -
Регистрация cluster-wide-ресурса. Убедитесь, что для значения
resourceNameсуществует соответствующий ресурс GrantableClusterResourceDefinition. -
Регистрация ссылки. Если ожидается проверка определённого поля, убедитесь, что оно зарегистрировано с помощью 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 продолжает работать.