CCSecureBoot

模组

· 作者 JackMacWindows

在 CC: Tweaked 中实现启动安全。

0 本站下载 0 关注 更新于 11 个月前

需要前置:CC: Tweaked

最新 1.0.2 · 1.21.8 · NeoForge

一键开服(送7天)

CCSecureBoot

在 CC: Tweaked 中实现启动安全。

安装

必须已安装 CC: Tweaked 1.112.0 或更高版本。

只需将构建好的 JAR 文件安装到 mods 文件夹中。该模组仅在服务器端运行,因此多人游戏客户端无需安装。

使用方法

默认情况下,所有计算机的启动安全功能均处于禁用状态。要为计算机启用启动安全,请运行 enroll-secure-boot 程序。该程序将为计算机生成一个新密钥,并将其放置在软盘上以妥善保管。

enroll-secure-boot 首先会显示有关启动安全的一些重要信息,并询问是否继续。然后它会提示输入密钥密码——这是可选的,但建议设置以防止密钥意外泄露。如果未检测到磁盘,它将等待插入磁盘。准备就绪后,将生成并保存密钥,同时恢复启动配置也会放置在磁盘上。

当启用启动安全时,计算机只能从带有签名的文件启动。可以使用 sign 命令对文件进行签名,这将在程序旁边创建一个 .sig 文件。签名时必须将密钥磁盘放入磁盘驱动器中。

启动安全禁用了直接访问 shell 的功能——默认情况下它只会启动到 startup.lua(该文件必须已签名)。如果插入了密钥磁盘,将出现一个启动菜单,提供启动 shell 的选项。

启动安全基于 pxboot 运行,允许自定义启动屏幕,包括添加更多菜单项、更改默认条目和超时时间以及美化菜单。额外的配置可以从 /pxboot_config.lua 加载,这也必须进行签名。有关如何为 pxboot 编写配置的更多信息,请参阅仓库说明。

可以通过在任何插入了密钥卡的计算机上运行 unenroll-secure-boot 来禁用计算机的启动安全。计算机是通过密钥卡解除注册的,而不是通过计算机 ID,因此无法再启动的计算机也可以被解除注册。密钥也会被撤销,从而防止密钥泄露后的滥用。

如果丢失了计算机的密钥,则无法恢复该计算机——将无法再修改启动文件或从启动安全中解除注册。请将密钥磁盘存放在其他玩家接触不到的安全地方。

保护你的代码

启动安全仅确保进入程序的信任根——它并不能保证整个计算机是安全的。你需要自行确保代码免受黑客攻击,包括检查所有加载的代码并避免使用不安全的程序。

当启用启动安全时,由于启动管理器的设置方式,你自动受到保护,免受两种最基本的程序绕过手段:按住 Ctrl+T 终止到 shell,以及插入包含 startup 文件的磁盘。你不需要在程序中针对这些情况进行防护(尽管理想情况下你应该安全地处理 terminate 事件,而不是报错重启)。

为了帮助代码签名,CCSecureBoot 暴露了一个易于使用的库,该库基于启动管理器使用的相同代码。只需调用 dofile("/rom/modules/main/codesign.lua") 即可访问一些使检查签名更简单的函数:

  • codesign.verify(path):简单验证文件的签名,并返回一个布尔值表示文件是否安全。
  • codesign.execute(cmd, ...):shell.execute 的包装器,用于检查命令的签名。但这不允许 ROM 程序——请使用普通的 shell.execute 运行已知安全的程序。
  • codesign.loadfile(path, mode, env):loadfile 的包装器,用于检查文件的签名。这会自动允许 /rom/modules 中的模块,但对 ROM 的其他部分无效。
  • codesign.dofile(path):dofile 的包装器,用于检查文件的签名。这会自动允许 /rom/modules 中的模块,但对 ROM 的其他部分无效。
  • codesign.enforceModuleSigning():要求通过 require 加载的所有模块进行代码签名。在程序开始时调用一次——它将在程序的剩余生命周期内保持活动状态。这在 codesign.execute/shell.execute 调用内部不会保留——在新的程序中再次调用。
  • codesign.sign(data, password):为提供的数据生成签名 blob。其格式与 .sig 文件相同。必须插入密钥磁盘,如果密钥受密码保护,则必须提供密码。
  • codesign.load(data, sig, name, mode, env):load 的包装器,使用提供的签名 blob 检查代码的签名。

如果你的程序通过 require 使用模块,请在加载任何模块之前启用模块签名,以确保它们正确签名且未被不受信任的代码替换:

-- require 可能会加载本地模块而不是 ROM 中的模块——始终使用 dofile 加载 codesign:
local codesign = dofile "/rom/modules/main/codesign.lua"
codesign.enforceModuleSigning()
-- 现在 require 可以安全地加载外部模块:
local yourmod = require "yourmod"
-- ...

提醒一下,切勿在没有受限环境的情况下通过 load 加载不受信任的代码,尤其是当输入来自调制解调器时。如果你想加载代码,请为其提供一个高度受限的环境,仅包含所需的函数(如果有的话)。(尽管 textutils.unserialize 加载代码,但它使用空环境,因此被认为是安全的。)

内部工作原理

CCSecureBoot 使用 PKCS 或 S/MIME 协议栈来存储加密信息,并使用 Ed25519 进行签名。大部分繁重工作由 Lua 端的 libcert 和 ccryptolib 以及 Java 端的 Bouncy Castle 完成。

服务器保存一个唯一的私钥,位于存档目录中的 computercraft/root.key,以及一个关联的证书,位于 computercraft/certs/root.pem。它们作为服务器的信任根(root of trust)。随后,计算机可以请求由该根证书签名的自身证书,这些证书在验证时可追溯至根证书。请求通过一个 Java API 传递,该 API 被隐藏在 require 调用之后。

CCSecureBoot 向 /rom/autorun 插入一个程序,用于检查是否已注册。如果当前计算机已注册,则运行 pxboot。它通过查找 /rom/pxboot/certs/enrolled/<id> 来检查注册状态,其中 /rom/pxboot/certs 是一个挂载在 computercraft/certs 中的存档挂载点(允许模组在运行时编辑它)。

所使用的 pxboot 版本包含一个模块,该模块在所有加载代码的命令中插入签名检查。签名存储在必须签名的文件旁边的 PEM 编码 PKCS#7 容器中,并包含签名者的证书以及签名本身。这使得签名可以独立存在,而无需单独的有效证书列表——嵌入式证书可以与受信任的根进行验证。

注册安全启动涉及为当前计算机 ID 生成 PKCS#10 签名请求。计算机首先生成一个私钥,然后为关联的公钥创建签名请求。CSR 的主题中包含一个字段 uniqueIdentifier(OID 2.5.4.45),其中包含计算机的 ID。此 ID 必须与正在运行的计算机匹配,否则签名请求将被拒绝。

随后,CSR 以 PEM 格式传递给服务器进行签名,使用 secureboot.enroll(csr)。如果 ID 匹配,新的 X.509 证书将被返回(PEM 编码),并在 computercraft/certs/enrolled//rom/pxboot/certs/enrolled 中为计算机 ID 创建一个文件,告知引导加载器检查签名。

此后,证书和密钥分别以 X.509 和 PKCS#8 格式保存,均为 PEM 编码。为了安全起见,在磁盘上创建了用于加载 shell 的引导配置和启动程序,并使用新密钥对其进行签名。

签名是一个简单的 PKCS#7 签名操作,使用软盘上存储的证书和密钥。

取消注册涉及调用 secureboot.unenroll(cert, signature),传入计算机的证书(PEM 编码的 X.509)以及一个已签名的挑战字符串。挑战文本仅仅是目标计算机 ID 的字符串形式,签名以裸 Ed25519 签名形式传递,省略了任何 PKCS#7 包装器以简化处理(因为在 Java 中没有简便的 PKCS#7 签名检查方法)。如果证书有效且签名通过,注册文件将被删除,并且证书将存储在证书吊销列表中,存储位置为 computercraft/certs/revoked.crl。

许可证

CCSecureBoot 根据 MPLv2 许可,部分根据 MIT 许可。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源