本文档集中说明 EOELAB 各设施的权限等级、继承关系和安全边界,供权限设计、授权审查和故障排查使用。本地域接入与资源配置参见《EOELAB 运维手册》,用户操作参见《EOELAB 用户手册》。
Zitadel 提供统一身份认证。默认账户位于 FEDERATION Organization;有效用户账户即代表 EOELAB 成员身份。Project 用于组织应用和管理角色。
| 级别 | 用途 | 典型授权 |
|---|---|---|
| Project | 管理应用及其管理角色 | 本地域维护者按需获得 Org User Permission Editor,用于维护应用角色 |
| Organization | 管理自定义域名、Project 和独立用户体系 | 新增独立 Organization 时向负责人授予 Org Owner |
普通成员不通过 Project 角色分级。应用需要区分资源所有权或管理能力时,继续使用自身的安全边界:Incus 资源权限由 OpenFGA 决定,hs-console 网络管理权限由控制台角色与管理范围决定,RustFS 数据权限由 Policy 决定。
| 身份 | 默认授权 |
|---|---|
| 普通成员 | 有效 Zitadel 账户即获得成员身份 |
| 本地域维护者 | 普通成员身份;按实际职责增加对应应用或 Project 的管理权限 |
| 独立 Organization 负责人 | 对应 Organization 的 Org Owner |
维护者同时也是普通成员,但维护者身份本身不自动获得应用管理权限。所有管理权限均应与实际职责对应。
每位实际使用者使用自己的账户,资源权限按具体对象与实际职责配置。需要独立用户体系、自定义域名或应用管理范围时,可由相关负责人与管理团队沟通独立 Organization 的配置与负责人授权。
Zitadel Organization、Zitadel Project 和 Incus Project 是不同对象。建立独立 Organization 不会自动创建 Incus Project、共享 Bucket 或隔离网络,也不会改变现有应用的默认权限。Incus 继续通过 OpenFGA 的用户或组关系授权;RustFS 默认按个人 sub 限定 Bucket,多人共享资源须由维护者配置相应策略。
参与关系或职责变更时,回收不再需要的授权;仍参与其他项目的账户不应直接删除。服务凭证依附于个人身份时,应先完成业务交接和凭证替换。
hs-console 使用 Zitadel OIDC 确认身份,通过 Headscale 原生 API 管理节点、用户、PreAuth Key 和数据库模式 ACL。控制台角色、管理员范围和个人 Headscale 用户映射保存在独立 Cloudflare D1 中;Worker 在每次 API 请求中读取权限并检查操作,Headscale 管理 API Token 只保存在 Worker,不交付给浏览器。
| 权限 | 能力 | 限制 |
|---|---|---|
super_admin | 全局节点、Key、Headscale 用户和 ACL 管理;分配控制台角色、管理员范围和用户绑定 | 仅授予全局维护职责对应的人员 |
admin | 管理明确分配范围内的标签节点和 Key,以及自己的个人节点和无标签 Key | 不能管理其他人的个人资源、范围外标签资源、Headscale 用户、全局 ACL 或控制台权限 |
user | 查看节点和用户;管理自己的无标签个人节点与 Key | 不能自行授予标签或执行管理员操作 |
普通新用户默认分配 user;新部署且权限表为空时,首个成功登录的用户初始化为 super_admin。再次登录不重置已有角色和范围。提升为 admin 或 super_admin 必须与实际维护职责对应。Key 列表仅显示当前用户可以管理的项。
管理员范围由 super_admin 明确分配,例如范围 wdy 对应 tag:wdy。域 wdy、group:wdy、tag:wdy 名称对齐,但不自动继承权限:group 成员不会自动成为管理员,个人节点不会自动打标签,控制台不会生成或拆分 ACL。多标签资源要求全部标签均在管理员范围内,不能用一个匹配标签扩大管理权限。
节点标签变更同时检查变更前归属和变更后标签范围,不能通过给别人的个人节点或范围外节点添加自己的标签来接管资源。管理员可以把自己的个人节点转换为范围内标签节点。全份 ACL(包含 group 和 tagOwners)是全局策略,仅 super_admin 读取、校验和修改;读取、校验、保存分别调用 Headscale 原生 API。
个人资源通过可信 OIDC issuer/sub 与 Headscale providerId 精确匹配来绑定,不按邮箱或显示名认领。未匹配时可登录查看,个人操作须先完成绑定,由用户通过相同 OIDC 账户接入 Headscale 后重新登录,或由 super_admin 核对已有用户并绑定。
hs-console 角色与范围控制管理界面的操作能力,Headscale ACL 控制网络连接,两者不能互相替代。能够管理自己的用户设备,不等于能够为设备授予本地域或服务标签。
用户设备以个人身份接入;域内节点和服务端点使用经授权的标签身份。本地域是联邦实体,域内节点属于域内资源,不因获得标签而成为独立联邦实体。标签身份不作为个人设备所有权使用,必须另行记录网络管理归属和维护负责人。
| 标签 | 授权范围 |
|---|---|
tag:core | 纳入核心本地域网络管理的域内节点与服务端点 |
tag:volta | 纳入 volta 本地域网络管理的域内节点与服务端点 |
tag:services | 由管理团队分配给未纳入具体本地域网络管理的独立服务端点及其宿主节点 |
services 是由管理团队管理的服务归属组,不是 Headscale 内置或自动加入的默认组,也不是新的本地域;其中的宿主节点仍归属具体本地域,网络管理归属与资源归属可以不同。核心本地域具有公共服务属性,但普通成员不能因此自行绑定 core。
本地域标签授权由管理团队或获授权的对应域维护者通过 Headscale 策略中的标签所有者配置(tagOwners)控制。tag:services 仅由管理团队通过管理接口为具体机器或独立服务端点添加;其 tagOwners 不向普通成员开放,也不向普通成员发放可自行注册该标签节点的凭证。用户需要接入服务时,向管理团队提供端点及维护负责人信息,由管理团队完成标签分配并协调 ACL。个人账户、成员身份及节点注册均不会自动获得 tag:services。带标签的注册凭证按其可授予的标签和实际用途管理,不向无关使用者分发。
每个服务端点原则上只使用一个网络归属标签。归属不表示同域全互通、公共可访问或应用管理权限,ACL 必须显式允许所需路径。对单个服务的授权不能仅因同属一个域就扩大到整个域;具体原则参见《EOELAB 互联云架构规范》的“联邦网络 ACL”。
网络归属或维护职责变更时,同步核对标签、ACL 和注册凭证。迁移或下线服务时,停用旧端点并清理不再需要的授权。ACL 的现网迁移按架构规范分步完成,本节不表示相关策略已经部署。
RustFS 使用 OIDC 用户身份和 Service Account 提供对象存储访问。普通用户共享同一份 user Policy,通过 Zitadel sub 动态限定个人资源,不为每位用户单独创建 IAM User、Policy 或 Role。设施级公共 Bucket 使用稳定名称,并在同一 Policy 中显式授予只读权限。
对象存储热冷分层不改变用户权限。普通成员通过 oss 的 Console 管理资源,通过 S3 访问数据;oss-cold 的 S3 端点仅向 oss 服务和对象存储维护者开放,不作为用户入口。冷数据读取仍通过 oss 完成。
普通用户不得获得全局 s3:ListAllMyBuckets。Bucket 列表由 RustFS 根据用户对每个 Bucket 的 s3:ListBucket 或 s3:GetBucketLocation 权限过滤,只返回 <sub>、<sub>-* 和显式授权的公共 Bucket;否则会暴露其他用户的 Bucket 名称。
| 身份 | 能力 | 边界 |
|---|---|---|
| 系统管理员 | 管理 RustFS、IAM、所有 Bucket 和系统配置 | 仅限对象存储维护者 |
| OIDC 用户 | 管理自己的 Bucket、对象、S3 Tables;只读公共 Bucket;创建或更新自己的 Service Account | 个人管理仅限 <sub> 和 <sub>-* Bucket;公共 Bucket 仅限显式授权的读取操作 |
| Service Account | 通过 S3 执行非交互式访问 | 有效权限是父 OIDC 用户权限与自身附加策略的交集,不能突破父级边界 |
公共 Bucket 是设施级资源,不属于任何个人账户,也不使用 <sub>-* 命名。普通成员默认只读;写入、覆盖、删除、生命周期和 Bucket 配置权限由独立维护策略授予,不加入共享 user Policy。公共 Bucket 由管理员预先创建,因此有效成员首次登录时即使尚未创建个人 Bucket,也至少可以看到 dataset 和 iso,不会进入 Bucket 列表为空的首次使用状态。
| Bucket | 用途 | 普通成员权限 |
|---|---|---|
dataset | 联邦公共数据集 | s3:GetBucketLocation、s3:ListBucket、s3:GetObject |
iso | 联邦共享的 ISO 镜像和安装介质 | s3:GetBucketLocation、s3:ListBucket、s3:GetObject |
共享 user Policy 通过以下 Statement 提供公共读取能力:
{
"Sid": "ReadSharedBuckets",
"Effect": "Allow",
"Action": [
"s3:GetBucketLocation",
"s3:ListBucket",
"s3:GetObject"
],
"Resource": [
"arn:aws:s3:::dataset",
"arn:aws:s3:::dataset/*",
"arn:aws:s3:::iso",
"arn:aws:s3:::iso/*"
]
}
公共 Bucket 的上传服务和维护者使用单独 Policy,并限制到所负责的 Bucket 或对象前缀。Service Account 的父 OIDC 用户也必须具备对应权限,否则附加策略不能扩大其有效权限。
普通成员访问公共 Bucket 时使用自己创建的 Access Key,不申请或共用公共长期凭证。非交互式自动化需要独立生命周期时,创建专用 Service Account,并按实际访问的 Bucket 或对象前缀限制权限。父 OIDC 用户必须已拥有对应权限。
自动化凭证应记录用途、负责人和有效期,并按使用范围交付。个人凭证和管理凭证不得写入公告、仓库或共享文档。
共享 user Policy 不授予以下全局 IAM 管理权限:
admin:CreateUser
admin:CreatePolicy
admin:AttachUserOrGroupPolicy
admin:ListServiceAccounts
admin:RemoveServiceAccount
admin:*
s3:ListAllMyBuckets
Service Account 的 Access Key 和 Secret Key 是独立长期凭证。
fga-console 使用 Zitadel OIDC 确认用户身份,控制台角色和可写实例分配保存在 Cloudflare D1。Worker 对每次 API 请求读取当前权限并执行检查,OpenFGA 实例 Token 不交付给浏览器。
| 角色 | 浏览与诊断 | 写入实例 | 用户权限管理 |
|---|---|---|---|
viewer | 所有已配置实例 | 不允许 | 不允许 |
admin | 所有已配置实例 | 仅被分配的实例 | 不允许 |
super_admin | 所有已配置实例 | 所有实例 | 允许 |
新部署且权限表为空时,第一个成功登录的用户初始化为 super_admin;后续新用户默认 viewer,由 super_admin 按实际维护职责调整角色和实例分配。再次登录不重置已有授权。浏览器缓存的角色展示不作为授权依据。
控制台角色只决定能否通过 fga-console 管理 OpenFGA,不自动授予 Incus、RustFS 或其他业务资源权限。页面中的“控制台写权限”也不表示上游实例 Token 当前有效。业务资源访问仍由对应服务执行认证和资源授权;模型、Tuple 和 Assertions 由 OpenFGA 实例保存,不存入 D1。
Incus 使用 OpenFGA 实现基于关系的访问控制(ReBAC)。Incus 接入 EOELAB 统一认证与授权的配置参见《EOELAB 运维手册》。
Incus 使用 OpenFGA 实现基于关系的访问控制(ReBAC)。它不是传统的“角色对应固定菜单”,而是由 Incus 针对每次 API 请求检查:
用户或组 + entitlement + Incus 对象 = 是否允许
例如,为 user:alice 建立 project:dev 的 operator 关系后,Alice 会通过继承获得 dev 项目内资源的操作权限。Incus 实际检查的是 can_view、can_edit、can_exec 等 entitlement,admin、operator、user、viewer 是 entitlement 的权限包。
关系元组使用 OpenFGA 的 user / relation / object 三元组:
| user | relation | object | 含义 |
|---|---|---|---|
user:alice | operator | project:dev | Alice 是 dev 项目的操作员 |
group:ops#member | operator | project:dev | ops 组成员是 dev 项目的操作员 |
user:alice | can_exec | instance:dev/web01 | Alice 只能获得 web01 的命令执行能力 |
关系元组的增删和查询在 fga-console 中完成。
所有对象均使用 <类型>:<标识符> 格式。项目级对象的标识符以项目名开头,不是单独的 project/instance_name 参数。
| 对象 | 格式示例 |
|---|---|
| Server | server:incus |
| Project | project:dev |
| Certificate | certificate:<完整指纹> |
| Storage Pool | storage_pool:local |
| Network Integration | network_integration:ovn |
| Instance | instance:dev/web01 |
| Image | image:dev/<完整指纹> |
| Image Alias | image_alias:dev/debian |
| Network | network:dev/br0 |
| Network ACL | network_acl:dev/web |
| Network Address Set | network_address_set:dev/internal |
| Network Zone | network_zone:dev/example.net |
| Profile | profile:dev/default |
| Storage Bucket | storage_bucket:dev/local/archive[/location] |
| Storage Volume | storage_volume:dev/local/custom/data[/location] |
server、project 和 shared_with 是 Incus 维护资源归属关系时使用的结构关系,不应作为普通用户权限手动修改。
can_create_* 不保证创建后还能查看或管理资源。can_edit 通常包含修改、重命名和删除,不是无破坏性的“编辑配置”。can_exec、can_update_state 等专项 entitlement 不会自动获得 can_view。CLI 可能会先查询对象,因此最小权限通常还要搭配 viewer。[user, group#member] 的 relation 可以直接授予用户或组;只有 operator、viewer from project 等计算表达式的 relation 只能通过角色或继承获得。模型表达式示例:
define can_edit: [user, group#member] or operator from project
表示可以把 can_edit 直接授予用户或组,也可以由资源所属 Project 的 operator 自动获得。
Incus 初始化模型时会加入:
server:incus#authenticated@user:*
所以每个已经通过认证的用户即使没有任何业务角色,仍然拥有:
can_view:基本服务器信息和只读集群信息can_view_metrics:进入 metrics 接口,实例指标仍按 Instance can_view 过滤can_view_resources:宿主机 CPU、内存、磁盘和网络资源信息can_view:可以看到存储池,但敏感配置在没有 can_edit 时会被隐藏因此“没有分配角色”不等于完全没有可见信息。
三个作用域中的角色均按以下顺序包含右侧角色:
admin -> operator -> user -> viewer
Server 的同名角色会传递给所有 Project,Project 的同名角色会传递给其所有 Instance。
| 作用域 | 角色 | 实际能力 |
|---|---|---|
| Server | viewer | 查看所有项目及其资源、证书、网络集成和完整 Server config |
| Server | user | viewer + 所有项目的 user,可进入所有实例并访问其数据面 |
| Server | operator | user + 所有项目的 operator,可创建、修改、删除所有项目资源 |
| Server | admin | 完整服务器和集群管理、全局资源创建,并成为所有项目的 admin |
| Project | viewer | 查看该项目及其所有资源 |
| Project | user | viewer + 查看项目 events/operations + 项目内所有实例的 user |
| Project | operator | user + 创建、修改、删除项目资源 + 项目内所有实例的 operator |
| Project | admin | operator + 修改、重命名、删除项目本身及其限制配置 |
| Instance | viewer | 查看一个实例的配置、状态、日志、快照和备份信息 |
| Instance | user | viewer + console、exec、文件、SFTP、NBD 和 TCP 转发 |
| Instance | operator | user + 编辑、删除、启停、重建以及管理快照和备份 |
| Instance | admin | 当前模型中实际能力与 operator 相同,没有额外 entitlement |
需要特别注意:
user 可以进入项目内全部实例并执行命令,但不能启停实例。user 不是低权限只读用户,通常能以实例内部 root 身份执行命令、读写文件或访问磁盘。viewer 不只是查看 Server,它还会得到所有项目的只读权限和完整 Server config。operator 不能修改 Server 本身,但可以操作所有项目中的资源。| Entitlement | 允许的操作 |
|---|---|
can_view | 查看基本服务器信息、集群状态、成员和集群组 |
can_view_sensitive | 查看完整 Server config |
can_view_resources | 查看宿主机资源、Storage Pool resources 和非托管网卡 |
can_view_metrics | 访问 metrics;返回的实例指标继续按 Instance can_view 过滤 |
can_view_privileged_events | 查看 logging 类型的特权事件 |
can_edit | 修改服务器配置,管理集群、成员、集群组、warnings 和内部管理接口 |
can_create_certificates | 添加信任证书 |
can_create_projects | 创建 Project |
can_create_storage_pools | 创建 Storage Pool |
can_create_network_integrations | 创建 Network Integration |
can_override_cluster_target_restriction | Project 禁止指定 Cluster target 时仍允许指定成员 |
| Entitlement | 允许的操作 |
|---|---|
can_view | 查看 Project 和 Project state |
can_edit | 修改限制和配置、重命名、删除 Project,以及查看 Project access |
can_create_instances | 创建实例、复制到该项目、从备份导入实例 |
can_create_images | 导入镜像或从实例发布镜像 |
can_create_image_aliases | 创建 Image Alias |
can_create_profiles | 创建 Profile |
can_create_networks | 创建 Network |
can_create_network_acls | 创建 Network ACL |
can_create_network_address_sets | 创建 Network Address Set |
can_create_network_zones | 创建 Network Zone |
can_create_storage_volumes | 创建、复制或导入 Storage Volume |
can_create_storage_buckets | 创建 Storage Bucket |
can_view_events | 查看该项目的 operation、lifecycle 和 network-acl events;不包含 logging |
can_view_operations | 列出该项目的异步 operations |
| Entitlement | 允许的操作 |
|---|---|
can_view | list/show/info/state,读取日志、metadata、NVRAM、快照和备份信息 |
can_edit | 修改配置、rename/move/migrate/delete、rebuild、恢复快照、修改 metadata/NVRAM |
can_update_state | start、stop、restart、freeze、unfreeze |
can_access_console | 连接 Instance console;读取 console log 只需要 can_view |
can_exec | 在实例中执行命令,并访问 exec output |
can_access_files | pull、push、删除实例文件 |
can_connect_tcp | 使用 incus port-forward 连接实例端口 |
can_connect_nbd | 通过 NBD 访问实例磁盘 |
can_connect_sftp | 通过 SFTP 访问实例文件系统 |
can_manage_snapshots | 创建、修改、重命名和删除快照;恢复快照仍需要 can_edit |
can_manage_backups | 创建、重命名、删除和导出实例备份 |
只希望用户在单个实例内执行命令时,建议授予该 Instance 的 viewer 和 can_exec,不要使用会额外开放 console、文件、NBD、SFTP、TCP 的 user。
| 对象 | can_view | can_edit 或专项权限 |
|---|---|---|
| Certificate | 查看证书信息;只能由 Server viewer 继承 | 修改、替换、删除证书 |
| Image | 查看和下载/导出镜像;Public Image 不受 OpenFGA 限制 | 修改、删除、refresh、生成 secret |
| Image Alias | 查看 Alias | 修改、重命名、删除 |
| Profile | 查看配置和设备 | 修改、重命名、删除 |
| Network | 查看状态、leases、forward、load balancer 和 peer;主 Network config 会被隐藏 | 修改、重命名、删除 Network,并管理其 forward、load balancer 和 peer |
| Network ACL | 查看 ACL 规则 | 修改、重命名、删除 |
| Network Address Set | 查看地址 | 修改、重命名、删除 |
| Network Zone | 查看 Zone 和 records | 修改 Zone,并管理 records |
| Network Integration | 查看信息;只能由 Server viewer 继承,config 会被隐藏 | 修改、重命名、删除 |
| Storage Pool | 所有已认证用户均可查看,config/source 会被隐藏 | 修改和删除;不能限定只查看某个 Pool |
| Storage Volume | 查看状态、bitmap、快照和备份,并可导出 Volume backup | 修改、移动、重命名、删除、重建、恢复快照和修改 bitmap |
| Storage Bucket | 查看 Bucket、备份和 key;读取 key 时会返回 access key 和 secret key | 修改 Bucket,并创建、修改、删除 key |
Storage Volume 还定义了以下专项 entitlement:
| Entitlement | 允许的操作 |
|---|---|
can_access_files | 读取、写入和删除卷内文件 |
can_connect_nbd | NBD 块设备访问 |
can_connect_sftp | SFTP 文件访问 |
can_manage_snapshots | 管理 Volume snapshots |
can_manage_backups | 管理 Volume backups |
Storage Volume 的 can_edit 会自动包含以上所有专项 entitlement。直接授予某个专项 entitlement 时不会自动得到 can_view。
Incus Storage Bucket 创建的是供应用直接使用的 S3 兼容服务,不是计算设施消费的数据接口,也不等同于联邦原生对象存储设施。应用负责其 Bucket、访问凭证和数据的使用。
以下 API 资源没有独立 OpenFGA 对象,复用父对象权限:
| 子资源 | 权限所属对象 |
|---|---|
| Instance snapshot、backup、log、metadata | Instance |
| Volume snapshot、backup、bitmap | Storage Volume |
| Bucket key、backup | Storage Bucket |
| Network forward、load balancer、peer | Network |
| Network Zone record | Network Zone |
| Cluster member、cluster group、warning | Server |
| Events、Operations | Project |
Network 是共享资源的特例。Incus 可以使用 shared_with 把 Default Project 的 Network 共享给其他 Project;共享项目的 viewer 只能查看该 Network,不能修改它。
can_view 过滤,因此无权限时经常返回空列表而不是 403。can_view 不允许访问实例文件,但 can_exec、console、NBD 和 SFTP 均属于高敏感数据面权限。can_view 可以导出 Volume backup,不应把它视为仅查看元数据。can_view 可以读取 Bucket key 的 Access Key 和 Secret Key,不应把它授予不应接触 Bucket 数据的观察者。| 需求 | 建议关系 |
|---|---|
| 只读一个 Project 的全部资源 | Project viewer |
| 使用一个 Project 的全部实例,但不能启停或改配置 | Project user |
| 管理一个 Project 中的资源,但不能修改 Project 限制 | Project operator |
| 只读一个 Instance | Instance viewer |
| 只在一个 Instance 执行命令 | Instance viewer + can_exec |
| 只启停一个 Instance | Instance viewer + can_update_state |
| 完整管理一个 Instance | Instance operator |
| 只查看或编辑一个普通资源 | 对支持直接授权的 Image、Network、Profile、Volume 等对象授予 can_view、can_edit 或专项 entitlement |
模型没有 deny。如果需要“查看项目中除某实例外的全部资源”,不能先授予 Project viewer 再拒绝该实例,必须逐个授予允许访问的对象。
Incus 官方明确要求:不信任其拥有宿主机 root 权限的用户不得授予以下关系:
server: admin
server: operator
server: can_edit
server: can_create_storage_pools
server: can_create_projects
server: can_create_certificates
certificate: can_edit
storage_pool: can_edit
project: admin
其余关系也必须配合严格的 Project restrictions。尤其是 Project operator,如果项目允许特权实例、宿主机磁盘或设备直通,仍可能影响宿主机。