管理用户和角色
用户在 Excubius 中能做什么,取决于他们在每个实体上拥有的角色。你在 Settings › Users and roles 下管理访问权限,范围是在选取器中选择的实体及其下的所有内容。本指南说明如何邀请用户、授予和删除角色、映射目录组以及停用账户。
开始之前
- 你需要在所管理的分支上拥有 Entity admin(实体管理员)角色。页面只显示你所管理分支的用户、角色和邀请。
- 已设置 Microsoft Entra ID 或 Google 登录。没有需要分发的密码。请参阅设置登录提供商。
- 用户在首次登录后才会出现在列表中。若要为从未登录过的人授予访问权限,请邀请他们。
角色及授予角色的限制
角色是在实体上授予的,适用于该实体及其下的所有内容。在任何实体上,一个人的有效角色是在该实体及其上级实体上找到的最高角色,同时计入其自身的角色和其目录组的角色。
| 角色 | 可以 |
|---|---|
| Viewer(查看者) | 读取仪表板、警报和资源详细信息;更改自己的设置 |
| Operator(操作员) | 查看者可以做的一切,另外还可以确认、静默、分配和解决警报,创建 Jira 问题,以及启动维护时段 |
| Editor(编辑者) | 操作员可以做的一切,另外还可以更改检查和阈值,以及接受安全风险 |
| Entity admin(实体管理员) | 编辑者可以做的一切,另外还可以管理分支的实体、资源、凭据、用户、角色、邀请、注册、Slack 频道和状态页 |
| Super admin(超级管理员) | 在所有位置执行所有操作,包括实例和服务器设置 |
授予角色时:
- 你只能在你是 Entity admin 的实体上授予角色,即该实体本身或其上级实体。
- 你绝不能在该实体上授予高于你自己的角色。实体管理员可以将另一个人设为实体管理员,但不能设为超级管理员。
- 只有超级管理员才能授予 Super admin,并且只能在根实体上授予。
- 最后一个超级管理员无法被删除。
邀请用户
- 打开 Settings › Users and roles,并在选取器中选择实体,例如 高密物流。
- 选择 Invitations 选项卡,然后选择 Invite someone。
- 输入 E-mail 地址、Entity 和 Role,例如
bo.diaz@ciguapa.example、高密物流 › Production 和 Operator。 - 在 Valid for (days) 中,保留 7,或输入 1 到 90 之间的值。
- 选择 Create invitation。此时会出现 Invitation link。
- 选择 Copy,并通过你常用的渠道把链接发送给对方。Excubius 不会发送电子邮件。
链接只显示一次:Excubius 存储的是链接的指纹,而不是链接本身。对方打开链接,使用该地址对应的账户登录,随即获得角色。在此之前,邀请会在 Pending invitations 下列出,并显示其到期时间。
若要取消尚未使用的邀请,请选择它旁边的垃圾桶图标(Revoke the invitation for 该地址)。
为用户授予角色
此操作适用于至少已登录过一次的用户。
- 在 Settings › Users and roles 中,选择 Role assignments 选项卡。
- 在 Give a role 下,将 To 设置为 A person,并在 Person 下选择此人。
- 选择 Entity 和 Role。列表绝不会提供高于你自己在该实体上的角色。
- 选择 Give role。
角色从此人的下一次请求起生效。
为目录组授予角色
目录组角色属于 Enterprise 计划。当功能 access.directory_groups 开启时,会显示该选项。
Microsoft Entra ID 组的成员通过其登录令牌中的组获得角色。应用注册必须发送组声明;请参阅在 Microsoft Entra ID 中注册 Excubius。
- 在 Microsoft Entra admin center 中,复制该组的 Object ID。
- 在 Settings › Users and roles 中,选择 Role assignments 选项卡。
- 在 Give a role 下,将 To 设置为 A directory group。
- 在 Group 中,输入
entra:后接对象 ID,例如entra:3f2b9c41-7d5e-4a8b-9c6d-1e2f3a4b5c6d。组名称无效。 - 选择 Entity 和 Role,然后选择 Give role。
成员从下次登录起获得角色。People 选项卡会用 via group 显示这样的角色。
| 目录中的更改 | 在 Excubius 中何时生效 |
|---|---|
| 有人加入该组 | 在其下次登录时 |
| 有人离开该组 | 在其下次登录时。会话在没有重新登录的情况下最长持续 14 天,因此若要立即切断访问,也请停用此人 |
| 此人属于 200 个以上的组 | Entra ID 不发送任何组,此人无法通过任何组获得角色。请使用 Groups assigned to the application,或直接向此人授予角色 |
更改或删除角色
一个用户或一个组在每个实体上只有一个角色分配。
- 在 Settings › Users and roles 中,选择 Role assignments 选项卡。
- 找到该分配,并选择它旁边的删除图标(Remove the role of 该用户或组)。
- 若要更改角色,请按上述方法授予新角色。
删除角色会在此人的下一次请求时生效。来自允许域注册的角色不会在其下次登录时恢复。
停用用户
停用会在用户的下一次请求时终止其访问权限,但不会删除其账户或历史记录。
- 在 Settings › Users and roles 中,选择 People 选项卡并找到此人。如果列表很长,请按名称或地址搜索。
- 在 Active 列中,将其关闭。
若要恢复访问权限,请再次开启 Active。任何人都不能停用自己。你只能停用其所有角色都位于你所管理的分支内,并且不高于你自己角色的用户。
被停用的用户尝试登录时,会看到其账户已停用,并且需要管理员重新激活。