Agentic NDR 容器应用接入的 RBAC 访问权限说明

更新时间:
复制 MD 格式

Agentic NDR 通过服务关联角色 AliyunServiceRoleForCloudFW 访问已授权的云资源。在容器应用接入过程中,Agentic NDR 还需要访问目标集群的 Kubernetes API Server,读取应用、Pod、节点及网卡关联信息。本文介绍所涉及的 Kubernetes RBAC 权限的用途、访问范围,以及如何调整或禁止访问。

授权方式

在 Agentic NDR 控制台接入集群并确认授权后,容器服务将依据预置的权限模板,自动创建并绑定所需的 Kubernetes 角色。您无需手动创建自定义角色,也无需为 Agentic NDR 授予集群管理员或只读管理员权限。

RAM 服务关联角色权限与 Kubernetes RBAC 权限属于不同授权层级:前者用于访问云服务接口,后者用于访问集群内的 Kubernetes 资源。本文仅说明 Kubernetes RBAC 权限,不涵盖  AliyunServiceRoleForCloudFW 的全部云资源访问权限。

权限范围及用途

Agentic NDR 使用自定义 ClusterRole cloudfw-aliyunserviceroleforcloudfw-clusterrole,对以下资源具有 list(列举)和 watch(监听变化)权限。

API 组

资源

用途

core(空字符串)

pods

读取 Pod 的地址、运行状态和所属关系,关联应用与网卡。

core(空字符串)

nodes

读取节点信息,关联底层实例及网卡。

apps

deployments、statefulsets、daemonsets、replicasets

识别应用及其与 Pod 的所属关系。

batch

jobs、cronjobs

识别任务类应用及其与 Pod 的所属关系。

network.alibabacloud.com

podenis

在使用 Terway PodENI 的集群中,读取 Pod 与弹性网卡(ENI)的关联信息。

上述权限覆盖集群级节点和全部命名空间中所列资源,不包含其他资源类型。以下为完整权限模板,仅用于展示权限内容,无需手动部署。

apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: cloudfw-aliyunserviceroleforcloudfw-clusterrole
rules:
  # Pod:读取及监听地址、状态和所属关系。
  - apiGroups: [""]
    resources: ["pods"]
    verbs: ["list", "watch"]
  # 节点:关联底层实例及网卡。
  - apiGroups: [""]
    resources: ["nodes"]
    verbs: ["list", "watch"]
  # 应用工作负载:识别应用与 Pod 的所属关系。
  - apiGroups: ["apps"]
    resources: ["deployments", "statefulsets", "daemonsets", "replicasets"]
    verbs: ["list", "watch"]
  # 批处理任务:识别任务类应用与 Pod 的所属关系。
  - apiGroups: ["batch"]
    resources: ["jobs", "cronjobs"]
    verbs: ["list", "watch"]
  # Terway PodENI:读取及监听 Pod 与弹性网卡的关联关系。
  - apiGroups: ["network.alibabacloud.com"]
    resources: ["podenis"]
    verbs: ["list", "watch"]

安全说明

  • 上述 RBAC 权限仅允许读取和监听,不包含创建、修改或删除应用、Pod、节点等资源的权限,也不包含集群管理操作。

  • 不授予读取 Secret、ConfigMap 对象或容器日志,以及进入容器执行命令的权限。

  • list 和 watch 可以返回对应资源对象的完整内容,并非仅返回资源名称。例如,Pod 和工作负载配置中直接填写的环境变量、启动参数、标签等也在可读取范围内。Secret 引用本身可能出现在对象中,但并不意味着能够读取对应的 Secret 对象。

  • 控制台对部分命名空间中的应用进行同步或展示过滤,不影响相应命名空间的 RBAC 访问权限。

说明

集群环境准备和应用信息同步并不意味着开启应用流量采集。集群接入完成后,仍需在应用列表中选择需要采集的应用。本文的只读权限说明不涉及应用流量采集的授权。

如何调整或禁止访问集群 API Server

方法一:修改目标集群的 ClusterRole

若仅希望调整或禁止对某个集群的上述访问,可以修改该集群中的授权角色。

  1. 登录容器服务管理控制台,在左侧导航栏选择集群列表,然后单击目标集群名称。

  2. 在左侧导航栏选择 安全管理 > 角色,打开 Cluster Role 页签。

  3. 搜索 cloudfw-aliyunserviceroleforcloudfw-clusterrole,在操作列单击 YAML 编辑。

  4. 在 metadata.annotations 中添加 inner.service.alibabacloud.com/user-customized: "true",保留已有的其他配置,并按需调整 rules:减少规则可缩小访问范围;设置为 rules: [] 可禁用本文模板授予的全部权限。该标记用于保留自定义权限配置,避免被服务模板自动覆盖。

禁用本文模板权限后的 YAML 示例:

apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: cloudfw-aliyunserviceroleforcloudfw-clusterrole
  annotations:
    inner.service.alibabacloud.com/user-customized: "true"
rules: []
重要

减少或清空权限会导致应用同步失败或应用与网卡的关联信息无法更新。Kubernetes 权限按角色绑定累加;若此前还通过 ACK 授权管理为该服务角色授予了其他 RBAC 权限,需要一并检查并撤销对应授权,才能禁止其通过其他授权路径继续访问。若云防火墙也使用此 ClusterRole,修改规则还会影响其依赖的集群同步功能。

如需恢复同步,可还原本页所列的只读规则,然后在 Agentic NDR 控制台按提示恢复集群接入。

方法二:删除服务关联角色

若不再使用任何依赖 AliyunServiceRoleForCloudFW 的功能,可以在满足删除条件后删除该服务关联角色。操作及限制请参见授权云防火墙访问云资源和服务关联角色。

重要

该角色也用于云防火墙。删除该角色会影响所有依赖它的功能;若仍有资源依赖,该角色将无法删除。仅需限制单个集群的访问时,请优先使用方法一。

停止访问与停止采集的区别

修改 RBAC 权限仅用于限制集群 API Server 的访问,不会自动停止已开启的应用流量采集,也不会自动释放接入资源。如需停止采集,请先在 Agentic NDR 控制台停止对应应用或集群的接入;请勿以删除权限代替停止接入。

常见问题

先前已为云防火墙授予“只读”权限,还需要改成“只读管理员”吗?

使用本文所述自动授权方式时,不需要。Agentic NDR 按本页权限模板配置所需的集群访问权限,不要求将原有授权提升为只读管理员。已有手动授权不会因本模板生效而自动撤销,可按需检查并收敛。

缩小命名空间或删除部分读取权限会有什么影响?

Agentic NDR 需要读取节点以及全部命名空间中所列资源,才能识别完整的应用与网卡关系。减少相应授权可能导致同步失败或关联信息不完整。仅在控制台隐藏某些应用,并不会缩小 RBAC 授权范围。