跳到主要内容
版本:0.4 · 当前版

管理用户和角色

操作指南审阅日期:2026年10月11日
适用于:Excubius 0.4角色: 实体管理员
计划Free · Core · Pro · Enterprise部署自托管

用户在 Excubius 中能做什么,取决于他们在每个实体上拥有的角色。你在 Settings › Users and roles 下管理访问权限,范围是在选取器中选择的实体及其下的所有内容。本指南说明如何邀请用户、授予和删除角色、映射目录组以及停用账户。

开始之前​

  • 你需要在所管理的分支上拥有 Entity admin(实体管理员)角色。页面只显示你所管理分支的用户、角色和邀请。
  • 已设置 Microsoft Entra ID 或 Google 登录。没有需要分发的密码。请参阅设置登录提供商。
  • 用户在首次登录后才会出现在列表中。若要为从未登录过的人授予访问权限,请邀请他们。

角色及授予角色的限制​

角色是在实体上授予的,适用于该实体及其下的所有内容。在任何实体上,一个人的有效角色是在该实体及其上级实体上找到的最高角色,同时计入其自身的角色和其目录组的角色。

角色可以
Viewer(查看者)读取仪表板、警报和资源详细信息;更改自己的设置
Operator(操作员)查看者可以做的一切,另外还可以确认、静默、分配和解决警报,创建 Jira 问题,以及启动维护时段
Editor(编辑者)操作员可以做的一切,另外还可以更改检查和阈值,以及接受安全风险
Entity admin(实体管理员)编辑者可以做的一切,另外还可以管理分支的实体、资源、凭据、用户、角色、邀请、注册、Slack 频道和状态页
Super admin(超级管理员)在所有位置执行所有操作,包括实例和服务器设置

授予角色时:

  • 你只能在你是 Entity admin 的实体上授予角色,即该实体本身或其上级实体。
  • 你绝不能在该实体上授予高于你自己的角色。实体管理员可以将另一个人设为实体管理员,但不能设为超级管理员。
  • 只有超级管理员才能授予 Super admin,并且只能在根实体上授予。
  • 最后一个超级管理员无法被删除。

邀请用户​

  1. 打开 Settings › Users and roles,并在选取器中选择实体,例如 高密物流。
  2. 选择 Invitations 选项卡,然后选择 Invite someone。
  3. 输入 E-mail 地址、Entity 和 Role,例如 bo.diaz@ciguapa.example、高密物流 › Production 和 Operator。
  4. 在 Valid for (days) 中,保留 7,或输入 1 到 90 之间的值。
  5. 选择 Create invitation。此时会出现 Invitation link。
  6. 选择 Copy,并通过你常用的渠道把链接发送给对方。Excubius 不会发送电子邮件。

链接只显示一次:Excubius 存储的是链接的指纹,而不是链接本身。对方打开链接,使用该地址对应的账户登录,随即获得角色。在此之前,邀请会在 Pending invitations 下列出,并显示其到期时间。

若要取消尚未使用的邀请,请选择它旁边的垃圾桶图标(Revoke the invitation for 该地址)。

为用户授予角色​

此操作适用于至少已登录过一次的用户。

  1. 在 Settings › Users and roles 中,选择 Role assignments 选项卡。
  2. 在 Give a role 下,将 To 设置为 A person,并在 Person 下选择此人。
  3. 选择 Entity 和 Role。列表绝不会提供高于你自己在该实体上的角色。
  4. 选择 Give role。

角色从此人的下一次请求起生效。

为目录组授予角色​

计划

目录组角色属于 Enterprise 计划。当功能 access.directory_groups 开启时,会显示该选项。

Microsoft Entra ID 组的成员通过其登录令牌中的组获得角色。应用注册必须发送组声明;请参阅在 Microsoft Entra ID 中注册 Excubius。

  1. 在 Microsoft Entra admin center 中,复制该组的 Object ID。
  2. 在 Settings › Users and roles 中,选择 Role assignments 选项卡。
  3. 在 Give a role 下,将 To 设置为 A directory group。
  4. 在 Group 中,输入 entra: 后接对象 ID,例如 entra:3f2b9c41-7d5e-4a8b-9c6d-1e2f3a4b5c6d。组名称无效。
  5. 选择 Entity 和 Role,然后选择 Give role。

成员从下次登录起获得角色。People 选项卡会用 via group 显示这样的角色。

目录中的更改在 Excubius 中何时生效
有人加入该组在其下次登录时
有人离开该组在其下次登录时。会话在没有重新登录的情况下最长持续 14 天,因此若要立即切断访问,也请停用此人
此人属于 200 个以上的组Entra ID 不发送任何组,此人无法通过任何组获得角色。请使用 Groups assigned to the application,或直接向此人授予角色

更改或删除角色​

一个用户或一个组在每个实体上只有一个角色分配。

  1. 在 Settings › Users and roles 中,选择 Role assignments 选项卡。
  2. 找到该分配,并选择它旁边的删除图标(Remove the role of 该用户或组)。
  3. 若要更改角色,请按上述方法授予新角色。

删除角色会在此人的下一次请求时生效。来自允许域注册的角色不会在其下次登录时恢复。

停用用户​

停用会在用户的下一次请求时终止其访问权限,但不会删除其账户或历史记录。

  1. 在 Settings › Users and roles 中,选择 People 选项卡并找到此人。如果列表很长,请按名称或地址搜索。
  2. 在 Active 列中,将其关闭。

若要恢复访问权限,请再次开启 Active。任何人都不能停用自己。你只能停用其所有角色都位于你所管理的分支内,并且不高于你自己角色的用户。

被停用的用户尝试登录时,会看到其账户已停用,并且需要管理员重新激活。