Skip to content

v2.7.0

Choose a tag to compare

@github-actions github-actions released this 26 Oct 04:34
· 29 commits to main since this release

ky ui 跨站读取明文漏洞修复(Security)

旧版 ky ui 对所有响应返回 Access-Control-Allow-Origin: *,读明文的 /api/reveal 没有任何鉴权,端口又固定为 8765。
只要 ky ui 开着,本机浏览器里打开的任意网页都能用 JS 请求 127.0.0.1:8765,列出全部条目并逐条读出明文。
绑 127.0.0.1 只挡得住别的机器,挡不住本机浏览器里运行的别家网页。实测:旧版对带 Origin: https://evil.example 的请求返回全部 304 条元信息,text/plain 的 reveal 请求返回 200。

  • 地址改为 http://127.0.0.1:<port>/<每次启动随机 token>/,不带 token 一律 404。
  • Host 只认 127.0.0.1 / localhost(挡 DNS rebinding)。
  • POST 只收 application/json(跨站必须先预检),不再返回任何 CORS 头;加 X-Frame-Options: DENY、Cache-Control: no-store。
  • 台账里的 ref / 备注改为转义后渲染,备注不能再注入脚本。
  • 升级前开过 ky ui 的,建议回想当时是否同时浏览了不可信网页;有疑虑就轮换重要凭据。

ky add:浏览器录入凭据,先验证再写库(Added)

终端粘贴密码容易带进空格、大小写难核对。ky add 打开一次性本地页面,验证通过才加密写入。

  • 三种模式:邮箱授权码 / 应用专用密码、邮箱登录密码、API Key。--email / --provider / --login 预填并直达对应模式。
  • 自动规范化:授权码和 API Key 去掉全部空白、全角空格与零宽字符,大小写原样保留;输入时实时预览长度与末四位,长度不符或混入非 ASCII 字符会提示。登录密码只去首尾空白,中间空格保留。
  • 找旧条目:按账号备注里的邮箱精确匹配(不做子串匹配),可覆盖的条目置顶并默认选中;同账号的其他平台凭据只展示不可选。
  • 验证:邮箱授权码用 IMAP 993 登录验证(代理普遍封 SMTP 端口,993 通常放行;直连失败自动走 HTTPS_PROXY / macOS 系统代理的 CONNECT 隧道);API Key 复用 ky check 的接口验证。invalid、unknown、限流等任何非 valid 结果都不写库。
  • 邮箱登录密码:网页登录有验证码无法在线验证,改为两次输入一致才保存,有大写锁定提示。一个邮箱只保留一条登录密码:新的覆盖旧的,同邮箱其他重复的登录密码条目在保存时一并删除(确认框会列出),删除写审计。
  • 两类邮箱密码互不覆盖:授权码不能写进登录密码条目,反之亦然;也不能把 A 邮箱的密码写到 B 邮箱的条目。
  • 一次性服务:随机 token、Host 校验、只收 JSON POST、无 CORS 头、没有任何读明文接口;点「完成」或空闲 15 分钟自动退出。
  • 写入后记录 check / set 审计,并把验证结果写入 health.json(登录密码不写,因为没有在线验证)。

ky check email <名字>:复验邮箱授权码(Added)

  • 对库里已存的邮箱授权码 / 应用专用密码做 IMAP 登录验证,邮箱地址取条目账号备注里的地址;状态与退出码同 ky check。
  • 支持 Gmail、163 / 126 / yeah.net、QQ / Foxmail、iCloud,其他域名按 imap.<域名>:993 尝试;Outlook 已关闭 IMAP 基本认证,明确报不支持。
  • 新增直接依赖 rustls / webpki-roots,与 ureq 共用同一份 ring 实现,不引入第二套 TLS。

服务器 Agent 协作:OpenSSH forced-command broker(Experimental)

目标:服务器 Agent 只取当前任务获准的凭据,不拿整库 master key,也不需要把主密码复制到每台机器。

  • ky agent init + ky broker admit:服务器侧只生成自己的 key 并打印一张 kyticket-…(不含任何凭据);vault host 侧一条命令验票、按设备 ID 回查 cs 台账、登记精确授权、把 forced-command 行写进 authorized_keys(写前备份、同设备不重复追加)。重复 admit = 续期/改授权,不报错也不堆行。两台机器各一条命令即可接入。
  • ky broker adopt <host-id>:设备身份不再手填,直接从 CortexOS 舰队台账(registry/fleet-hosts.json)读 id / public_ip / agent_id;kyvault 只补公钥指纹与逐条凭据授权。台账缺 IP 时拒绝领养(不退化成任意来源);同一公网 IP 上的其他主机只提示不合并身份(实际台账里 gigi 与 xiaomei 同 IP,按 IP 授权等于按机器授权)。决策记录见 docs/decisions/2026-10-22-broker-ownership.md。
  • ky broker register|list|status|revoke|authorized-key:本地管理员审批设备 SSH 公钥、来源 IP/CIDR、精确 ref 与有效期,生成带 restrict,from=...,command=... 的 authorized_keys 行供人工审阅安装。
  • ky broker serve:只能作为 sshd fixed command 运行;从 SSH_CONNECTION 取实际对端 IP,校验设备状态、CIDR、精确 ref、期限与撤销。
  • 精确到叶子:拒绝 secret://server/<host> 这类聚合 ref,避免一次授权读出该主机全部字段;也拒绝 cli 聚合。
  • ky broker probe|run --expect-device:Agent 用自己的 SSH 私钥连接,强制校验 host key、禁用密码/转发/ControlMaster,并核对返回设备 ID;run 把值注入本机子进程。
  • 强制审计:allow/deny、请求 ID、设备、来源 IP、ref 列表写入 broker-audit.jsonl;审计写失败则拒绝释放凭据。审计不含明文、密文、last4 或客户端原文。

边界(务必如实对待):principal/--as 是人工标签;真实身份是安装到 forced command 的 SSH key。IP 是 sshd 看到的对端地址,跳板/NAT 后是跳板出口。撤销只阻止后续请求,已取走的静态值不能追回;本地审计不防同机管理员篡改。部署必须使用专用低权限 SSH 账户并锁定 sshd 配置,程序不会自动修改你的 SSH 设置。Mac/Windows 主设备签名审批、一次性 enrollment 与自动轮换尚未实现。

凭据有效性与重复监察(Added)

  • ky check 现在区分 valid / invalid / permission_limited / rate_limited / unknown / api_error / unsupported,把状态、HTTP 分类、检查时间与耗时写入 health.json(0600,不含值/文案/last4)。429 与 403 不再被当作“已认证”;退出码改为 0 通过/限流、1 认证失败、2 未知,不再建议任何非零即轮换。
  • ky inspect:离线只读盘点平台/类型/账户、profile 关联、孤儿引用、同 URI 多存储位置、时间字段异常与历史健康状态;默认不读 master key。
  • ky inspect --duplicates:显式解密后用一次性随机 HMAC 在内存中分组,只输出重复 ref 列表,不输出明文、尾号或指纹。
  • ky panel 增加设备与历史健康段,并明确这些仍是敏感元信息,noindex 不是访问控制。

安全模型更正:旧 Auth Guard 不验证 SSH 私钥

此前文档把 Auth Guard 描述成「SSH 公钥绑定保护 master.key」「本机凭 SSH Key 零交互解锁」。代码复核发现:旧实现实际从公开 .pub 文件派生 AES key,只检查指纹,不会请求私钥签名;TOTP 校验函数也没有被任何敏感命令调用。拿到 auth.json、master.key.enc 与公钥即可重算解密 key。旧实现不构成私钥保护、多因素认证或 Agent 身份认证。

  • 旧 Auth Guard 的 setup / add 现在默认拒绝新建或扩展;仅为旧格式迁移兼容时可显式设 KYVAULT_ALLOW_INSECURE_LEGACY_AUTH=1。已有数据仍可读、导出或关闭,后续需提供到安全 key wrapping 的迁移工具。
  • 新协作模型区分 Local、Git Sync、Broker。按 ref 的 Agent Grant、设备身份、服务端审计与 IP 附加策略见 docs/proposals/2026-10-22-human-agent-collaboration.md。
  • 安全表述的更正已落实到代码与文档;broker 已实现在上一节(实验性),旧 auth 文件到安全 key wrapping 的迁移/替换流程仍需单独设计。

操作审计:谁读过、谁改过(Added)

此前只有 meta.json 里的 updated_at —— 时间有,人不明;而 get 是唯一会输出
明文的命令,读行为却完全不留痕。泄露之后连「有没有人读过」都答不上来。

  • ky audit:本地 audit.log(JSONL,0600)记录 get / set / delete / annotate / run / import / pull / push / sync / init / profile 的时间、actor、
    目标 ref、结果。不记明文、不记密文、不记 last4 —— 审计日志本身若成了泄漏面,
    就抵消了加它的意义。
  • actor 来源:--as <name> → KY_ACTOR → 库内 git user.name → $USER。
  • 团队维度:gitlab push 的提交信息从固定模板改为
    chore(secrets): sync by <actor> at <ts>;库的 git 身份也从写死的 kyvault
    改为真实操作者。以前所有人看起来都是同一个「kyvault」,等于没有作者信息。
  • 默认不入仓:audit.log 含读事件,push 到团队仓就变成监视而不是审计。
    需要共享时设 KY_AUDIT_SYNC=1;KY_AUDIT=0 可整体关闭。

多账户体系:一个 profile = 一个账号(Added)

account / key / cli / server / identity 五套平行命令都回答不了那句最常见的问话:
「我有几个 GitHub 账号,每个挂了几条东西,现在用的是哪个?」

  • ky profile add|list|show|use|current|link|unlink|remove,落 accounts.json
    (结构性元信息,入仓共享;权限 0600,因为写着别人的登录名)。
  • ky run --profile <name>:把该账号名下所有 ref 一次注入子进程,变量名 =
    ref 名大写化(secret://github/pat → PAT)。这是「一把钥匙开一批锁」的用法。

只读托管面板(Added)

  • ky panel --out panel.html:自包含静态 HTML,含账号、条目、操作计数与最近
    审计。不含明文、密文、last4,带 noindex,可直接扔到 GitHub Pages / 对象存储。
  • 刻意不提供「把 ky ui 挂公网」:ui 可写、能看明文,必须只在本机访问。
    (只绑 127.0.0.1 不够,见本节顶部的 ky ui 漏洞修复。)

复用本机 glab 登录态(Added)

以前只认 KY_GITLAB_TOKEN,没有就「不代你建仓库」—— 而凭证就在旁边的
glab-cli/config.yml 里躺着。

  • 凭证优先级:KY_GITLAB_TOKEN → glab 配置文件 → glab auth status --show-token。
  • ky gitlab auth:只读探测,打印将使用哪个 host、凭证来自哪里、token 脱敏摘要。
  • 建私有库:ky init --remote 在 glab 已登录时直接建项目(visibility=private)
    并首推;token 走环境变量交给一次性 credential helper,不落 argv。
  • API 通道:优先 glab api(token 不进 ps);没有 glab 才回落 curl,且
    header 走 --config - 从 stdin 读。

可发现性:让项目能被找到(Added)

起因是一次真实的困惑:在 GitHub 搜「token管理」「秘钥管理」,搜不到这个工具。
查下来发现项目一直被收录着,是描述和 topics 里根本没有这些词 ——
GitHub 默认搜索索引的是 name + description + topics,README 不参与。
实测:同一句话放在 README 里,in:readme 有 710 条结果,默认查询只有 1 条。

可发现性 (Added)

  • 发布到 crates.io:cargo install kyvault 现在可用(crate 名 kyvault,
    ky 仍是 install.sh 建的符号链接 —— crates.io 上 ky 这个名字已被别的包占用)。
    已实测从 crates.io 真实安装并运行成功。
  • 公开站点:https://<owner>.github.io/kyvault/,带 SEO meta、FAQ 结构化数据
    (SoftwareApplication + FAQPage)、明暗双主题与对比度达标的配色。
    homepage 字段已从「指向自己」改为指向它。
  • 仓库描述改为中英双语,覆盖实际检索词:密钥管理 / 秘钥管理 / 令牌管理 /
    Secret Manager / Secret Management / API Key Manager / Token Manager /
    Credentials / dotenv alternative。
  • topics 重排为 20 个:去掉已停用的 d1(v2.3.0 起 GitLab 后端替代 D1),
    补齐 secret-manager / secrets-management / token-management /
    token-manager / api-key-manager / local-first 等类目词。
    竞品 Infisical / dotenvx / sops 的共同做法是四种形态全收。
  • 徽章:新增 crates.io 版本徽章与 CI 状态徽章;修正了原本指向
    #-安装 / #-install 的失效锚点(实际标题是「30 秒上手 / 30-second start」)。
  • Homebrew 公式与 winget 清单已备好并校验(winget 三份清单通过微软官方
    JSON schema 校验;Homebrew 的 sha256 从真实 release 产物算出,未留占位)。

表述收紧 (Changed)

README 与站点此前把「AI 永远看不到明文」「全程零网络」当作承诺,这两条都不成立:
ky get 会输出明文,GitLab 密文同步与 D1 后端会联网。
现改为按实际行为描述 —— ky run 注入时明文不进模型上下文,但 ky get 与子进程输出仍会暴露。
同时删掉与实现不符的「静态二进制」(Linux GNU 目标依赖系统库),
以及误挂的 Python 生态徽章(Built with uv / code style Black)。

实测效果

搜索排名(同查询、按仓库 id 匹配,改前 → 改后):
秘钥管理 不存在 → #1 · dotenv alternative 不存在 → #1 · 令牌管理 不存在 → #4 ·
API密钥管理 不存在 → #5 · 密钥管理 #10 → #6 · token管理 不存在 → #12。