EOELAB

EOELAB 权限模型

EOELAB 权限模型

本文档集中说明 EOELAB 各设施的权限等级、继承关系和安全边界,供权限设计、授权审查和故障排查使用。本地域接入与资源配置参见《EOELAB 运维手册》,用户操作参见《EOELAB 用户手册》。

Zitadel

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

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 核对已有用户并绑定。

Headscale 网络身份与 ACL

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

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

公共 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

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

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 三元组:

userrelationobject含义
user:aliceoperatorproject:devAlice 是 dev 项目的操作员
group:ops#memberoperatorproject:devops 组成员是 dev 项目的操作员
user:alicecan_execinstance:dev/web01Alice 只能获得 web01 的命令执行能力

关系元组的增删和查询在 fga-console 中完成。

对象格式

所有对象均使用 <类型>:<标识符> 格式。项目级对象的标识符以项目名开头,不是单独的 project/instance_name 参数。

对象格式示例
Serverserver:incus
Projectproject:dev
Certificatecertificate:<完整指纹>
Storage Poolstorage_pool:local
Network Integrationnetwork_integration:ovn
Instanceinstance:dev/web01
Imageimage:dev/<完整指纹>
Image Aliasimage_alias:dev/debian
Networknetwork:dev/br0
Network ACLnetwork_acl:dev/web
Network Address Setnetwork_address_set:dev/internal
Network Zonenetwork_zone:dev/example.net
Profileprofile:dev/default
Storage Bucketstorage_bucket:dev/local/archive[/location]
Storage Volumestorage_volume:dev/local/custom/data[/location]

server、project 和 shared_with 是 Incus 维护资源归属关系时使用的结构关系,不应作为普通用户权限手动修改。

模型规则

  1. 权限只做并集,没有 deny。用户通过任意一条关系路径获得 entitlement 后,不能在子对象上用另一条元组拒绝。
  2. 父级角色向下生效。Server 角色影响所有 Project,Project 角色影响该项目的资源和 Instance。
  3. 创建资源不会让创建者自动成为 owner。模型中没有 owner 关系,单独的 can_create_* 不保证创建后还能查看或管理资源。
  4. can_edit 通常包含修改、重命名和删除,不是无破坏性的“编辑配置”。
  5. 单独授予 can_exec、can_update_state 等专项 entitlement 不会自动获得 can_view。CLI 可能会先查询对象,因此最小权限通常还要搭配 viewer。
  6. 一个 CLI 命令可能访问多个对象。例如创建实例通常还需要查看源镜像以及所用 Profile、Network;复制和移动还会分别检查源、目标对象。
  7. 模型中包含 [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:*

所以每个已经通过认证的用户即使没有任何业务角色,仍然拥有:

因此“没有分配角色”不等于完全没有可见信息。

角色继承

三个作用域中的角色均按以下顺序包含右侧角色:

admin -> operator -> user -> viewer

Server 的同名角色会传递给所有 Project,Project 的同名角色会传递给其所有 Instance。

作用域角色实际能力
Serverviewer查看所有项目及其资源、证书、网络集成和完整 Server config
Serveruserviewer + 所有项目的 user,可进入所有实例并访问其数据面
Serveroperatoruser + 所有项目的 operator,可创建、修改、删除所有项目资源
Serveradmin完整服务器和集群管理、全局资源创建,并成为所有项目的 admin
Projectviewer查看该项目及其所有资源
Projectuserviewer + 查看项目 events/operations + 项目内所有实例的 user
Projectoperatoruser + 创建、修改、删除项目资源 + 项目内所有实例的 operator
Projectadminoperator + 修改、重命名、删除项目本身及其限制配置
Instanceviewer查看一个实例的配置、状态、日志、快照和备份信息
Instanceuserviewer + console、exec、文件、SFTP、NBD 和 TCP 转发
Instanceoperatoruser + 编辑、删除、启停、重建以及管理快照和备份
Instanceadmin当前模型中实际能力与 operator 相同,没有额外 entitlement

需要特别注意:

Server Entitlement

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_restrictionProject 禁止指定 Cluster target 时仍允许指定成员

Project Entitlement

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

Instance Entitlement

Entitlement允许的操作
can_viewlist/show/info/state,读取日志、metadata、NVRAM、快照和备份信息
can_edit修改配置、rename/move/migrate/delete、rebuild、恢复快照、修改 metadata/NVRAM
can_update_statestart、stop、restart、freeze、unfreeze
can_access_console连接 Instance console;读取 console log 只需要 can_view
can_exec在实例中执行命令,并访问 exec output
can_access_filespull、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。

其他资源 Entitlement

对象can_viewcan_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_nbdNBD 块设备访问
can_connect_sftpSFTP 文件访问
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、metadataInstance
Volume snapshot、backup、bitmapStorage Volume
Bucket key、backupStorage Bucket
Network forward、load balancer、peerNetwork
Network Zone recordNetwork Zone
Cluster member、cluster group、warningServer
Events、OperationsProject

Network 是共享资源的特例。Incus 可以使用 shared_with 把 Default Project 的 Network 共享给其他 Project;共享项目的 viewer 只能查看该 Network,不能修改它。

列表和数据读取语义

最小权限选择

需求建议关系
只读一个 Project 的全部资源Project viewer
使用一个 Project 的全部实例,但不能启停或改配置Project user
管理一个 Project 中的资源,但不能修改 Project 限制Project operator
只读一个 InstanceInstance viewer
只在一个 Instance 执行命令Instance viewer + can_exec
只启停一个 InstanceInstance viewer + can_update_state
完整管理一个 InstanceInstance 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,如果项目允许特权实例、宿主机磁盘或设备直通,仍可能影响宿主机。