Skip to content

共享与设备丢失处理(2026-11-16,新加坡时间) ​

设计与实施顺序 ​

沿用现有 RustCrypto 密钥包裹与 SyncTransport,共享库与个人库分开。共享库使用固定 owner 的签名成员链、逐设备签名操作链、每次成员变化的新纪元和加密基线;本地固定 owner 指纹和最高已见哈希,拒绝成员伪造、分叉与回滚。角色为 owner/editor/viewer。邀请绑定接收者自己的账户公钥,个人账户包永不上传到共享位置。

  1. 共享协议、角色验证、邀请、退出与轮换,核心回归测试。
  2. 通过现有 Folder/Git/S3/WebDAV 传输同步共享密文,多账户模拟。
  3. 设备丢失的完整账户换钥、各库迁移、恢复包与应急套件更新。
  4. 服务、CLI、daemon 和桌面设置/条目菜单接线;最终运行 workspace 与前端检查。

选择独立共享协议而不扩展个人库旧成员日志:个人库现有信任根是同一个账户恢复包,多成员若沿用它会扩大个人密钥暴露范围。共享角色和成员链必须独立验证。无可信服务器时不能保证全球同步即时撤销;离线写入在纪元变化后不能自动混入新纪元。

开源参考 ​

  • rage/age(MIT/Apache-2.0):多收件人分别包裹文件密钥的模式;保留项目现有 X25519 包裹函数,不复制代码。
  • curve25519-dalek(BSD-3-Clause):X25519 密钥与 Ed25519 身份分离;使用现有 crate 的签名和验证 API。
  • hpke-rs(MIT/Apache-2.0):了解 RFC 9180 API 与算法套件边界。当前项目的 wrap_epoch_key 是 X25519 + HKDF + XChaCha20-Poly1305 的既有 ECIES 封装,不能声称符合 RFC 9180 HPKE;本次不另创原语或更改个人库密码学。

Contract changes ​

新增共享库独立格式与 service/IPC/CLI 入口,后续各提交在此补充;不修改协调者拥有的 docs/plan.md。

需要用户本人 ​

开发与验收全部使用合成数据、临时 home、模拟审批和文件恢复存储。真实设备生物识别、钥匙串授权、签名证书和共享成员当面核对指纹留待用户在场,开发中不触发。

已实现接口与运行 ​

  • passno-vault::sharing:共享库、公钥身份、固定 owner 的纪元链、owner/editor/viewer、收件人绑定邀请、退出请求、成员移除和身份替换。
  • passno-sync::sharing:全部既有 SyncTransport 适配器都复用;只同步 shared/<id>/…,不带个人账户包。拉取先隔离校验完整签名/哈希链,验证成功后安装并上传。存放位置及访问凭据通过随机密钥加密,再用账户 X25519 包裹。
  • passno-sync::revocation:隔离生成新账户,迁移个人库、附件、agent 子库和自己管理的共享库;更新恢复包、生成新应急套件,原子目录切换配合可恢复日志。旧服务令牌不迁移,活动生物识别材料随旧 local 目录移出。
  • LocalPassnoService::sharing_command / RequestBody::Sharing / Tauri sharing_command:只返回元数据。IPC 失败不自动重放共享写操作。主密码与云存储凭据属于只写输入,Debug 始终隐藏输入。MCP 仍是原有最小权限工具,不赋予共享管理权限。
  • pn share identity|ls|create|members|items|copy|import|invite|accept|configure|sync|remove|role|leave;pn device revoke-lost|resume-revocation。全部支持全局 --json,帮助含例子和退出码。默认 daemon;--no-daemon --password-stdin 用于隔离维护。

两个独立临时账户 ​

先分别在 /tmp/passno-sharing-a、/tmp/passno-sharing-b 初始化合成库,所有 CLI 命令显式设置 PASSNO_HOME。可用 --no-daemon --password-stdin 从标准输入注入合成主密码,或者用模拟 daemon 保持解锁会话。

  1. B:pn share identity --json > /tmp/recipient.json(只有公钥)。
  2. A:pn share create Family --json,记录 ID;pn share configure <id> --folder /tmp/passno-family --json。
  3. A:pn share copy <id> <personal-item-id> --json。
  4. A:pn share invite <id> --identity-file /tmp/recipient.json --fingerprint <B-fingerprint> --role viewer --json > /tmp/invite.json;pn share sync <id> --json。
  5. B:独立核对 A 的指纹,pn share accept --code-file /tmp/invite.json --fingerprint <A-fingerprint> --folder /tmp/passno-family --json。
  6. B:共享条目直接出现在 pn list / App 列表和浏览器插件下拉框里(编号形如 shared:<库>:<条目>),不用复制。pn share import <id> <shared-item-id> 仍可把一份副本放进个人库,副本不再跟随共享库更新。
  7. A:pn share remove <id> <member-id> --confirm --json 返回待更改密码清单,随后同步;B 同步后共享访问拒绝。

邀请不含秘密,可复制编码或作为二维码内容。重复接受被拒绝;同一身份在重新登记的可信设备上接受不扩大成员权限,不把这一点包装成全局 bearer token 一次性服务。

设备丢失(全部模拟) ​

配置 PASSNO_RECOVERY_TEST_DIR=/tmp/passno-sharing-recovery,只对临时 home 使用加密文件版恢复存储。先按已有设备加入流程生成第二台合成设备,然后:

sh
pn device revoke-lost <lost-device-id> --new-password-file /tmp/new-synthetic-master --confirm --json
# 若故障中断切换:
pn device resume-revocation --json
# 用新密码解锁,随后同步个人库及每个共享库。

输出不含 Secret Key;报告在 $PASSNO_HOME/revocation-report.json,应急套件路径单独返回。旧账户备份是密文,仍可能包含已暴露的旧密码,不能承诺远程擦除。共享 owner 离线时的退出仅是请求,owner 下次同步才换钥。对非 owner 的共享库不越权:其 owner 必须移除旧身份后重新邀请。

验证与边界 ​

cargo test -p passno-sync --test sharing 覆盖独立 home 的两个成员、一处 Folder 存放位置、角色升级/降级、viewer 写入拒绝、伪造 owner 成员日志、viewer 自签操作、邀请错误指纹/重放、成员移除后的旧密钥解密失败、本地和远端回滚、退出请求,以及双设备账户换钥、附件读取、agent 旧令牌失效、恢复包/应急套件一致性。

当前共享条目以完整条目操作结合既有 HLC 合并;桌面共享清单只展示标题,不通过共享 RPC 返回密码。跨库附件引用明确拒绝(不能把个人 blob ID 误当成共享附件)。共享附件和其他 owner 的在线换钥协作需后续集成;这些边界在错误与说明中明确呈现。

共享条目直接使用(2026-11-16) ​

共享库里的条目和个人条目一样用,不需要复制到个人库:

  • list_items 在个人条目之后附上各共享库的条目,同样走筛选和搜索;vault 字段是共享库名,编号是 shared:<库 id>:<条目 id>(passno-service::shared_items)。
  • get_item、reveal_field、totp、browser_fill 遇到这种编号就打开对应共享库读取(每次都校验签名成员链);浏览器插件经 list_items + browser_fill 找账号和填充,所以共享账号同样会出现在下拉框里,网址规则照常检查。
  • update_item、delete_item、收藏、归档写回共享库,由 SharedVault::put 按角色检查:只读成员一律拒绝。改密码时旧密码进共享条目的历史。
  • 离开或被移除的共享库不再出现在列表里。agent 接口仍只看个人库里按策略允许的条目,共享条目不会暴露给 agent。
  • 测试:crates/passno-service/tests/shared_items.rs(两个临时账户、一个文件夹存放位置:列出、搜索、取密码、按网址填充、钓鱼网址拒绝、只读成员不能改、升为编辑者后修改同步回所有者、旧密码进历史)。

文档对应提交 56d1c45 · 由仓库 docs/ 自动生成