安全模型

本页说明 Rempar 保护什么、如何保护,以及不保护什么。参考文档是 v1 协议,其中的字符串已固定不变。

目标

即使服务器、其备份及其管理员被完全攻破,也不得泄露任何机密:不泄露主密码,不泄露内容,甚至不泄露任何条目的名称。

密钥派生(仅在设备上)

password     = NFKC(saisie)
master_key   = Argon2id(password, kdf_salt, m=65536 KiB, t=3, p=4, 32 octets)
auth_key     = HKDF-SHA256(master_key, info="rempart/auth/v1")
wrap_key     = HKDF-SHA256(master_key, info="rempart/wrap/v1")
  • kdf_salt:16 个随机字节,在创建账户或本地保险库时生成。
  • auth_key 作为账户密码发送到服务器。无法从它派生出任何其他内容。
  • wrap_key 从不离开设备。它用于密封保险库密钥。
  • 即使服务器提出,客户端也会拒绝弱于 m=19456、t=2、p=1 的 Argon2id 参数。

密封格式

seal(key, plaintext, aad) = base64( 0x01 || nonce(24) || XChaCha20-Poly1305(key, nonce, plaintext, aad) )

每种用途都有固定的 AAD 字符串:rempart/vaultkey/v1、rempart/itemkey/v1|<item_id>、rempart/item/v1|<item_id>、rempart/export/v1 等。数据块无法在其他上下文中重放,也无法附加到其他条目上。

保险库和条目

  • vault_key:32 个随机字节,每个保险库生成一次。
  • 每个条目都有自己的 32 字节 item_key。存储的数据块为 { k: seal(vault_key, item_key), c: seal(item_key, contenu) }。
  • 列表从本地密封索引显示。打开一个条目只会解密该条目。
  • 条目标识符是 UUID v4,并绑定在两个 AAD 中。

恢复套件

32 个随机字节,以 Crockford base32 格式只显示一次。recovery_wrap = HKDF(recovery_key, "rempart/recovery-wrap/v1") 密封保险库密钥的一份副本;recovery_auth = HKDF(recovery_key, "rempart/recovery-auth/v1") 用于向服务器验证恢复操作。

账户和令牌

  • 防枚举的预登录:对于未知的电子邮件地址,返回一个确定性的虚假盐值。
  • 每台设备一个访问令牌(60 分钟),以及轮换使用的刷新令牌(30 天)。已刷新的令牌被再次使用时,该设备会被撤销(token_reused)。
  • TOTP 双重验证为可选项,建议启用。管理员必须启用。
  • 所有敏感路由均有速率限制。

设备端

  • 机密以 12 个固定圆点遮盖,30 秒后重新隐藏。
  • 剪贴板在 30 秒后清空(可在 10 秒到 2 分钟之间调整)。助记词从不整体复制。
  • 闲置 5 分钟、进入睡眠和关闭时锁定;保险库密钥在内存中被清零。
  • 失败后逐步延长等待时间:30 秒、1 分钟、5 分钟。绝不静默清除数据。
  • Android:FLAG_SECURE 禁止截屏。iOS 和 macOS:在应用切换器中显示隐私遮罩。
  • 生物识别:保险库密钥交由受 Touch ID、Face ID 或指纹保护的系统钥匙串保管,从不存入文件。

本模型不涵盖的内容

  • 保险库处于打开状态时设备已被入侵(间谍软件、键盘记录器)。
  • 弱主密码:Argon2id 会减缓攻击,但无法使其不可能。
  • 同时丢失主密码和恢复套件。
  • 账户元数据:电子邮件地址、条目数量、数据块大小、设备的日期和平台。

报告漏洞

请发送邮件至 security@rempar.org。我们会在 48 小时内确认收到,并在任何披露之前发布修复。


这里没有找到答案? support@rempar.org