安全模型
Excubius 不为你的团队保存任何密码:用户使用你的组织已经管理的 Microsoft 或 Google 账户登录。之后,他们能看到什么、能做什么,取决于他们在实体树每个分支上所拥有的角色,并且每次请求都会重新检查。采集器所需的机密以加密方式存储,永远无法读回。本文介绍每一层。
登录
Excubius 通过带有 PKCE、state 和 nonce 的授权代码流,使用 OpenID Connect 与 Microsoft Entra ID(单个租户)和 Google 集成。其中不涉及任何提供商 SDK,也不涉及任何付费的标识服务。
- 每次登录都会验证 ID 令牌:根据提供商发布的密钥验证其签名,并验证颁发者(对于 Entra ID,即你的租户)、受众、到期时间以及该次登录的
nonce。 - 正在进行的登录保存在一个已签名的 HttpOnly Cookie 中,有效期为 10 分钟。登录后要返回的页面必须是同一站点的页面,因此精心构造的链接无法把任何人带到别处。
- 账户以提供商和主题作为键,即用户在 Entra ID 中的对象 ID 或 Google 的主题,绝不会只用电子邮件地址作为键。
- 谁可以获得账户由每个实体决定:通过邀请,或通过允许的电子邮件域。只有当 Google 账户是该域的 Google Workspace 账户时,才算属于该域;个人 Google 账户始终需要邀请。
- 提供商的机密只来自服务器的配置。它们、授权代码和令牌都不会存储在数据库中、由 API 返回或写入日志。
| 提供商 | 计划 |
|---|---|
| Free、Core、Pro、Enterprise | |
| Microsoft Entra ID | Core、Pro、Enterprise |
| 以 Microsoft Entra ID 组作为角色持有者 | Enterprise |
多重身份验证
MFA 由你的标识提供商强制执行:Entra ID 条件访问或 Google 两步验证。Excubius 目前还不检查 MFA 声明,因此请在提供商处对所有可以登录的人要求 MFA,尤其是实体管理员。
会话和令牌
登录成功后会设置两个 Cookie,两者都是 HttpOnly,通过 HTTPS 时为 Secure,并且是 SameSite=Lax:
| 令牌 | 生存期 | 用途 |
|---|---|---|
| 访问令牌 | 15 分钟 | 在每次请求上证明你的身份 |
| 刷新令牌 | 14 天 | 获取一对新令牌;每次刷新都会颁发新的一对 |
权限不包含在令牌中。每次请求都会从数据库读取权限,因此停用用户、删除角色或更改组分配,会在该用户的下一次请求时生效。目录组的成员身份在每次登录时重新读取。
目前还无法逐个撤销刷新令牌。若要在会话到期之前结束某人的访问权限,请停用该用户。从 Excubius 注销不会让你从 Microsoft 或 Google 注销。
目前还没有 API 密钥:在此版本中,脚本和其他工具无法以自己的身份调用 API。
实体树上的角色
角色是授予某个人或某个目录组的,作用在某个实体上,并适用于该实体及其下的所有内容。同一个人可以是某个客户的 Entity admin,同时是另一个客户的 Operator。在任何实体上,有效角色是该实体及其上级实体中找到的最高角色,包括此人自己的角色和其所属组的角色。
| 角色 | 可以执行的操作 |
|---|---|
| Viewer(查看者) | 阅读仪表板、警报、发现和资源详细信息;更改自己的设置 |
| Operator(操作员) | 查看者能做的一切,另外可以确认、静默、分配和解决警报,创建 Jira 工单,以及规划维护时段 |
| Editor(编辑者) | 操作员能做的一切,另外可以更改资源的检查和阈值,并接受安全风险 |
| Entity admin(实体管理员) | 编辑者能做的一切,另外可以管理该分支的实体、实体默认值、资源、凭据、数据源、人员、角色、邀请、通知频道、Jira 设置和状态页 |
| Super admin(超级管理员) | 在每个分支上可以执行一切操作,另外可以管理整个安装的设置。只能在根节点上由另一位超级管理员授予 |
这在实际使用中意味着:
- 每个列表都限于你所在的分支:实体、资源、警报、Overview、凭据、频道和人员。如果你的角色从 高密物流 开始,你看到的实体树也从那里开始。
- 你所在分支之外的任何内容对你来说都不存在:打开其地址会返回 Not found, or no longer visible to you。你能看到但不能更改的内容,会返回 Your role does not allow this。
- 授予角色只限于你的分支和级别:实体管理员只能邀请用户并在自己管理的实体上授予角色,而且授予的角色不能高于自己的角色。
- 凭据属于拥有它的实体,该实体及其下级的资源都可以使用。要用某个凭据让采集器连接到某台主机,需要在该凭据所在的实体上拥有实体管理员角色,因此某个客户的管理员无法把从上级共享下来的登录名指向他们自己选择的主机。
实体、标记和继承介绍了实体树本身。
机密
监视凭据、数据源 API 密钥、客户端机密以及已上传证书的密钥都是只写的:
- 它们在数据库中使用 AES 和 HMAC 签名(Fernet)加密,所用密钥由安装程序生成并保存在服务器的配置文件中,而不是数据库中。仅凭数据库转储无法得到任何机密。
- 屏幕和 API 只会说明机密是否已设置,例如 stored — leave empty to keep it。无论角色如何,任何人都无法读回机密。
- 机密在服务器上解密,或在检查需要时通过服务器的内部网络发送给采集器。采集器把它保存在内存中,从不写入日志。
- 采集器容器只接收自己的令牌和设置:从不接收数据库密码、会话签名机密或加密密钥。采集器的路由在服务器边缘被拒绝,因此只能从内部访问。
这些凭据本身在创建时,对受监视的系统不具有写入或安装权限;请参阅体系结构。
审核
通过 API 所做的每项更改都会写入审核日志,并记录执行操作的用户、时间和请求的 IP 地址。对于登录和访问,这包括:
| 事件 | 记录为 |
|---|---|
| 一次登录 | login |
| 提供商应答后的一次拒绝,并附上原因 | login.failed |
| 首次登录时创建的账户 | user.create |
| 创建、接受或删除的邀请 | invitation.create、invitation.accept、invitation.delete |
| 授予或删除的角色 | role.grant、role.revoke |
| 注册模式的更改 | registration.update、registration.reset |
| 对用户或其首选项的更改 | user.update、user.preferences |
警报操作、阈值更改、数据源更改、维护时段和状态页编辑也以同样的方式审核。审核日志保存在平台数据库中。