安全运行时设计:NanoLang的NSI契约、不可伪造能力与最小权限服务
安全运行时设计:NanoLang的NSI契约、不可伪造能力与最小权限服务
NanoLang 是一个面向编程 LLM 的微型实验语言,而它的 NSI(Nano Service Interface,Nano 服务接口) 安全运行时设计,正是通过版本化契约、不可伪造的能力令牌(Capability)与最小权限服务,让程序对文件、网络、GPU 等敏感操作的每一次请求都必须"持证上岗"。这篇指南带你快速看懂 NanoLang 安全运行时的三大核心构件。
为什么需要"安全运行时"?
普通语言调用系统服务(读写文件、打开网络连接)往往是一步到位:程序说"打开这个路径",库就照做。NanoLang 的设计哲学则完全不同——模块边界必须是一份版本化的契约,任何越权、越界、格式不合法的请求都会"失败关闭(fail closed)":宁可直接报错,也不猜测、不降级、不绕过。
这套安全运行时由三层能力构成:
| 构件 | 职责 | 关键文档 |
|---|---|---|
| NSI 契约 | 声明模块暴露的方法、参数、类型、错误与所需能力 | docs/NSI.md |
| 能力运行时(Capability) | 发放不可伪造的权限令牌,支持衰减、转移与吊销 | docs/NSI_FABRIC.md |
| 最小权限服务与策略 | 按声明的效果发放精确权限,并记录、可回放 | docs/NSI_EFFECTS.md |
NSI 契约:把模块边界变成一份"合同"
一份 NSI 文档就是 UTF-8 编码的 JSON 文件,其中 nsi_version 固定为 0。解析器对契约极其严格:缺少 id、重复的 id、省略 params、未知的键(例如 c_type)都会直接拒绝——这是刻意的设计,ABI 不允许靠猜。
以日志服务的契约为例(schema/nsi/examples/log.nsi.json),它声明了:
- 接口
nsi:nanolang/log与两个方法write、write_event; - 参数级别的元数据:方向(
in/out/inout/return)、所有权(borrow/transfer/copy)、生命周期、可变性与是否流式; - 类型
Level(一个含 debug/info/warn/error 的 variant); - 错误
io与能力cap:nanolang/log.write。
所有标识符都是稳定的 ASCII 身份:接口以 nsi: 开头,方法写成 接口id#token 的形式(如 nsi:nanolang/log#write),能力以 cap: 开头(如 cap:nanolang/log.write)。名字(name)只是给人看的,身份(id)才是协议依赖的。
仓库中还内置了九个模块级契约,覆盖文件系统、网络、GPU、图形、音频、进程、Python 适配器等,见 schema/nsi/modules/ 目录。
不可伪造能力:拿不到、造不出、用旧的作废
安全运行时的核心是能力对象 NlCap,定义在 src/nsi_cap.h 中,结构只有三个字段:
secret:从宿主熵源铸造的随机密钥;slot:能力表中的槽位编号;generation:代数(代次)。
围绕这个结构,src/nsi_cap.c 实现了完整的生命周期:
- 铸造(mint):只有运行时可以凭熵源签发新能力,程序试图"用整数或宿主指针伪造"一个能力会直接失败关闭(
nl_cap_from_integer、nl_cap_from_pointer); - 衰减(attenuate):把父能力派生出一个权限更少的子能力——给出去的能力只能更小,不能更大;
- 转移(transfer):需要 transfer 权限位,转移后旧令牌立即失效;
- 吊销与重启(revoke / restart):服务重启或整体重启会提升
generation,旧代数的令牌统统作废。
调用方拿到资源(文件、socket 等)时,得到的不是宿主指针或描述符编号,而是一个携带能力身份的令牌:运行时在访问宿主状态前,会校验令牌、代数、服务/类型身份与所需权限。这就是"文件服务"私有适配器的思路,详见 docs/NSI_LOCAL_FILE_SERVICE.md 与 docs/NSI_LOCAL_SOCKET_SERVICE.md。
💡 一句话理解:能力就像一张带防伪码的单程票——不可复制、可降权转让、列车一重启就全部作废。
最小权限服务:每个服务只拿到它需要的钥匙
NanoLang 把"迁移到服务能力上的模块"设计成持有范围化能力,而不是简单地包装宿主库。对照 docs/NSI_FABRIC.md 中的服务清单:
| 服务 | 能力上绑定的权限范围 |
|---|---|
fs 文件系统 |
路径前缀写在能力上 |
net 网络 |
端点字符串写在能力上 |
process 进程 |
可执行/控制令牌写在能力上 |
audio / graphics / gpu |
只授予对应的共享缓冲映射权限 |
python |
类型化适配器,宿主指针直接进载荷会失败关闭 |
也就是说,一个"文件服务"的能力上明确绑定了它能碰的路径前缀,"网络服务"的能力上绑定了它可访问的端点——权限不是按模块授予的,而是按能力授予的,天然实现最小权限。
监督者(Supervisor)则负责服务的注册、按依赖顺序启动、健康检查与重启策略,并对内存、CPU、句柄、队列等资源施加配额:配额耗尽失败关闭,取消优先于挂死的调用,崩溃隔离服务重启后旧代数的能力自动失效。
从声明到部署:效果映射与陷阱日志
程序里写的一句 print,如何一路对应到"谁有权放行"?NanoLang 用五层映射回答这个问题(见 docs/NSI_EFFECTS.md 与 schema/nsi/effect_map.v0.json):
源效果(IO) → 模块要求(required_capabilities) → NanoISA 陷阱(TRAP_PRINT)
→ 服务方法(nsi:nanolang/log#write) → 能力(cap:nanolang/log.write)
部署时会生成可审查的部署清单,拒绝无法覆盖已声明效果的授权集合,并报告未使用的授权——多给一把钥匙也会被点名。
所有非确定性都发生在"陷阱边界":时间、熵、文件、网络、用户输入等事件被记入陷阱日志(Trap Journal),记录序列号、能力、方法、参数哈希与结果。回放时直接从日志取回记录结果,不再调用原始服务,日志用 SHA-256 哈希、HMAC-SHA256 认证——这让行为审计与确定性重放成为可能。
部署模式与可信计算基(TCB)
docs/NSI_TCB.md 诚实地列出了每种部署模式下"到底信任谁":
inproc(进程内):信任调用进程自身,无地址空间边界,但认证与能力检查照样执行;mock(模拟):只信任测试进程,用于对着契约验证客户端;local(本地进程):信任父子进程与socketpair传输;畸形帧返回nsi:core/malformed且不分发;远程服务收不到本地能力(nl_fabric_send_cap_remote直接拒绝)。
每次调用前还会执行 nl_nsi_session_hello 兼容性检查:由 src/nsi.c 中的 nl_nsi_compat 判断"按旧契约写的客户端能否调用新实现"——新增方法兼容、删除方法破坏、record 字段不可增删、错误身份与版本令牌必须保留。
一套契约,多语言桩
docs/NSI.md 的生成管线从一份 NSI 文档产出 NanoLang、Nano Forth、Python、Rust、C++ 桩代码、C 派发(按方法 id 而非符号名)、mock、文档以及 NanoISA 的 IMPORT / TRAP cap 描述符——调用方在 src/nsi_runtime.c 中按方法 id 分发,帧均为带 nsi_version 的 JSON,幂等方法可按 request_id 重放。
相关源码与资料索引:
- 运行时与契约解析:src/nsi.c、src/nsi_runtime.c
- 能力表实现:src/nsi_cap.c、src/nsi_cap.h
- 模块契约清单:schema/nsi/inventory.json
- 契约示例:schema/nsi/examples/log.nsi.json
小结
NanoLang 的安全运行时把"权限"从模糊的库调用,变成了三件可验证的事:
- 契约:NSI 文档先声明"能做什么",解析失败关闭;
- 令牌:
NlCap能力不可伪造、可衰减、随代数失效; - 审计:效果映射 + 陷阱日志让每次越界尝试可追溯、可回放。
如果你正在研究如何在实验语言中落地能力安全(capability-based security)与最小权限服务,NanoLang 的 docs/NSI.md、docs/NSI_FABRIC.md 和 docs/NSI_EFFECTS.md 是最值得精读的三份文档。
