安全模型
本页说明 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