Доступно с ограничениями в редакциях: Open/CE
Доступно без ограничений в редакциях: Core, BE, SE, SE+, Ultimate/EE, Certified Core/CSE Lite (1.73), Certified Pro/CSE Pro (1.73)
Стадия жизненного цикла модуля: General Availability
Модуль отвечает за генерацию объектов ролевой модели доступа, основанной на базе стандартного механизма RBAC Kubernetes. Модуль создает набор кластерных ролей (ClusterRole), подходящий для большинства задач по управлению доступом пользователей и групп.
Биндинги, которые выдают пользователям уровни доступа из ClusterAuthorizationRule и AuthorizationRule, поддерживает компонент user-authz-controller: он следит за правилами, синхронизирует их ClusterRoleBinding и RoleBinding и записывает результат в status каждого правила (d8 k get clusterauthorizationrules показывает колонки READY и BINDINGS). Правило с неподдерживаемым accessLevel получает Ready=False с причиной InvalidSpec, а не ломает модуль. Контроллер отдаёт метрики: сколько правил он видит, какие биндинги для них нужны, какие есть на самом деле и где между этим расхождение, а модуль поставляет алерты о недоступности контроллера, устойчивом расхождении и правилах, биндинги которых не применяются (подробнее — в FAQ).
В модуле реализованы две ролевые модели: гранулярная (рекомендуется к использованию) и упрощённая, построенная на ресурсах ClusterAuthorizationRule и AuthorizationRule (поддержка будет прекращена в будущих релизах).
Модели не совместимы по ресурсам — автоматическая конвертация невозможна, — но могут использоваться одновременно: права из обеих моделей суммируются.
Гранулярная ролевая модель
В отличие от упрощённой ролевой модели Deckhouse Platform, гранулярная ролевая модель не использует ресурсы ClusterAuthorizationRule и AuthorizationRule. Права доступа настраиваются стандартным для RBAC Kubernetes способом: с помощью создания ресурсов RoleBinding или ClusterRoleBinding, с указанием в них одной из подготовленных модулем user-authz ролей. Для доступа сразу ко всем неймспейсам проекта дополнительно используются ресурсы ProjectRoleBinding и ClusterProjectRoleBinding модуля multitenancy-manager.
Выдавать доступ можно не только вручную через YAML-манифесты: в веб-интерфейсе Deckhouse есть мастер выдачи доступа. Он проводит по шагам (кому выдать доступ → где → с каким уровнем), сам выбирает правильный вид привязки (RoleBinding, ClusterRoleBinding, ProjectRoleBinding или ClusterProjectRoleBinding) и позволяет собрать собственную роль из готовых блоков без написания YAML.
Модуль создаёт специальные агрегированные кластерные роли (ClusterRole). Используя эти роли в RoleBinding или ClusterRoleBinding можно решать следующие задачи:
-
Управлять доступом к модулям определённой подсистемы применения.
Например, чтобы дать возможность пользователю, выполняющему функции сетевого администратора, настраивать сетевые модули (например,
cni-cilium,ingress-nginx,istioи т. д.), можно использовать в ClusterRoleBinding рольd8:subsystem:network:manager. -
Управлять доступом к пользовательским ресурсам модулей в рамках неймспейсов.
Например, использование роли
d8:namespace:managerв RoleBinding, позволит удалять/создавать/редактировать ресурс PodLoggingConfig в неймспейсе, но не даст доступа к cluster-wide-ресурсам ClusterLoggingConfig и ClusterLogDestination модуляlog-shipper, а также не даст возможность настраивать сам модульlog-shipper.
Области действия ролей
Каждая роль действует в одной из четырёх областей. Область определяет, где работают выданные права и каким ресурсом роль назначается:
| Область | Формат имени роли | Для кого | Каким ресурсом назначается |
|---|---|---|---|
| Неймспейс | d8:namespace:<уровень> |
Пользователи приложений (разработчики) | RoleBinding в конкретном неймспейсе. |
| Проект | d8:project:<уровень> |
Команды, работающие с проектами | ProjectRoleBinding или ClusterProjectRoleBinding — на весь проект, RoleBinding — на один неймспейс проекта. |
| Подсистема | d8:subsystem:<подсистема>:<уровень> |
Администраторы части платформы | ClusterRoleBinding. |
| Вся платформа | d8:system:<уровень> |
Администраторы платформы | ClusterRoleBinding. |
Роли, создаваемые модулем, делятся на следующие классы:
- Namespace-роли — для назначения прав пользователям (например, разработчикам приложений) в конкретном неймспейсе.
- Проектные роли — для назначения прав сразу во всех неймспейсах проекта.
- Системные и подсистемные роли — для назначения прав администраторам платформы и администраторам части платформы.
Уровни доступа
В каждой области действия для ролей предусмотрено несколько уровней доступа:
- Для областей «неймспейс» и «проект» уровней пять:
viewer→user→manager→admin→superadmin. - Для областей «подсистема» и «вся платформа» уровней три:
viewer→manager→superadmin. Уровнейuserиadminздесь нет: на системном уровне нет «пользовательских» ресурсов, которыми можно было бы пользоваться, не администрируя их.
Уровни доступа образуют иерархию с кумулятивным принципом: каждый последующий уровень наследует все права предыдущего и расширяет их. Например, уровень manager в области действия «неймспейс» включает набор прав уровня user, который, в свою очередь, включает набор прав уровня viewer.
Совместное использование ClusterAuthorizationRule, AuthorizationRule и RBAC
Если в кластере включён режим мультитенантности (параметр enableMultiTenancy: true), итоговые права пользователя представляют собой объединение прав, полученных из всех следующих источников:
- права из ClusterAuthorizationRule — применяются только внутри неймспейсов, разрешённых параметром
namespaceSelector(или устаревшим параметромlimitNamespaces); - права из AuthorizationRule — применяются внутри неймспейса, в котором создан ресурс AuthorizationRule;
- права из обычных RoleBinding — применяются внутри неймспейса, в котором создан ресурс RoleBinding;
- права из обычных ClusterRoleBinding, не созданных модулем
user-authz— применяются во всём кластере.
Ограничения по неймспейсам, заданные в ClusterAuthorizationRule, распространяются только на права, выданные этим ClusterAuthorizationRule. Они не отменяют права, выданные через RoleBinding, ClusterRoleBinding или AuthorizationRule в других неймспейсах. При этом права, предоставляемые ClusterAuthorizationRule, на эти неймспейсы не распространяются.
Ограничения по неймспейсам применяет вебхук авторизации, поэтому они не действуют на идентичности, которые вебхук не проверяет: компоненты control plane, kubelet и ServiceAccount’ы неймспейса kube-system и неймспейсов, имена которых начинаются с d8-. ClusterAuthorizationRule, в котором указан такой ServiceAccount (напрямую или через группу, например system:serviceaccounts), даёт его уровень доступа во всех неймспейсах. Создавайте ServiceAccount’ы внешних систем в обычных неймспейсах.
Например, если у пользователя есть ClusterAuthorizationRule с уровнем доступа accessLevel: Editor, ограниченный неймспейсом ns-a, а также RoleBinding с ролью view в неймспейсе ns-b, то он получит права уровня Editor в неймспейсе ns-a и права только на чтение в неймспейсе ns-b. Права, предоставленные через RoleBinding, не ограничиваются ClusterAuthorizationRule, а уровень доступа Editor, заданный ClusterAuthorizationRule, не распространяется на неймспейс ns-b.
Namespace-роли
Namespace-роль нельзя назначить через ClusterRoleBinding. Используйте RoleBinding в неймспейсе либо ProjectRoleBinding или ClusterProjectRoleBinding для всех неймспейсов проекта.
Namespace-роли предназначены для назначения прав пользователю в конкретном неймспейсе. Под пользователями понимаются, например, разработчики, которые используют настроенный администратором кластер для развёртывания своих приложений. Таким пользователям не нужно управлять модулями Deckhouse Platform или кластером, но им нужно иметь возможность, например, создавать свои Ingress-ресурсы, настраивать аутентификацию приложений и сбор логов с приложений.
Namespace-роль определяет права на доступ к namespaced-ресурсам модулей и стандартным namespaced-ресурсам Kubernetes (Pod, Deployment, Secret, ConfigMap и т. п.).
Модуль создаёт следующие namespace-роли:
d8:namespace:viewer— позволяет в конкретном неймспейсе просматривать стандартные ресурсы Kubernetes (кроме секретов и ресурсов RBAC), ресурсы Gateway API, журналы подов и метрики, а также выполнять аутентификацию в кластере;d8:namespace:user— дополнительно к ролиd8:namespace:viewerпозволяет в конкретном неймспейсе просматривать секреты, подключаться к подам (kubectl exec,kubectl attach), удалять поды (но не создавать или изменять их), выполнятьkubectl port-forwardиkubectl proxy, изменять количество реплик контроллеров;d8:namespace:manager— дополнительно к ролиd8:namespace:userпозволяет в конкретном неймспейсе управлять ресурсами модулей (например, Certificate, PodLoggingConfig и т. п.) и стандартными namespaced-ресурсами Kubernetes (Pod, Deployment, ConfigMap, Secret, Service, Ingress, NetworkPolicy, CronJob и т. п.), а также ресурсами Gateway API (Gateway, ListenerSet, HTTPRoute, GRPCRoute, ReferenceGrant и т. п.);d8:namespace:admin— дополнительно к ролиd8:namespace:managerпозволяет в конкретном неймспейсе управлять ресурсами ResourceQuota, LimitRange, ServiceAccount, Role, RoleBinding;d8:namespace:superadmin— дополнительно к ролиd8:namespace:adminпозволяет выполнять опасные с точки зрения безопасности операции: выпускать токены ServiceAccount’ов и выполнять запросы от их имени.
Подробное разделение прав между admin и superadmin описано в разделе «Ограничения уровня admin и права superadmin».
Автоматический доступ к справочным cluster-wide-ресурсам
Работа в неймспейсе требует чтения некоторых cluster-wide-«справочников»: например, чтобы указать в манифесте storageClassName или ingressClassName, нужно видеть список StorageClass’ов и IngressClass’ов. Поэтому каждый субъект, получивший RoleBinding на любую роль d8:namespace:* или d8:project:*, автоматически получает и доступ на чтение таких справочных ресурсов (StorageClass, IngressClass, PriorityClass, RuntimeClass, VolumeSnapshotClass, ClusterLogDestination и т. п.).
Технически это выглядит как автоматически создаваемый ClusterRoleBinding на роль d8:dict с лейблом rbac.deckhouse.io/dict: "true". Такие объекты управляются платформой: они появляются, когда субъект получает первый такой RoleBinding, и удаляются, когда у субъекта не остаётся ни одного, — редактировать их вручную не нужно.
Проектные роли
Проектную роль нельзя назначить через ClusterRoleBinding — попытка будет отклонена. Для назначения роли на весь проект используйте ProjectRoleBinding или ClusterProjectRoleBinding. Допускается также обычный RoleBinding в одном из неймспейсов проекта — тогда роль действует только в нём.
Проектные роли (d8:project:<уровень>) предназначены для работы с проектами — изолированными окружениями, которые могут включать несколько неймспейсов. Уровни те же, что у namespace-ролей: viewer, user, manager, admin, superadmin.
Каждая проектная роль включает все права namespace-роли того же уровня и дополнительно даёт права на управление самим проектом:
d8:project:viewer— праваd8:namespace:viewerплюс просмотр ресурсов ProjectNamespace и ProjectRoleBinding проекта;d8:project:user— праваd8:namespace:userплюс просмотр ресурсов ProjectNamespace и ProjectRoleBinding проекта;d8:project:manager— праваd8:namespace:managerплюс управление дополнительными неймспейсами проекта (ресурсы ProjectNamespace);d8:project:admin— праваd8:namespace:adminплюс управление доступом к проекту (ресурсы ProjectRoleBinding) и право привязывать встроенные ролиd8:project:*иd8:namespace:*(кроме уровняsuperadmin) другим пользователям в рамках проекта;d8:project:superadmin— аналогично соотношениюd8:namespace:superadminиd8:namespace:admin.
Назначенная через ProjectRoleBinding роль автоматически действует во всех неймспейсах проекта — как в основном, так и в дополнительных, включая созданные позже.
Системные и подсистемные роли
Системные и подсистемные роли не дают доступа к неймспейсу пользовательских приложений.
Они определяют доступ только к системным неймспейсам (начинающимся с d8- или kube-), и только к тем из них, в которых работают модули соответствующей подсистемы роли.
Можно ли с такой ролью раздавать доступ другим людям, описано в разделе «Кто может назначать роли».
Системные (d8:system:*) и подсистемные (d8:subsystem:*) роли предназначены для назначения прав на управление всей платформой или её частью (подсистемой), но не самими приложениями пользователей. С помощью подсистемной роли можно, например, дать возможность администратору безопасности управлять модулями, ответственными за функции безопасности кластера. Тогда администратор безопасности сможет настраивать политики безопасности, выпуск сертификатов и т. п., но не сможет управлять остальными функциями кластера (например, управлением доступом, настройками сети и мониторинга) и изменять настройки в неймспейсах приложений пользователей.
Системная/подсистемная роль ограничивает, к каким модулям и неймспейсам обращается субъект, но не ограничивает привилегии, которые он может получить через доступные ему модули. Это особенно важно учитывать для подсистемы iam, так как право управлять аутентификацией и авторизацией равносильно полному контролю над кластером.
Субъект, который может управлять модулем user-authn, способен зарегистрировать провайдер идентификации или сбросить учётные данные любого локального пользователя. Субъект, который может управлять модулем user-authz, способен изменить правила авторизации. В обоих случаях он может получить идентичность с любыми привилегиями, включая администратора кластера, поэтому при планировании доступа считайте роль подсистемы iam равной роли администратора кластера.
Системная/подсистемная роль определяет права на доступ:
- к cluster-wide-ресурсам Kubernetes;
- к управлению модулями Deckhouse Platform (ресурсы ModuleConfig) в рамках подсистемы роли, или всеми модулями Deckhouse Platform для роли
d8:system:*; - к управлению cluster-wide-ресурсами модулей Deckhouse Platform в рамках подсистемы роли или всеми ресурсами модулей Deckhouse Platform для роли
d8:system:*; - на чтение неймспейсов модулей подсистемы роли или всех модулей Deckhouse Platform для роли
d8:system:*; запись в них оставлена уровнюsuperadmin(см. Доступ системных и подсистемных ролей в неймспейсы модулей).
Формат названия системной роли — d8:system:<ACCESS_LEVEL>, подсистемной — d8:subsystem:<SUBSYSTEM>:<ACCESS_LEVEL>, где:
SUBSYSTEM— подсистема роли (список подсистем);-
ACCESS_LEVEL— уровень доступа.Примеры ролей:
d8:system:viewer— доступ на просмотр конфигурации всех модулей Deckhouse Platform (ресурсы ModuleConfig), их cluster-wide-ресурсов, их namespaced-ресурсов и стандартных объектов Kubernetes (кроме секретов и ресурсов RBAC) в неймспейсах всех модулей Deckhouse Platform;d8:system:manager— аналогично ролиd8:system:viewer, только с правом просмотра/создания/изменения/удаления конфигурации всех модулей Deckhouse Platform (ресурсы ModuleConfig) и их cluster-wide-ресурсов; в неймспейсах всех модулей Deckhouse Platform у неё остаётся доступ на чтение, как уd8:system:viewer;d8:subsystem:observability:viewer— доступ на просмотр конфигурации модулей Deckhouse Platform (ресурсы ModuleConfig) из подсистемыobservability, их cluster-wide-ресурсов, их namespaced-ресурсов и стандартных объектов Kubernetes (кроме секретов и ресурсов RBAC) в системных неймспейсахd8-log-shipper,d8-monitoring,d8-okmeter,d8-operator-prometheus,d8-upmeter,kube-prometheus-pushgateway.
Модуль предоставляет три уровня доступа для системных и подсистемных ролей:
viewer— позволяет просматривать стандартные ресурсы Kubernetes, конфигурацию модулей (ресурсы ModuleConfig), cluster-wide-ресурсы модулей и namespaced-ресурсы модулей в неймспейсе модуля;manager— дополнительно к уровнюviewerпозволяет управлять конфигурацией модулей (ресурсы ModuleConfig) и cluster-wide-ресурсами модулей; в неймспейсах модулей даёт тот же доступ на чтение, что иviewer;superadmin— дополнительно к уровнюmanagerпозволяет всё в неймспейсах модулей: управлять стандартными ресурсами Kubernetes и namespaced-ресурсами модулей, читать секреты, подключаться к подам, выпускать токены ServiceAccount и управлять системными ресурсами модулей подсистемы.
Доступ системных и подсистемных ролей в неймспейсы модулей
Обладатель системной или подсистемной роли автоматически получает RoleBinding на namespace-роль в каждом системном неймспейсе, где работают модули подсистемы роли (роль d8:system:* охватывает все системные неймспейсы): уровни viewer и manager получают d8:namespace:viewer, уровень superadmin — d8:namespace:superadmin. Платформа сама создаёт и удаляет эти RoleBinding (на них лейбл rbac.deckhouse.io/automated: "true"), по одному на каждый ClusterRoleBinding роли.
Неймспейсы модулей принадлежат платформе. В них живут ServiceAccount с правами на весь кластер (в том числе контроллер Deckhouse) и учётные данные модулей, поэтому любая запись туда и любое чтение Secret там — это по сути право действовать от имени этих ServiceAccount где угодно в кластере. Поэтому manager настраивает свою подсистему через объекты ModuleConfig и cluster-wide-ресурсы модулей, а в неймспейсах модулей только смотрит: объекты, логи, метрики и события, но не секреты; без kubectl exec, attach и port-forward, без удаления и масштабирования подов и без создания чего-либо. superadmin может всё это. Выдавайте этот уровень осознанно и именованному субъекту: это аварийный путь внутрь платформы, и его действия видны в журнале аудита. Не подменяйте его имперсонацией системных пользователей (--as).
Имейте в виду:
- RoleBinding на
d8:namespace:userили более высокий уровень в системном неймспейсе, созданный вручную, выдаёт субъекту права всех ServiceAccount этого неймспейса. То же относится к параметруallowAccessToSystemNamespaces: trueв ClusterAuthorizationRule прежней ролевой модели: с ним уровни доступаAdminиClusterAdminравны администратору кластера. - Системные неймспейсы — те, которые модуль multitenancy-manager никогда не превращает в проекты:
d8-*,kube-*,upmeter-*,defaultи неймспейсы с лейбломheritage: deckhouseилиheritage: upmeter. - Собственная системная или подсистемная роль (
d8:custom:*) проецируется какviewer, что бы ни стояло в её лейблеrbac.deckhouse.io/use-role: вебхук отклоняет большее значение, а роль, созданная с ним раньше, проецируется какviewerс событиемProjectionCappedна роли. - Авторам модулей: системная capability модуля (та, что агрегируется в роль
managerего подсистемы) не должна давать права записи на namespaced-объекты неймспейса модуля, из которых получаются рабочие нагрузки с ServiceAccount, токены или учётные записи (поды и контроллеры подов, Secret, ServiceAccount, Role и RoleBinding): такое право отдаётmanagerServiceAccount модуля. Линтерdmtбудет проверять это поrbac.yamlмодуля.
Кто может назначать роли
Системная или подсистемная роль сама по себе не даёт права раздавать доступ другим людям.
Создать User или Group, которых ещё нет среди субъектов грантов, можно как обычный объект.
Создать User на email, на котором грант уже есть, записать или удалить ClusterAuthorizationRule либо сбросить такую идентичность через UserOperation — это раздача ролей. Запрос пройдёт, только если у запрашивающего уже есть покрывающие права или ему явно разрешено назначать эти роли.
Подключение DexProvider проверяется так же, но относительно идентичностей, которые провайдер способен утвердить: spec.allowedIdentities (email, домены email, группы) и собственные фильтры групп провайдера ограничивают это множество, и учитываются только роли, уже выданные внутри него. Провайдер без ограничителя по email способен утвердить любой адрес, включая те, accessLevel у которых SuperAdmin, поэтому его запись требует SuperAdmin. Базовая аутентификация провайдера OIDC или Crowd идёт мимо Dex и его ограничителей, поэтому такой провайдер считается провайдером без ограничителя по email, а OIDC-провайдер — ещё и без ограничителя по группам; у Crowd-провайдера ось групп ограничивает только crowd.groups. Подробности и список изменений, проходящих без проверки, — в документации модуля user-authn.
У ClusterAuthorizationRule поле spec.accessLevel задаёт уровень упрощённой ролевой модели: User, PrivilegedUser, Editor, Admin, ClusterEditor, ClusterAdmin, SuperAdmin. Менеджер подсистемы iam и обладатель d8:system:manager назначают уровни, которые включает ClusterEditor: User, PrivilegedUser, Editor и ClusterEditor, но не Admin, ClusterAdmin и SuperAdmin, а также не могут назначить кластерную роль Kubernetes cluster-admin.
ClusterAuthorizationRule, которое открывает системные неймспейсы, считается назначением уровня ClusterAdmin, каким бы ни был его accessLevel, поэтому эти менеджеры не могут его записать: правило с allowAccessToSystemNamespaces: true, с namespaceSelector.matchAny, с namespaceSelector.labelSelector, который не называет свои неймспейсы лейблом kubernetes.io/metadata.name, правило для субъекта, которого туда уже пускает другое правило (правила субъекта складываются), или любое правило при выключенном режиме мультитенантности. Поэтому без режима мультитенантности, как в CE, эти менеджеры вообще не могут записывать ClusterAuthorizationRule.
Правила запроса складываются: правила его пользователя, каждой группы из его токена и его ServiceAccount. Поэтому правило открывает системные неймспейсы и тогда, когда другое правило уже пускает туда один из запросов, к которым оно применяется: локального пользователя, которого правило называет, или участника его групп на любой глубине вложенности — вместе с группами, в которых этот пользователь состоит, и группами над ними; самого запрашивающего — с группами его токена; любой запрос — через system:authenticated (ServiceAccount — ещё и через system:serviceaccounts и system:serviceaccounts:<неймспейс>).
Правило для system:authenticated применяется к любому запросу, поэтому открывает системные неймспейсы, как только их открывает любое другое правило. Правило для system:serviceaccounts открывает их, как только другое правило пускает туда какой-либо ServiceAccount, а правило для system:serviceaccounts:<неймспейс> — как только другое правило пускает туда ServiceAccount этого неймспейса. Субъект User с именем system:serviceaccount:<неймспейс>:<имя> — это тот же ServiceAccount.
Участник Group получает правила всех групп над ней, поэтому для записи Group нужен диапазон и для их ролей. По той же причине эти менеджеры не могут добавить в Group, у которой или у группы над которой есть ClusterAuthorizationRule, участника, которого другое правило уже пускает в системные неймспейсы. Группы, которые провайдер идентификации передаёт для других пользователей, вебхуку неизвестны и не учитываются.
По той же причине пользователь или группа, которых называет такое правило, считаются целью уровня ClusterAdmin: эти менеджеры не могут создать User на этот email, добавить участников в такую Group, выполнить UserOperation для такого пользователя или подключить DexProvider, который может утвердить такую идентичность. Выключение режима мультитенантности в ModuleConfig user-authz открывает системные неймспейсы всем правилам и тоже требует диапазона ClusterAdmin. В гранулярной модели менеджер IAM назначает роли подсистемы iam не выше d8:subsystem:iam:manager, а системный менеджер — роли любой области не выше уровня manager.
Эти менеджеры не записывают вебхуки и политики допуска (ValidatingWebhookConfiguration, MutatingWebhookConfiguration, ValidatingAdmissionPolicy и ValidatingAdmissionPolicyBinding): это делают суперадминистраторы подсистем security и cluster и d8:system:superadmin. Мутирующий вебхук может изменить любой объект, который создаёт платформа, включая её собственные поды, а удаление вебхука или политики отключает то, что они проверяют, в том числе ограничения выше. Объекты ValidatingWebhookConfiguration d8-deckhouse-validating-webhook-handler-*, в которых собраны вебхуки модулей Deckhouse, создают, изменяют и удаляют только webhook-handler, компоненты платформы и суперадминистраторы, в том числе обладатели роли со всеми глаголами на все ресурсы.
Запрашивающий, у которого есть все права во всём кластере, в этих проверках приравнивается к SuperAdmin и может назначить любую роль, в том числе SuperAdmin и cluster-admin. Например, такие права есть у субъекта кластерной роли Kubernetes cluster-admin, если роль выдана через ClusterRoleBinding или через ClusterAuthorizationRule без namespaceSelector и limitNamespaces. Если включён режим мультитенантности, такое правило даёт доступ к системным неймспейсам только с namespaceSelector.matchAny: true (или устаревшим allowAccessToSystemNamespaces: true).
Права из ClusterAuthorizationRule с namespaceSelector или limitNamespaces в эту проверку не входят, даже если правило выдаёт cluster-admin. Любой непустой limitNamespaces намеренно считается ограничением, даже если его записи подходят под все неймспейсы, например .* вместе с allowAccessToSystemNamespaces: true. По accessLevel такое правило учитывается как обычно. Например, accessLevel: SuperAdmin даёт диапазон SuperAdmin независимо от ограничений неймспейсов в правиле.
limitNamespaces и namespaceSelector ограничивают только доступ к ресурсам в неймспейсах. Субъект с уровнем доступа ClusterAdmin или SuperAdmin по-прежнему может создавать объекты ClusterRoleBinding и ClusterAuthorizationRule, поэтому эти поля не ограничивают то, что он может выдать на весь кластер. Выдавайте эти уровни только тем, кому можно иметь доступ ко всему кластеру. ClusterAuthorizationRule учитывается только через биндинги, которые для него создал user-authz-controller.
В тексте отказа вебхука уровни accessLevel называются basic, чтобы не путать их с уровнями гранулярных ролей (viewer / manager / superadmin).
Прав модуля user-authn на создание User или Group для этого недостаточно: они не дают ролей, уже выданных на этот email.
Глобальные справочники ресурсов
Помимо ролей и capability гранулярной модели, модуль создаёт специальную ClusterRole d8:dict. Она даёт
доступ для чтения кластерных «справочных» ресурсов, которые пользователям часто нужно просматривать
при создании объектов. Например, пользователю, создающему PersistentVolumeClaim, нужно видеть
доступные StorageClass, а создающему Ingress — IngressClass.
Роль даёт права get, list, watch на следующие ресурсы:
storageclasses(storage.k8s.io), а такжеcsidrivers,csinodes,volumeattachments;volumesnapshotclasses(snapshot.storage.k8s.io);ingressclasses(networking.k8s.io);priorityclasses(scheduling.k8s.io);runtimeclasses(node.k8s.io);virtualmachineclasses,clustervirtualimages(virtualization.deckhouse.io);clusterlogdestinations(deckhouse.io);customresourcedefinitions(apiextensions.k8s.io) — толькоget,list.
Автоматический биндинг
user-authz-controller поддерживает один ClusterRoleBinding на d8:dict для каждого субъекта, у которого есть один из следующих RoleBinding:
- RoleBinding на роль
d8:namespace:*илиd8:project:*, включая RoleBinding, которыеmultitenancy-managerсоздаёт из ProjectRoleBinding и ClusterProjectRoleBinding; - RoleBinding, который модуль создаёт для AuthorizationRule (уровни
User,PrivilegedUser,EditorиAdmin).
Пользователи system:multitenancy-manager:*, от имени которых действует multitenancy-manager, биндинг не получают. Поэтому пользователи проекта могут просматривать справочные ресурсы без какой-либо ручной настройки. Биндинг удаляется, когда у субъекта не остаётся ни одного такого RoleBinding. Создавать его вручную не нужно.
Роль d8:dict независима от механизма управления доступом к cluster-wide-ресурсам multitenancy-manager: она предоставляет права только на чтение справочных ресурсов для их обнаружения. Механизм контролирует, какие значения ресурсов проект может фактически использовать при создании объектов.
Подсистемы ролевой модели
Каждый модуль Deckhouse Platform принадлежит определённой подсистеме. Для каждой подсистемы существует набор ролей с разными уровнями доступа. Роли обновляются автоматически при включении или отключении модуля.
В платформе есть подсистемы iam, security, cluster, delivery, network, storage, observability и managed-services.
Например, для подсистемы network существуют следующие подсистемные роли, которые можно использовать в ClusterRoleBinding:
d8:subsystem:network:viewer;d8:subsystem:network:manager;d8:subsystem:network:superadmin.
Область действия роли зависит от того, к какой подсистеме она принадлежит:
- Область действия ролей
d8:system:*— неймспейсы всех включённых модулей Deckhouse Platform, то есть неймспейсы, указанные в лейблеrbac.deckhouse.io/namespaceих capabilities. - Область действия ролей подсистем — неймспейсы, в которых работают модули подсистемы (подробнее — в таблице состава подсистем), а также все cluster-wide объекты модулей подсистемы.
Таблица состава подсистем ролевой модели.
| Подсистема | Модули подсистемы | Неймспейсы, используемые модулями подсистемы |
|---|---|---|
| all | Все модули | Все неймспейсы |
| iam |
|
|
| security |
|
|
| cluster |
|
|
| delivery |
|
|
| network |
|
|
| storage |
|
|
| observability |
|
|
| managed-services |
|
|
Как устроены роли: агрегация и capabilities
Ни одна встроенная роль не содержит списка прав напрямую. Права описываются в отдельных небольших кластерных ролях — capabilities. Каждая capability отвечает за один вид действий (например, «просмотр логов», «управление квотами», «подключение к подам») и содержит конкретные RBAC-правила. Роль (d8:namespace:admin, d8:system:viewer и т. д.) — это пустая ClusterRole с правилом агрегации (aggregationRule): Kubernetes автоматически собирает в неё правила из всех capabilities с подходящими лейблами.
Принадлежность объектов к ролевой модели задаётся лейблами rbac.deckhouse.io/* — например, лейбл rbac.deckhouse.io/aggregate-to-namespace-as: admin включает capability в роль d8:namespace:admin (и, за счёт иерархии уровней, — во все уровни выше). Полный перечень лейблов и аннотаций — в «Справочнике лейблов и аннотаций ролей».
Такое устройство даёт два практических следствия:
- Модули Deckhouse Platform расширяют роли автоматически: при включении модуля его capabilities добавляются в соответствующие встроенные роли, при выключении — удаляются. Список прав роли всегда соответствует набору включённых модулей.
- Вы можете собирать собственные роли из готовых capabilities, не описывая RBAC-правила вручную. Как это сделать описано в FAQ.
Имена встроенных ролей и capabilities начинаются с префикса d8:. Префикс d8: зарезервирован: создать собственную ClusterRole с именем d8:* нельзя — исключение составляет только префикс d8:custom:*, выделенный для пользовательских ролей и capabilities. Лейблы rbac.deckhouse.io/kind: role и rbac.deckhouse.io/kind: capability также зарезервированы за встроенными объектами — для собственных используйте custom-role и custom-capability.
Справочник лейблов и аннотаций ролей
Лейблы, которые ролевая модель использует на объектах ClusterRole:
| Лейбл | Где встречается | Назначение |
|---|---|---|
rbac.deckhouse.io/kind |
Все объекты ролевой модели | Тип объекта: role или capability — встроенные (зарезервированы), custom-role или custom-capability — пользовательские. Объект без этого лейбла отклоняется, если на нём есть лейбл агрегации области платформы. |
rbac.deckhouse.io/scope |
Роли и capabilities | Область действия: namespace, project, subsystem, system. |
rbac.deckhouse.io/subsystem |
Подсистемные объекты | Имя подсистемы (например, network) — только при scope: subsystem. |
rbac.deckhouse.io/aggregate-to-<область>-as: <уровень> |
Capabilities и роли младших уровней | Правило агрегации: включает объект в роль указанной области и уровня. <область> — system, namespace, project или имя подсистемы; <уровень> — viewer, user, manager, admin, superadmin. Именно эти лейблы указываются в селекторах aggregationRule. |
rbac.deckhouse.io/capability |
Capabilities | Глобально уникальное имя capability (например, namespace-capability.kubernetes.view_logs) — по нему capability адресно включается в собственную роль. |
rbac.deckhouse.io/use-role: <уровень> |
Системные и подсистемные роли | Какой уровень namespace-роли автоматически выдаётся обладателю этой роли в системных неймспейсах её подсистемы. У встроенных ролей: viewer → viewer, manager → viewer, superadmin → superadmin; роль, не встроенная в платформу, получает не выше viewer. Выдача выполняется автоматически создаваемыми RoleBinding (лейбл rbac.deckhouse.io/automated: "true"). |
rbac.deckhouse.io/namespace: <неймспейс> |
Capabilities | Неймспейс модуля, в котором обладателям системной/подсистемной роли автоматически создаётся RoleBinding. Читается только на capabilities, которые поставляет Deckhouse; на собственной capability игнорируется (как дать доступ к другому неймспейсу). |
rbac.deckhouse.io/delegatable: "true" |
Роли d8:namespace:*, d8:project:* и пользовательские |
Роль можно указывать в RoleBinding внутри неймспейсов проектов. Добавляйте лейбл на собственные роли, которые должны быть доступны в проектах. |
rbac.deckhouse.io/deprecated: "true" |
Устаревшие роли-псевдонимы | Роль устарела и будет удалена; переведите биндинги на новую роль. |
module |
Встроенные объекты | Имя модуля Deckhouse Platform, которому принадлежит объект. Удобен для выборки в селекторах агрегации (например, все capabilities одного модуля). |
heritage: deckhouse |
Встроенные объекты | Признак объекта платформы. Устанавливать на собственные объекты нельзя. |
Аннотации на объектах ClusterRole:
| Аннотация | Кто добавляет | Назначение |
|---|---|---|
ru.meta.deckhouse.io/title, ru.meta.deckhouse.io/description |
Платформа | Отображаемые название и описание на русском. |
en.meta.deckhouse.io/title, en.meta.deckhouse.io/description |
Платформа | Отображаемые название и описание на английском. |
custom.meta.deckhouse.io/title, custom.meta.deckhouse.io/description |
Администратор | Переопределение отображаемого названия/описания; единственное разрешённое изменение встроенных ролей. |
rbac.deckhouse.io/bindable-only-via |
Платформа | Виды биндингов, для которых предназначена роль (у проектных ролей — ProjectRoleBinding,ClusterProjectRoleBinding). Носит справочный характер: платформа его не проверяет. |
rbac.deckhouse.io/disabled-for-direct-use-in-projects: "true" |
Администратор | Запрещает выдавать роль в проектах: существующие биндинги продолжают работать, новые не создаются (подробнее). |
rbac.deckhouse.io/deprecated-replaced-by |
Платформа | На устаревших ролях-псевдонимах: имя роли, на которую нужно перейти. |
Ограничения уровня admin и права superadmin
В ролевой модели предусмотрено два уровня администрирования:
admin— повседневный администратор. Управляет ресурсами, квотами и доступом в своей области, но не может выполнять операции, которые позволяют выйти за её пределы или нарушить работу компонентов платформы.superadmin— «аварийный» администратор. Обладает всеми правамиadminи дополнительно может выполнять опасные операции. Выдавайте этот уровень осознанно и только тем, кому он действительно необходим.
Только уровень superadmin позволяет выпускать токены ServiceAccount’ов (kubectl create token) и выполнять запросы от имени ServiceAccount (kubectl --as system:serviceaccount:...). Токен ServiceAccount’а — это готовая учётная запись: завладев токеном служебного аккаунта платформенного компонента, можно получить его права далеко за пределами неймспейса. Поэтому admin управляет самими объектами ServiceAccount (создание, удаление), но не может выпускать для них токены и действовать от их имени.
Для superadmin также есть некоторые ограничения:
- Объекты с лейблом
heritage: deckhouseпринадлежат платформе: создавать, изменять и удалять их не может никто, включаяsuperadminи администраторов кластера. Некоторые компоненты платформы размещают такие объекты в пользовательских неймспейсах, например поды DexAuthenticator.kubectl exec,kubectl attach,kubectl port-forwardиkubectl debugв такие поды, а такжеkubectl scaleдля таких Deployment, StatefulSet, ReplicaSet и ReplicationController тоже запрещены.kubectl rollout restartдля таких объектов разрешён. Пользователи, на которых эти проверки не действуют, перечислены в FAQ модуляdeckhouse. - Ресурсы, созданные из шаблона проекта (лейбл
heritage: multitenancy-manager), не может изменить никто, включаяsuperadminи администратора кластера, — они управляются исключительно контроллером проектов. Чтобы изменить такой ресурс, измените шаблон проекта или сам проект. - Роль назначается через RoleBinding и действует только в том неймспейсе, где выдана:
superadminодного неймспейса не получает никаких особых прав в другом.
Встроенные механизмы защиты ролевой модели
Ролевая модель защищена набором проверок на уровне API-сервера. Они не требуют настройки и предотвращают типовые ошибки и попытки повышения привилегий:
- Нельзя выдать ограниченную по области роль на весь кластер. ClusterRoleBinding на роли
d8:namespace:*,d8:project:*(и ихd8:custom:*-варианты) отклоняется — иначе роль, рассчитанная на один неймспейс или проект, действовала бы во всех неймспейсах сразу. Используйте RoleBinding в нужном неймспейсе либо ProjectRoleBinding/ClusterProjectRoleBinding для проекта. ClusterRoleBinding допустим только для системных и подсистемных ролей, так как они кластерные. - Нельзя выдать capability на весь кластер. ClusterRoleBinding на любую capability (
d8:*-capability:*, включая пользовательские) отклоняется: capability — «строительный блок» для ролей, а не самостоятельная роль. В отдельном неймспейсе привязать capability через RoleBinding можно. - Нельзя получить управление проектами через собственную роль. Создание Role или ClusterRole, дающей права на изменение ресурсов управления проектами (
projects,projecttemplates,projectrolebindings,clusterprojectrolebindings,projectnamespaces), отклоняется. Эти права дают только встроенные ролиd8:project:*. Без этой защиты администратор неймспейса мог бы создать роль с правом создавать ProjectRoleBinding и выдать себе доступ ко всему проекту. Роли только на чтение этих ресурсов разрешены. - Namespace- или проектная роль не может включать capabilities платформы. Собственная роль с
scope: namespace,scope: projectили без области не может выбирать capabilities систем и подсистем по лейблуrbac.deckhouse.io/capability, а также областьsystemили подсистемы по лейблуrbac.deckhouse.io/aggregate-to-<область>-as. Ни одна собственная роль не может совмещать capabilities областейnamespace/projectи областейsystem/subsystem— это исключает создание «супер-роли», объединяющей доступ к приложениям и к платформе. - Собственная capability содержит правила и не может иметь
aggregationRule. - Имя должно соответствовать области:
d8:custom:namespace:<имя>,d8:custom:project:<имя>,d8:custom:system:<имя>,d8:custom:<подсистема>:<имя>, а для capability —d8:custom:<область>-capability:<имя>. - Лейбл
rbac.deckhouse.io/aggregate-to-<область>-asобласти платформы может нести только собственная capability. - Лейбл
rbac.deckhouse.io/delegatable: "true"допускается только на роли, которая агрегирует только capabilities неймспейса и проекта. - Собственные роли не могут содержать прямых RBAC-правил — только агрегировать capabilities. Права описываются в отдельных пользовательских capabilities, что делает состав любой роли прозрачным. Подробнее — в FAQ.
Отображаемые названия ролей
Каждая встроенная роль и capability имеет локализованные название и описание в аннотациях:
ru.meta.deckhouse.io/title,ru.meta.deckhouse.io/description— на русском;en.meta.deckhouse.io/title,en.meta.deckhouse.io/description— на английском.
Эти аннотации использует, например, веб-интерфейс Deckhouse при отображении списка ролей.
Если стандартное название не подходит (например, вы хотите называть роли в терминах, принятых в компании), добавьте на роль аннотации custom.meta.deckhouse.io/title и custom.meta.deckhouse.io/description — интерфейс покажет их вместо стандартных. Пример:
d8 k annotate clusterrole d8:namespace:admin custom.meta.deckhouse.io/title='Администратор команды'
Это единственное разрешённое изменение встроенных ролей: изменение их правил, агрегации или лейблов отклоняется.
Устаревшие имена ролей
Прежние имена ролей гранулярной модели (d8:manage:<подсистема>:<уровень>, d8:manage:all:<уровень> и d8:use:role:<уровень>) устарели и будут удалены в следующем релизе. Для обратной совместимости они временно сохранены как роли-псевдонимы. Привязка к псевдониму агрегирует capabilities новой роли, кроме случаев, когда изменился список подсистем (подробнее ниже).
Права псевдонима не совпадают с правами до апгрейда. d8:use:role:admin больше не даёт выпуск токена ServiceAccount и impersonate, это перешло на уровень superadmin. Псевдонимы d8:manage:* не delegatable. Псевдонимы d8:use:role:* delegatable, поэтому RoleBinding на них в неймспейсе проекта продолжает работать, но новые ProjectRoleBinding и ClusterProjectRoleBinding на старые имена отклоняются.
ClusterRoleBinding на псевдоним d8:manage:* сохраняет RoleBinding, которые для него создал прошлый релиз в неймспейсах модулей старой подсистемы. У псевдонима уровня viewer они называются d8:use:viewer:binding:<имя ClusterRoleBinding> и ссылаются на d8:use:role:viewer, у псевдонима уровня manager это d8:use:user:binding:<имя ClusterRoleBinding> и d8:use:role:user. Они привязывают субъектов ClusterRoleBinding и поддерживаются, как и раньше.
Это неймспейсы модулей платформы, которые были в старой подсистеме, и capabilities модулей, которые ещё несут старые лейблы, rbac.deckhouse.io/kind: manage вместе с лейблом агрегации старой подсистемы. У d8:manage:all:<уровень> это также неймспейсы, до которых доходят роли подсистем модулей с собственной подсистемой на его уровне, например d8-virtualization. Поэтому привязка к псевдониму не получает RoleBinding в неймспейсе модуля, который перешёл в подсистему позже, и модуля с собственным циклом выпуска, который уже несёт новые лейблы. ClusterRole, созданная пользователем, не добавляет неймспейс, какие бы лейблы она ни несла.
RoleBinding, которые прошлый релиз создал для привязки, остаются, пока привязка ссылается на старое имя, даже в неймспейсе, который больше не входит в их число, например когда модуль с собственным циклом выпуска переходит на новые лейблы. ClusterRoleBinding, который удалили и создали заново под тем же именем, сохраняет их только в этих неймспейсах.
Когда вы пересоздаёте привязку на новое имя роли, эти RoleBinding заменяются на d8:namespace:<уровень>:binding:<имя ClusterRoleBinding> в неймспейсах модулей новой подсистемы, с namespace-ролью новой роли (admin у роли уровня manager).
RoleBinding, которые прошлый релиз создал для привязки к кастомной роли старой схемы с rbac.deckhouse.io/kind: manage, например custom:manage:mycustom:manager, при обновлении удаляются, потому что user-authz-controller поддерживает такие RoleBinding только для ролей Deckhouse. Они появляются снова как d8:namespace:<уровень>:binding:<имя ClusterRoleBinding>, когда роль пересоздана как роль d8:custom:* с лейблами rbac.deckhouse.io/scope: system или subsystem и rbac.deckhouse.io/use-role, а привязка ссылается на новую роль, но только в неймспейсах модулей, которые уже несут новые лейблы. Модуль, который ещё несёт старые лейблы, не получает такой RoleBinding, пока не перейдёт на новые.
До этого создайте в неймспейсе этого модуля для субъектов привязки RoleBinding на d8:namespace:<уровень> и на каждую ClusterRole этого модуля, которую называет алерт D8UserAuthzLegacyUseCapability. Ни одна из этих ролей не является псевдонимом, поэтому такие RoleBinding следующий релиз не держат, а вебхук, который проверяет RoleBinding в неймспейсах проектов, неймспейс модуля не проверяет. Удалите их, когда у модуля появятся новые лейблы и контроллер создаст там свою RoleBinding.
RoleBinding на d8:use:role:<уровень> тоже даёт эти права, но о ней сообщает алерт D8UserAuthzDeprecatedRBACv2RoleInUse, и она держит релиз, который удаляет псевдонимы.
Соответствие имён:
| Устаревшее имя | Новое имя |
|---|---|
d8:manage:all:<уровень> |
d8:system:<уровень> |
d8:manage:deckhouse:<уровень>, d8:manage:infrastructure:<уровень>, d8:manage:kubernetes:<уровень> |
d8:subsystem:cluster:<уровень>, которая даёт больше прав. Права на модули, перешедшие в другие подсистемы, дают роли этих подсистем |
d8:manage:networking:<уровень> |
d8:subsystem:network:<уровень>, которая даёт и права на keepalived |
d8:manage:security:<уровень> |
d8:subsystem:security:<уровень> вместе с d8:subsystem:iam:<уровень>, которая даёт права на user-authz и user-authn, а также другие права |
d8:manage:observability:<уровень> |
d8:subsystem:observability:<уровень> |
d8:manage:storage:<уровень> |
d8:subsystem:storage:<уровень>, которая даёт и права на local-path-provisioner |
d8:use:role:<уровень> |
d8:namespace:<уровень> |
d8:use:role:<уровень>:kubernetes |
d8:namespace:<уровень> (полная namespace-роль, не kubernetes-only) |
Вместе с именами ролей изменился список подсистем. deckhouse, infrastructure и kubernetes объединены в cluster, куда перешли и модули из других подсистем, networking переименована в network, а user-authz, user-authn и multitenancy-manager перешли в iam.
Поэтому псевдонимы ролей deckhouse, infrastructure и kubernetes не агрегируют всю подсистему cluster. Они выбирают capabilities модулей платформы, которые были в старой подсистеме, где бы эти модули ни находились теперь. d8:subsystem:cluster:<уровень> даёт больше прав, поэтому, пересоздавая такую привязку, проверьте, какие роли подсистем нужны её субъектам.
Псевдоним d8:manage:security:<уровень> сохраняет и права на user-authz и user-authn, которые теперь даёт d8:subsystem:iam:<уровень>. Эта роль даёт также права на multitenancy-manager и на уровне manager право назначать роли, которого d8:subsystem:security:<уровень> не даёт.
Поэтому привязку к d8:manage:security:<уровень> заменяют две привязки с теми же субъектами, к d8:subsystem:iam:<уровень> и к d8:subsystem:security:<уровень>. Аннотация rbac.deckhouse.io/deprecated-replaced-by псевдонима называет только вторую.
Псевдонимы networking и storage не включают keepalived и local-path-provisioner, которые перешли в network и storage из infrastructure, поэтому новые роли дают больше прав, чем эти псевдонимы.
Аннотация rbac.deckhouse.io/deprecated-replaced-by псевдонима называет основную замену, а описание псевдонима называет роли других подсистем, в которые перешли его модули. Эти роли охватывают подсистемы целиком. Чтобы выдать права только на некоторые модули, создайте собственную роль, которая выбирает их системные capabilities по лейблу rbac.deckhouse.io/capability, например system-capability.multitenancy-manager.view (см. Как расширить роль или создать новую?).
Псевдонимы ролей deckhouse, infrastructure, kubernetes и networking и d8:manage:all:<уровень> выбирают также лейблы этих старых подсистем, например rbac.deckhouse.io/aggregate-to-deckhouse-as. Их ещё могут нести модули с собственным циклом выпуска и кастомные capabilities. Ни одна роль новой модели эти лейблы не собирает, поэтому такие capabilities получают только обладатели старых имён, а алерт D8UserAuthzRetiredAggregationLabel называет их. Модуль с собственным циклом выпуска, который уже перешёл в новую подсистему, псевдоним его старой подсистемы больше не выбирает.
d8:manage:all:<уровень> выбирает также rbac.deckhouse.io/kind: manage вместе с rbac.deckhouse.io/aggregate-to-all-as на своём уровне, как и в прошлом релизе. Этот лейбл несут роли подсистем модулей с собственной подсистемой, например d8:manage:virtualization:<уровень>, пока модуль не перейдёт на новые лейблы.
Псевдонимы d8:use:role:<уровень> и d8:use:role:<уровень>:kubernetes выбирают также use-capabilities прошлого релиза, rbac.deckhouse.io/kind: use вместе с rbac.deckhouse.io/aggregate-to-kubernetes-as на уровне псевдонима или ниже. Их ещё могут нести модули с собственным циклом выпуска и кастомные capabilities, например capabilities модуля log-shipper для объектов PodLoggingConfig.
d8:use:role:<уровень> выбирает также rbac.deckhouse.io/kind: use вместе с rbac.deckhouse.io/aggregate-to-all-as на своём уровне, как и в прошлом релизе. Этот лейбл несут use-роли модулей с собственной подсистемой, например d8:use:role:<уровень>:virtualization.
d8:namespace:<уровень> их не выбирает, поэтому RoleBinding на старое имя сохраняет эти права, а RoleBinding на новое имя получает их, только когда модуль или capability несёт лейбл rbac.deckhouse.io/aggregate-to-namespace-as. Use-capabilities с лейблом rbac.deckhouse.io/aggregate-to-kubernetes-as и use-роли с лейблом rbac.deckhouse.io/aggregate-to-all-as называет алерт D8UserAuthzLegacyUseCapability.
Этот алерт называет также ClusterRole с лейблом rbac.deckhouse.io/kind: use и лейблом агрегации системной области, встроенной подсистемы либо deckhouse, infrastructure или networking. Такую ClusterRole не выбирает ни одна роль, поэтому её правила даёт только привязка к самой ClusterRole.
Вебхук rbacv2-cluster-roles.deckhouse.io не даёт пользователю создать такую ClusterRole, а оставшуюся от прошлого релиза позволяет изменить, только удалив из неё лейбл агрегации.
Пока модуль не перейдёт на новые лейблы, создайте для субъектов, которым нужны эти права, RoleBinding на ClusterRole, которую называет алерт D8UserAuthzLegacyUseCapability, например на d8:use:role:<уровень>:virtualization или на саму use-capability, в том неймспейсе, где у них есть RoleBinding на d8:namespace:<уровень>. Ни одна из этих ролей не является псевдонимом, поэтому такие RoleBinding следующий релиз не держат.
В неймспейсе проекта вебхук cluster-objects-grants-validator.multitenancy.deckhouse.io допускает такую RoleBinding, только если у ClusterRole есть лейбл rbac.deckhouse.io/delegatable: "true", а у use-capabilities прошлого релиза его нет.
Если вебхук её не допускает, оставьте RoleBinding на старом имени. Она сохраняет эти права, но держит релиз, который удаляет псевдонимы, поэтому обновите модуль до этого релиза и затем переведите RoleBinding на d8:namespace:<уровень>.
В пределах своих модулей привязка к старому имени получает их capabilities такими, какие они в этом релизе. Они отличаются от прошлого релиза, потому что модули добавили в них ресурсы. Например, capabilities multitenancy-manager включают объекты ProjectRoleBinding, ClusterProjectRoleBinding и ProjectNamespace, а менеджеры iam и security могут разбирать права любого субъекта.
Устаревшая роль d8:use:role:admin соответствует роли d8:namespace:admin и, как и она, больше не даёт права выпускать токены ServiceAccount’ов и выполнять запросы от имени ServiceAccount’ов — теперь для этого нужен уровень superadmin.
Пока в кластере остаются привязки к устаревшим именам, срабатывают алерты D8UserAuthzDeprecatedRBACv2RoleInUse (привязка к роли-псевдониму) и D8UserAuthzDeprecatedRBACv2CapabilityInUse (привязка к устаревшему имени, которого нет ни у одной ClusterRole, например к capability прошлого релиза, поэтому привязка не даёт прав). Релиз, который удаляет псевдонимы, несёт требование релиза deprecatedRBACv2BindingsCount: обновление остаётся в ожидании, а список привязок выводится в статусе DeckhouseRelease, пока каждая привязка к роли-псевдониму не пересоздана на новое имя роли. Привязка, которая не даёт прав, релиз не держит: удаление псевдонимов для неё ничего не меняет.
Ролью-псевдонимом здесь считается ClusterRole модуля user-authz с лейблом rbac.deckhouse.io/deprecated. Модуль с собственным циклом выпуска может ещё поставлять роли и capabilities прошлого релиза под устаревшими именами, например d8:manage:virtualization:<уровень>, d8:use:role:<уровень>:virtualization или d8:manage:permission:module:ingress-nginx:edit. Привязка к такой ClusterRole продолжает работать, не вызывает ни одного из этих алертов и релиз не держит.
Алерты и требование релиза не учитывают RoleBinding, которые user-authz-controller поддерживает для ClusterRoleBinding на псевдоним, потому что они следуют за ClusterRoleBinding.
Модуль, который переименовывает собственную роль, сохраняет старое имя тем же способом: ClusterRole с лейблом rbac.deckhouse.io/deprecated в templates/rbacv2-compat/ модуля, новое имя — в аннотации rbac.deckhouse.io/deprecated-replaced-by. Привязка к такому псевдониму вызывает алерт D8UserAuthzDeprecatedRBACv2ModuleRoleInUse с новым именем роли и релиз Deckhouse не держит: псевдоним удаляет сам модуль в своём релизе. Аннотация обязательна (псевдоним без неё игнорируется), а имя псевдонима может быть любым именем d8:, кроме семейств ролей самой платформы (d8:system:, d8:subsystem:, d8:namespace:, d8:project:, d8:custom:, d8:dict), зарезервированных префиксов d8:binding: и d8:prb: и прежних имён платформы d8:manage: и d8:use:.
Переведите существующие RoleBinding и ClusterRoleBinding на новые имена ролей.
Объект ClusterRoleBinding с именем user-authz:<правило>:additional-role:<роль> создаёт user-authz-controller по полю spec.additionalRoles правила ClusterAuthorizationRule <правило> и восстанавливает его после удаления. Поэтому меняйте не привязку, а имя роли в spec.additionalRoles этого правила.
Привязку, которую создаёт шаблон проекта, так же меняют в ProjectTemplate, потому что multitenancy-manager создаёт её снова по шаблону.
Найти привязки, использующие устаревшие имена, без RoleBinding, которые для них поддерживает user-authz-controller, можно с помощью команды:
d8 k get clusterrolebindings,rolebindings -A -o json \
| jq -r '.items[] | select(.roleRef.name | test("^d8:(manage|use):")) | select(.metadata.labels["rbac.deckhouse.io/automated"] != "true") | "\(.kind) \(.metadata.namespace // "-") \(.metadata.name) -> \(.roleRef.name)"'
Упрощённая ролевая модель
Особенности:
- Права доступа настраиваются кастомными ресурсами ClusterAuthorizationRule и AuthorizationRule (описание) поверх RBAC Kubernetes.
- Управление доступом к инструментам масштабирования (параметр
allowScaleресурса ClusterAuthorizationRule или AuthorizationRule). - Управление доступом к форвардингу портов (параметр
portForwardingресурса ClusterAuthorizationRule или AuthorizationRule). - Управление списком разрешённых неймспейсов в формате labelSelector (параметр
namespaceSelectorресурса ClusterAuthorizationRule). - Ограничение по неймспейсам (режим мультитенантности,
namespaceSelector,limitNamespaces) доступно в редакциях BE, SE, SE+, EE и CSE.
В модуле, кроме RBAC, можно использовать набор высокоуровневых ролей:
User— позволяет получать информацию обо всех объектах (включая доступ к журналам подов), но не позволяет заходить в контейнеры, читать секреты и выполнять port-forward;PrivilegedUser— то же самое, что иUser, но позволяет заходить в контейнеры, читать секреты, а также удалять поды (что обеспечивает возможность перезагрузки);Editor— то же самое, что иPrivilegedUser, но предоставляет возможность создавать, изменять и удалять все объекты, которые обычно нужны для прикладных задач;Admin— то же самое, что иEditor, но позволяет создавать и изменять поды, выпускать токены ServiceAccount’ов (serviceaccounts/token), управлять объектами Role, RoleBinding и AuthorizationRule и удалять служебные объекты (например, ReplicaSet, challenges и orders группыacme.cert-manager.io);ClusterEditor— то же самое, что иEditor, но позволяет управлять ограниченным набором cluster-wide-объектов для прикладных задач (DaemonSet, StorageClass, CustomResourceDefinition, GatewayClass и объекты, которые модули добавляют на этот уровень, например KeepalivedInstance). Роль для работы оператора кластера;ClusterAdmin— то же самое, что иClusterEditor+Admin, но позволяет управлять служебными cluster-wide-объектами (неймспейсы, квоты, NetworkPolicy, подресурсы узлов для proxy, ClusterAuthorizationRule, ClusterRole и ClusterRoleBinding). Роль для работы администратора кластера. Внимание.ClusterAdminможет создавать объекты ClusterAuthorizationRule с уровнем не вышеClusterAdminи объекты ClusterRoleBinding только на роли, права которых у него уже есть;SuperAdmin— разрешены любые действия с любыми объектами, при этом ограниченияnamespaceSelectorиlimitNamespacesпродолжат работать.
Режим мультитенантности ограничивает доступ только к ресурсам в неймспейсах. Субъекты с уровнем доступа ClusterAdmin или SuperAdmin по-прежнему могут создавать кластерные биндинги. Вебхук авторизации не проверяет компоненты control plane, kubelet и ServiceAccount’ы неймспейса kube-system и неймспейсов, имена которых начинаются с d8-, поэтому ограничения по неймспейсам к ним не применяются.
Если в ресурсе ClusterAuthorizationRule задан namespaceSelector, устаревшие параметры limitNamespaces и allowAccessToSystemNamespaces не учитываются.
В режиме мультитенантности, если вебхук авторизации станет недоступен, запросы будут запрещаться, а не разрешаться: вебхук стоит перед RBAC и настроен с failurePolicy: Deny, поэтому запрос, на который он не смог ответить, до RBAC не доходит. Исключение — идентичности, перечисленные в matchConditions ресурса AuthorizationConfiguration: компоненты control plane, kubernetes-api-proxy, kubelet, ServiceAccount’ы неймспейсов kube-system и d8-*, а также анонимные проверки работоспособности kube-apiserver (/livez, /readyz, /healthz) вебхук не проверяет, поэтому кластер продолжает работать, а Deckhouse может восстановить вебхук.
В режиме мультитенантности в Kubernetes 1.34 и новее API-сервер также проверяет через вебхук авторизации, не отозвал ли модуль user-authn ID-токен пользователя. Модуль отзывает токены при операциях UserOperation Lock, ResetPassword и Reset2FA, при операции Logout без поля logout и при удалении User. API-сервер запрещает запрос с отозванным токеном в течение нескольких секунд с сообщением user-authn: the credentials of this user were revoked; sign in again. Эта проверка не запрещает запросы, если вебхук недоступен или модуль user-authn выключен; тогда отозванный ID-токен действует до истечения срока. Проверка не действует для базовой аутентификации, токенов ServiceAccount, клиентских сертификатов и уже выполняющихся запросов, например watch или exec. Проверка не настраивается, если задан параметр apiserver.authz.webhookURL модуля control-plane-manager.
Список доступа для каждой роли модуля по умолчанию
Каждая следующая роль наследует права предыдущих ролей. В блоке роли показаны только права, которые она добавляет.
Список ниже включает:
- стандартные права упрощённой ролевой модели (права k8s);
- права, создаваемые встроенными модулями Deckhouse.
В нем отсутствуют права модулей из источника.
Модули из источника при включении в кластере создают права на предоставляемые ими ресурсы. При выключении модуля из источника созданные им права удаляются.
Для просмотра прав, созданных модулями из источника, используйте команду.
Сокращения для verbs:
- read -
get,list,watch - read-write -
get,list,watch,create,delete,deletecollection,patch,update - write -
create,delete,deletecollection,patch,update
Роль User:
get,list:
- registry.deckhouse.io/registryimages
read:
- acme.cert-manager.io/challenges
- acme.cert-manager.io/orders
- apiextensions.k8s.io/customresourcedefinitions
- apps/daemonsets
- apps/deployments
- apps/replicasets
- apps/statefulsets
- autoscaling.k8s.io/verticalpodautoscalercheckpoints
- autoscaling.k8s.io/verticalpodautoscalers
- autoscaling/horizontalpodautoscalers
- batch/cronjobs
- batch/jobs
- cert-manager.io/certificaterequests
- cert-manager.io/certificates
- cert-manager.io/clusterissuers
- cert-manager.io/issuers
- cilium.io/ciliumclusterwidenetworkpolicies
- cilium.io/ciliumnetworkpolicies
- config.gatekeeper.sh/configs
- configmaps
- connection.gatekeeper.sh/connections
- constraints.gatekeeper.sh/*
- deckhouse.io/applicationpackages
- deckhouse.io/applicationpackageversions
- deckhouse.io/applications
- deckhouse.io/awsinstanceclasses
- deckhouse.io/azureinstanceclasses
- deckhouse.io/baremetalimages
- deckhouse.io/baremetalinstanceclasses
- deckhouse.io/baremetalinstances
- deckhouse.io/baremetalipxefirmwares
- deckhouse.io/baremetalramdiskimages
- deckhouse.io/clusterprojectrolebindings
- deckhouse.io/deschedulers
- deckhouse.io/dexauthenticators
- deckhouse.io/dexclients
- deckhouse.io/dynamixinstanceclasses
- deckhouse.io/gcpinstanceclasses
- deckhouse.io/huaweicloudinstanceclasses
- deckhouse.io/hubblemonitoringconfigs
- deckhouse.io/instances
- deckhouse.io/keepalivedinstances
- deckhouse.io/localpathprovisioners
- deckhouse.io/nodeextensionrequests
- deckhouse.io/nodegroups
- deckhouse.io/nodeoperations
- deckhouse.io/openstackinstanceclasses
- deckhouse.io/operationpolicies
- deckhouse.io/projectnamespaces
- deckhouse.io/projectrolebindings
- deckhouse.io/projecttemplates
- deckhouse.io/registryoperations
- deckhouse.io/securitypolicies
- deckhouse.io/securitypolicyexceptions
- deckhouse.io/vcdaffinityrules
- deckhouse.io/vcdinstanceclasses
- deckhouse.io/vsphereinstanceclasses
- deckhouse.io/yandexinstanceclasses
- deckhouse.io/zvirtinstanceclasses
- discovery.k8s.io/endpointslices
- endpoints
- events
- events.k8s.io/events
- expansion.gatekeeper.sh/expansiontemplate
- extensions.istio.io/wasmplugins
- extensions/daemonsets
- extensions/deployments
- extensions/ingresses
- extensions/replicasets
- extensions/replicationcontrollers
- externaldata.gatekeeper.sh/providers
- gateway.networking.k8s.io/backendtlspolicies
- gateway.networking.k8s.io/gatewayclasses
- gateway.networking.k8s.io/gateways
- gateway.networking.k8s.io/grpcroutes
- gateway.networking.k8s.io/httproutes
- gateway.networking.k8s.io/listenersets
- gateway.networking.k8s.io/referencegrants
- gateway.networking.k8s.io/tcproutes
- gateway.networking.k8s.io/tlsroutes
- gateway.networking.k8s.io/udproutes
- infrastructure.cluster.x-k8s.io/dynamixclusters
- infrastructure.cluster.x-k8s.io/dynamixmachines
- infrastructure.cluster.x-k8s.io/dynamixmachinetemplates
- infrastructure.cluster.x-k8s.io/huaweicloudclusters
- infrastructure.cluster.x-k8s.io/huaweicloudmachines
- infrastructure.cluster.x-k8s.io/huaweicloudmachinetemplates
- infrastructure.cluster.x-k8s.io/vcdclusters
- infrastructure.cluster.x-k8s.io/vcdclustertemplates
- infrastructure.cluster.x-k8s.io/vcdmachines
- infrastructure.cluster.x-k8s.io/vcdmachinetemplates
- infrastructure.cluster.x-k8s.io/zvirtclusters
- infrastructure.cluster.x-k8s.io/zvirtmachines
- infrastructure.cluster.x-k8s.io/zvirtmachinetemplates
- ipam.metal3.io/ipaddresses
- ipam.metal3.io/ipclaims
- ipam.metal3.io/ippools
- ironic.metal3.io/ironics
- limitranges
- metal3.io/baremetalhosts
- metal3.io/bmceventsubscriptions
- metal3.io/dataimages
- metal3.io/firmwareschemas
- metal3.io/hardwaredata
- metal3.io/hostclaims
- metal3.io/hostdeploypolicies
- metal3.io/hostfirmwarecomponents
- metal3.io/hostfirmwaresettings
- metal3.io/hostupdatepolicies
- metal3.io/preprovisioningimages
- metrics.k8s.io/nodes
- metrics.k8s.io/pods
- multitenancy.deckhouse.io/availableclusterresources
- mutations.gatekeeper.sh/assign
- mutations.gatekeeper.sh/assignimage
- mutations.gatekeeper.sh/assignmetadata
- mutations.gatekeeper.sh/modifyset
- namespaces
- network.deckhouse.io/clusternetworkpeers
- network.deckhouse.io/egressgatewaypolicies
- network.deckhouse.io/egressgateways
- network.deckhouse.io/metalloadbalancerbgppeers
- network.deckhouse.io/metalloadbalancerclasses
- network.deckhouse.io/metalloadbalancerconfigurations
- network.deckhouse.io/metalloadbalancerpools
- network.deckhouse.io/networkpeerings
- network.deckhouse.io/servicewithhealthchecks
- network.deckhouse.io/waypointinstances
- networking.istio.io/destinationrules
- networking.istio.io/envoyfilters
- networking.istio.io/gateways
- networking.istio.io/serviceentries
- networking.istio.io/sidecars
- networking.istio.io/virtualservices
- networking.istio.io/workloadentries
- networking.istio.io/workloadgroups
- networking.k8s.io/ingresses
- networking.k8s.io/networkpolicies
- node-manager.deckhouse.io/fencingfailednodestates
- node-manager.deckhouse.io/fencingslaprofiles
- nodes
- persistentvolumeclaims
- persistentvolumes
- pods
- pods/log
- policy/poddisruptionbudgets
- rbac.authorization.k8s.io/rolebindings
- rbac.authorization.k8s.io/roles
- replicationcontrollers
- resourcequotas
- security.istio.io/authorizationpolicies
- security.istio.io/peerauthentications
- security.istio.io/requestauthentications
- serviceaccounts
- services
- status.gatekeeper.sh/configpodstatuses
- status.gatekeeper.sh/connectionpodstatuses
- status.gatekeeper.sh/constraintpodstatuses
- status.gatekeeper.sh/constrainttemplatepodstatuses
- status.gatekeeper.sh/expansiontemplatepodstatuses
- status.gatekeeper.sh/mutatorpodstatuses
- status.gatekeeper.sh/providerpodstatuses
- storage.k8s.io/storageclasses
- syncset.gatekeeper.sh/syncsets
- telemetry.istio.io/telemetries
- templates.gatekeeper.sh/constrainttemplates
Роль PrivilegedUser (включает все правила из роли User):
create:
- pods/eviction
create,get:
- pods/attach
- pods/exec
delete,deletecollection:
- pods
read:
- secrets
Роль Editor (включает все правила из роли User, PrivilegedUser):
get,patch:
- pods/resize
write:
- apps/deployments
- apps/statefulsets
- autoscaling.k8s.io/verticalpodautoscalers
- autoscaling/horizontalpodautoscalers
- batch/cronjobs
- batch/jobs
- cert-manager.io/certificates
- configmaps
- deckhouse.io/dexauthenticators
- deckhouse.io/dexclients
- discovery.k8s.io/endpointslices
- endpoints
- extensions/deployments
- extensions/ingresses
- gateway.networking.k8s.io/backendtlspolicies
- gateway.networking.k8s.io/gateways
- gateway.networking.k8s.io/grpcroutes
- gateway.networking.k8s.io/httproutes
- gateway.networking.k8s.io/listenersets
- gateway.networking.k8s.io/referencegrants
- gateway.networking.k8s.io/tcproutes
- gateway.networking.k8s.io/tlsroutes
- gateway.networking.k8s.io/udproutes
- network.deckhouse.io/servicewithhealthchecks
- network.deckhouse.io/waypointinstances
- networking.istio.io/destinationrules
- networking.istio.io/gateways
- networking.istio.io/serviceentries
- networking.istio.io/sidecars
- networking.istio.io/virtualservices
- networking.istio.io/workloadentries
- networking.istio.io/workloadgroups
- networking.k8s.io/ingresses
- networking.k8s.io/networkpolicies
- persistentvolumeclaims
- policy/poddisruptionbudgets
- secrets
- security.istio.io/authorizationpolicies
- security.istio.io/peerauthentications
- security.istio.io/requestauthentications
- serviceaccounts
- services
Роль Admin (включает все правила из роли User, PrivilegedUser, Editor):
create:
- serviceaccounts/token
create,patch,update:
- pods
delete,deletecollection:
- acme.cert-manager.io/challenges
- acme.cert-manager.io/orders
- apps/replicasets
- cert-manager.io/certificaterequests
- extensions/replicasets
read-write:
- deckhouse.io/authorizationrules
write:
- autoscaling.k8s.io/verticalpodautoscalercheckpoints
- cert-manager.io/issuers
- deckhouse.io/applications
- extensions.istio.io/wasmplugins
- rbac.authorization.k8s.io/rolebindings
- rbac.authorization.k8s.io/roles
- telemetry.istio.io/telemetries
Роль ClusterEditor (включает все правила из роли User, PrivilegedUser, Editor):
create,delete,patch:
- deckhouse.io/nodeoperations
delete,deletecollection:
- acme.cert-manager.io/challenges
- acme.cert-manager.io/orders
- cert-manager.io/certificaterequests
get,list:
- templates.internal.deckhouse.io/nodeconfigtemplates
patch,update:
- nodes
read:
- deckhouse.io/containerdintegritypolicies
- deckhouse.io/ingressistiocontrollers
- deckhouse.io/istiofederations
- deckhouse.io/istiomulticlusters
- multitenancy.deckhouse.io/grantableclusterresourcedefinitions
- multitenancy.deckhouse.io/grantableclusterresourcereferences
- rbac.authorization.k8s.io/clusterrolebindings
- rbac.authorization.k8s.io/clusterroles
- sailoperator.io/istiocnis
- sailoperator.io/istiorevisions
- sailoperator.io/istiorevisiontags
- sailoperator.io/istios
- sailoperator.io/ztunnels
read-write:
- deckhouse.io/nodegroupconfigurations
- deckhouse.io/staticinstances
- multitenancy.deckhouse.io/clusterresourcegrantpolicies
write:
- apiextensions.k8s.io/customresourcedefinitions
- apps/daemonsets
- autoscaling.k8s.io/verticalpodautoscalercheckpoints
- cert-manager.io/clusterissuers
- cert-manager.io/issuers
- deckhouse.io/applications
- deckhouse.io/hubblemonitoringconfigs
- deckhouse.io/instances
- deckhouse.io/keepalivedinstances
- deckhouse.io/nodeextensionrequests
- deckhouse.io/nodegroups
- extensions.istio.io/wasmplugins
- extensions/daemonsets
- gateway.networking.k8s.io/gatewayclasses
- network.deckhouse.io/egressgatewaypolicies
- network.deckhouse.io/egressgateways
- storage.k8s.io/storageclasses
- telemetry.istio.io/telemetries
Роль ClusterAdmin (включает все правила из роли User, PrivilegedUser, Editor, Admin, ClusterEditor):
create:
- authorization.deckhouse.io/bulksubjectaccessreviews
- authorization.deckhouse.io/roleaccessreports
- authorization.deckhouse.io/subjectaccessreports
- deckhouse.io/dexauthenticators/allow-access-to-kubernetes
- deckhouse.io/dexclients/allow-access-to-kubernetes
create,delete,patch,update:
- deckhouse.io/registryoperations
get,list,patch,update,watch:
- control-plane.deckhouse.io/controlplanenodes
patch,update:
- deckhouse.io/vcdaffinityrules
- infrastructure.cluster.x-k8s.io/dynamixclusters
- infrastructure.cluster.x-k8s.io/dynamixmachines
- infrastructure.cluster.x-k8s.io/dynamixmachinetemplates
- infrastructure.cluster.x-k8s.io/huaweicloudclusters
- infrastructure.cluster.x-k8s.io/huaweicloudmachines
- infrastructure.cluster.x-k8s.io/huaweicloudmachinetemplates
- infrastructure.cluster.x-k8s.io/vcdclusters
- infrastructure.cluster.x-k8s.io/vcdclustertemplates
- infrastructure.cluster.x-k8s.io/vcdmachines
- infrastructure.cluster.x-k8s.io/vcdmachinetemplates
- infrastructure.cluster.x-k8s.io/zvirtclusters
- infrastructure.cluster.x-k8s.io/zvirtmachines
- infrastructure.cluster.x-k8s.io/zvirtmachinetemplates
- node-manager.deckhouse.io/fencingfailednodestates
proxy:
- nodes
read:
- control-plane.deckhouse.io/controlplaneoperations
- deckhouse.io/effectivelicenses
- deckhouse.io/modulesettingsdefinitions
- deckhouse.io/nodestaticpodrequests
- deckhouse.io/projectquotastatuses
- deckhouse.io/registryconfigs
- deckhouse.io/registryconfigs/sensitive
- deckhouse.io/registrynodes
- deckhouse.io/registrystorages
- deckhouse.io/registryupstreams/sensitive
- nfd.k8s-sigs.io/nodefeaturegroups
- nfd.k8s-sigs.io/nodefeaturerules
- nfd.k8s-sigs.io/nodefeatures
read-write:
- deckhouse.io/clusterauthorizationrules
- deckhouse.io/clusterlicenses
- deckhouse.io/deckhousereleases
- deckhouse.io/dexproviderchecks
- deckhouse.io/dexproviders
- deckhouse.io/groups
- deckhouse.io/moduleconfigs
- deckhouse.io/modulepulloverrides
- deckhouse.io/modulereleases
- deckhouse.io/modules
- deckhouse.io/modulesources
- deckhouse.io/moduleupdatepolicies
- deckhouse.io/nodeusers
- deckhouse.io/packagerepositories
- deckhouse.io/packagerepositoryoperations
- deckhouse.io/registryupstreams
- deckhouse.io/sshcredentials
- deckhouse.io/tokenexchangeproviders
- deckhouse.io/useraccounts
- deckhouse.io/useroperations
- deckhouse.io/users
- nodes/configz
- nodes/healthz
- nodes/log
- nodes/metrics
- nodes/pods
- nodes/proxy
- nodes/stats
update:
- deckhouse.io/projects/quota
- namespaces/finalize
write:
- cilium.io/ciliumclusterwidenetworkpolicies
- cilium.io/ciliumnetworkpolicies
- config.gatekeeper.sh/configs
- connection.gatekeeper.sh/connections
- constraints.gatekeeper.sh/*
- deckhouse.io/applicationpackages
- deckhouse.io/applicationpackageversions
- deckhouse.io/awsinstanceclasses
- deckhouse.io/azureinstanceclasses
- deckhouse.io/baremetalimages
- deckhouse.io/baremetalinstanceclasses
- deckhouse.io/baremetalinstances
- deckhouse.io/baremetalipxefirmwares
- deckhouse.io/baremetalramdiskimages
- deckhouse.io/clusterprojectrolebindings
- deckhouse.io/containerdintegritypolicies
- deckhouse.io/deschedulers
- deckhouse.io/dynamixinstanceclasses
- deckhouse.io/gcpinstanceclasses
- deckhouse.io/huaweicloudinstanceclasses
- deckhouse.io/ingressistiocontrollers
- deckhouse.io/istiofederations
- deckhouse.io/istiomulticlusters
- deckhouse.io/localpathprovisioners
- deckhouse.io/openstackinstanceclasses
- deckhouse.io/operationpolicies
- deckhouse.io/projectnamespaces
- deckhouse.io/projectrolebindings
- deckhouse.io/projects
- deckhouse.io/projecttemplates
- deckhouse.io/securitypolicies
- deckhouse.io/securitypolicyexceptions
- deckhouse.io/vcdinstanceclasses
- deckhouse.io/vsphereinstanceclasses
- deckhouse.io/yandexinstanceclasses
- deckhouse.io/zvirtinstanceclasses
- expansion.gatekeeper.sh/expansiontemplate
- externaldata.gatekeeper.sh/providers
- limitranges
- mutations.gatekeeper.sh/assign
- mutations.gatekeeper.sh/assignimage
- mutations.gatekeeper.sh/assignmetadata
- mutations.gatekeeper.sh/modifyset
- namespaces
- network.deckhouse.io/metalloadbalancerbgppeers
- network.deckhouse.io/metalloadbalancerclasses
- network.deckhouse.io/metalloadbalancerconfigurations
- network.deckhouse.io/metalloadbalancerpools
- rbac.authorization.k8s.io/clusterrolebindings
- rbac.authorization.k8s.io/clusterroles
- resourcequotas
- sailoperator.io/istiocnis
- sailoperator.io/istiorevisions
- sailoperator.io/istiorevisiontags
- sailoperator.io/istios
- sailoperator.io/ztunnels
- status.gatekeeper.sh/configpodstatuses
- status.gatekeeper.sh/connectionpodstatuses
- status.gatekeeper.sh/constraintpodstatuses
- status.gatekeeper.sh/constrainttemplatepodstatuses
- status.gatekeeper.sh/expansiontemplatepodstatuses
- status.gatekeeper.sh/mutatorpodstatuses
- status.gatekeeper.sh/providerpodstatuses
- syncset.gatekeeper.sh/syncsets
- templates.gatekeeper.sh/constrainttemplates
Вы можете получить дополнительный список правил доступа для роли модуля из кластера (правила, добавленные администратором, и нестандартные правила других модулей Deckhouse):
D8_ROLE_NAME=Editor
d8 k get clusterrole -o jsonpath="{range .items[?(@.metadata.annotations.user-authz\.deckhouse\.io/access-level=='$D8_ROLE_NAME')]}{.rules}{'\n'}{end}" | jq -s add