安全
我能放心地把设备群交给它吗?
本页概述 DeviceChain 文档中的安全模型:目前已强制执行什么、发布版本如何签名,以及哪些尚未具备。本页不增加文档之外的任何内容,每一节都链接到完整说明细节的页面。
租户隔离在数据和消息中强制执行。
- 同一组服务为所有租户提供服务,因此隔离在数据和消息中强制执行,而不是依靠独立的 Pod。
- 租户拥有的表带有租户,中央数据库作用域为每次读取添加租户条件,并为每次写入标记租户。没有租户上下文的租户作用域查询会被拒绝,而不是不加过滤地执行。
- 消息 subject 按租户划分,格式错误的租户段会在服务发布或订阅处被拒绝。
- 请求的租户取自调用方已验证令牌中的租户声明。服务调用另一个服务时,在请求头中指明租户,仅在服务令牌的签名验证通过后才会采用。
设备只能以自己的身份发言。
- 代理的 MQTT 和 NATS 监听器默认使用 TLS。HTTP 接入由实例 ingress 的 TLS 保护。
- 代理请求平台批准每个连接,平台将该连接绑定到那一台设备自己的 subject。设备无法向其他设备或其他租户的 subject 发布,也无法读取它们的命令。
- 设备密码和访问令牌仅以带密钥的单向摘要形式存储,所用密钥由实例根密钥派生。每一个都只在设置时显示一次。
- 在平台自己的 MQTT 代理上,设备可以使用 X.509 客户端证书认证。平台在每次连接时对照租户添加的信任锚检查证书链,要求 clientAuth 密钥用途,并拒绝 SHA-1 和弱密钥。设备在 TLS 握手中证明自己持有密钥,因此不存储也不发送任何可重放的东西。
- 设备群可以使用服务器生成的 256 位密文自注册,该密文仅以带密钥的摘要形式存储,并以恒定时间比较。认证失败的所有情形得到同一个应答,因此响应从不说明是哪一部分出了错。
- 禁用、轮换或删除凭据会立即拒绝新连接,并结束该设备已打开的会话。
更新会检查完整性,并由你注册的密钥签名。
- 上传的字节必须与制品声明的大小和 SHA-256 摘要一致。不一致的正文会被删除,制品保持在上传中状态。
- 签名者以公钥形式按租户注册(ECDSA P-256 或 Ed25519)。平台从不需要私钥,提交私钥会被拒绝。
- 默认情况下,没有任何已注册签名者签名的制品无法被分配。
- 分配已签名的制品时,设备会收到对该制品摘要的签名。你的设备必须在安装前验证该签名;在设备上检查是设备自己的职责,设备还必须强制检查版本和组件,签名并不覆盖这两项。更新路径已经针对参考设备做过端到端验证。
- 更新服务属于默认安装配置。
文档中: 空中(OTA)更新:签名者 · “已验证”的含义 · 为更新签名
存储的密钥经过密封,且只写不读。
- 租户存储的凭据,例如连接器设置和身份提供商的客户端密钥,保存在加密的密钥存储中。
- 每个值都用各自的 AES-256-GCM 数据密钥密封,该密钥再由实例根密钥包裹。
- 通过 API,值是只写的:它在服务器内部使用时才解析,从不返回。变更按操作人、时间和句柄记入审计,从不记录值本身。
- 根密钥有成文的托管和恢复流程,托管副本可以用
dcctl secrets escrow verify检查。
租户的 webhook 和连接器可以向哪里发送,在连接建立时检查。
- webhook、邮件中继和出站连接器在每次建立连接的那一刻检查,依据的是名称实际解析到的地址。
- 回环地址、私有地址、运营商级 NAT 地址、链路本地地址和云元数据地址默认会被拒绝。运维人员可以允许特定的私有地址,该允许对每个租户以及每个连接器和 webhook 都生效。
- 对于 Kafka,集群通告的每一个代理都会被检查,而不仅是你配置的地址。
文档中: 安全模型:出站流量 · 出站连接器:连接器可以向哪里发送
API 请求经过认证,并按权限检查。
- 登录会签发使用 RS256 签名的令牌。每个服务根据已发布的密钥集在本地验证。签名密钥由一个服务持有,并在实例根密钥下密封。
- 角色携带权限,API 在每次调用时检查。成员资格可以限制在某个客户的数据范围内,租户自行管理的成员、邀请和角色,授予的权限不能超过授予者自己拥有的权限。
- 服务账号用客户端 ID 和密钥换取有效期 5 分钟的访问令牌,没有刷新令牌,也不涉及任何人的登录。
- 租户可以要求通过自己的 OpenID Connect 身份提供商登录,账号也可以要求在密码之后再输入验证器应用生成的代码。
- 服务令牌端点和签名密钥集在单独的内部端口上提供,任何 ingress、路由或负载均衡器都不指向该端口。
文档中: 安全模型:人员与程序 · 双重身份验证 · 不会离开集群的端点
AI 代理能做的永远不会超过授权它的那个人。
- 可选 MCP 服务器需显式启用。工具在调用者自己的令牌下读取;在 Preview 中启用代理操作后,代理也可提出确认或清除告警,只有人在控制台批准后才会执行。
- 它位于 OAuth 2.1 授权服务器之后:带 PKCE 的授权码、RFC 8414 元数据、刷新令牌轮换和 RFC 8707 受众绑定。
- 服务器自己不持有令牌。每次调用都使用调用方自己的令牌,因此代理只能读取其用户可读取的内容。
文档中: MCP:安全模型
变更会连同操作人一起记入日志。
- 每个服务对租户数据所做的每一次创建、更新和删除,都会记录一条带有执行身份的日志条目。
- 登录服务还会记录登录事件,例如登录、登录失败和单点登录结果。
- 登记条目与它所描述的变更在同一个事务中写入。
文档中: 安全模型:审计
运行之前,先检查你要运行的内容。
- 每个服务镜像、Operator、边缘代理、代理管理员、消息代理和控制台镜像,以及 Helm chart,都使用 cosign 以无密钥方式签名。每个签名都绑定到发布工作流和标签,并记录在公共透明日志中。
- 每个镜像还附带一份已签名的 SPDX 内容清单(SBOM),镜像和 chart 带有 SLSA 构建来源证明。SBOM 由 amd64 变体生成。
- 一个脚本检查所有镜像和 chart,然后证明自己的检查确实会失败:它会拒绝一个不可能匹配的身份,以及一个并非为该发布版本签名的镜像。
- dcctl 和边缘代理的归档文件带有构建来源证明,自 0.14.0 起的每个 npm 包版本都带有 npm 来源证明。
- 签名从 v0.25.0 开始。
文档中: 验证发布版本 · 验证脚本 · 验证能告诉你什么、不能告诉你什么 · npm 包
请私下报告漏洞。
- 请不要通过公开的 issue、讨论或拉取请求报告漏洞。
- 请使用代码仓库“Security”标签页上的 GitHub 私密漏洞报告功能(首选);无法使用 GitHub 时,请发送邮件至 admin@devicechain.io。
- 安全政策按严重程度规定了确认、评估和修复的响应目标。这些是目标,不是保证。
- 自 1.0.0 起,安全修复会发布到最新的 1.x 次要版本;对于高危和严重问题,在下一个次要版本发布后的 90 天内,也会发布到上一个 1.x 次要版本。
尚未具备的内容。
文档中将这些列为已接受的缺口。请据此规划。
- 尚未发布外部渗透测试报告。
- 一个实例的所有服务共用一个数据库登录,因此数据库中的租户隔离依赖应用的租户作用域,而不是数据库权限。
- 任何能读取实例 Kubernetes Secret 的人都能读取实例根密钥,且目前尚未提供外部密钥管理器。
- 双重身份验证只保护密码。租户的要求约束的是进入该租户,而不是运维人员的管理平面:仅凭密码会话的超级用户可以进入这样的租户,每次进入都会被审计。持有密码并在锁定上限处不断猜测的人,一年内约有 10% 的机会进入,并且可以持续让所有者的验证器保持锁定。
文档中: 已接受缺口的完整列表
本页内容不能替代你自己的评估。如果这里的某一项对你的部署构成问题,相应的文档章节会说明该控制措施位于何处。