E2EAuth

你的密钥。你的设备。全面保护。

• HTML 镜像：https://roxanneardary.com/e2eauth-specification/

---

概述

E2EAuth 是一个开源、跨平台的身份验证器规范，旨在为桌面和移动设备提供安全、私密且可靠的多因素身份验证凭据管理。它支持基于时间的一次性密码（TOTP）和基于 HMAC 的一次性密码（HOTP），并具备端到端加密同步、本地优先存储以及通过可信联系人进行社交恢复的功能。

E2EAuth 围绕用户所有权、零知识架构、互操作性、透明的安全实践以及摆脱供应商锁定而设计。身份验证密钥始终处于用户控制之下，同步或恢复服务不得独立访问用户的凭据保险库。

核心原则

• 安全优先： 在存储、同步、恢复和使用过程中保护身份验证密钥。
• 端到端加密： 确保只有经过授权的用户设备才能解密凭据保险库。
• 本地优先运行： 允许用户在没有互联网连接的情况下生成身份验证码。
• 用户所有权： 让用户掌控凭据、设备、加密密钥、备份和恢复安排。
• 跨平台兼容性： 支持在桌面和移动环境中进行安全访问。
• 零知识架构： 防止服务器、服务运营商和恢复联系人独立读取保险库内容。
• 开源透明： 支持对规范、实现、安全控制和变更进行公开审查。
• 互操作性： 支持既有的身份验证标准和可移植的凭据迁移。
• 弹性恢复： 提供安全的恢复选项，同时不引入未经授权的访问或集中式恢复后门。
• 可审计操作： 维护与安全相关操作的透明记录，同时避免不必要地暴露身份验证密钥。

---

核心模块

身份验证凭据管理

• 支持符合 RFC 6238 的 TOTP 凭据。
• 支持符合 RFC 4226 的 HOTP 凭据。
• 允许用户通过扫描兼容的二维码添加凭据。
• 支持手动输入颁发者名称、账户标识符、共享密钥、算法、位数及其他必需参数。
• 验证导入的凭据参数并识别不支持的配置。
• 使用适当的算法和凭据参数在本地生成身份验证码。
• 为基于时间的验证码显示倒计时指示器。
• 跟踪 HOTP 计数器状态，并在授权设备之间安全地同步计数器更新。
• 支持凭据名称、颁发者信息、账户标签、图标、类别、标签和备注。
• 提供搜索、排序、筛选和收藏功能。
• 清晰显示验证码过期和重新生成状态。
• 支持安全复制身份验证码，并可配置剪贴板清除行为。
• 尽量减少密钥和验证码在应用程序日志、通知、崩溃报告和诊断输出中的暴露。
• 清晰标识无效、已过期、不受支持或可能冲突的凭据。
• 在设备离线时保持凭据功能正常。

安全保险库与本地存储

• 将身份验证凭据存储在受保护的本地保险库中。
• 对静态存储的敏感凭据数据进行加密。
• 将保险库加密密钥与存储的凭据数据分离。
• 在可用时使用安全的平台设施来保护设备特定的密钥材料。
• 支持用户控制的保险库解锁机制。
• 在使用密码的场景下支持基于强密码的密钥派生。
• 通过受支持的操作系统安全设施提供可选的生物识别解锁。
• 在无活动或应用进入后台后应用可配置的自动锁定。
• 根据用户定义的安全策略，对敏感操作要求重新进行身份验证。
• 防止通过应用预览、受支持时的截图、剪贴板历史记录和通知内容造成意外泄露。
• 提供安全的保险库锁定和会话终止功能。
• 避免在日志、临时文件或未受保护的备份中存储明文身份验证密钥。
• 说明设备级保护的局限性以及操作系统被攻破的风险。

端到端加密与密钥管理

• 在保险库内容离开源设备之前对其进行加密。
• 确保同步提供方无法独立解密凭据数据。
• 使用经过独立审查的成熟加密算法和协议。
• 定义认证加密、安全密钥派生、nonce 处理和密钥轮换要求。
• 建立经过身份验证的设备身份以及用于设备配对的密钥交换机制。
• 防止未经授权的设备加入用户的同步网络。
• 保护同步数据免受篡改、重放和未经授权的修改。
• 将加密记录绑定到适当的上下文元数据，以防止保险库或记录之间发生意外替换。
• 分离身份验证、加密、设备身份和恢复职责。
• 防止密码、加密密钥、恢复份额和身份验证密钥出现在遥测或诊断输出中。
• 支持撤销设备访问权限并轮换相关加密密钥。
• 明确说明先前已授权或已被攻破的设备可能保留其已解密的信息。
• 记录加密假设、威胁模型、密钥生命周期和恢复限制。

跨设备同步

• 在已授权的桌面设备和移动设备之间同步凭据。
• 支持通过点对点连接、加密云服务或用户自运营的基础设施进行同步。
• 无论选择何种同步方式，都保持端到端加密。
• 允许用户选择、更改或禁用同步提供方。
• 支持经用户明确授权的安全设备配对。
• 显示已配对设备、设备标识符、最近同步状态和相关安全信息。
• 就新设备注册和重大同步安全事件通知用户。
• 支持在临时断开连接或长时间离线运行后的同步恢复。
• 检测冲突的更改并提供安全的解决机制。
• 在同步过程中保留凭据元数据和配置。
• 谨慎处理 HOTP 计数器更新，以减少重复验证码、计数器回滚以及设备间状态不一致。
• 防止过期或重放的同步数据静默覆盖较新的安全相关状态。
• 允许用户撤销丢失、被盗或不再受信任的设备。
• 确保设备撤销能够阻止未来的授权同步以及对新受保护保险库数据的访问。
• 说明撤销无法从不再受用户控制的设备上删除先前已下载的信息。

社交恢复与可信联系人

• 为丢失保险库访问权限或所有先前授权设备的用户提供可选的社会恢复系统。
• 允许用户指定可信的恢复联系人。
• 使用经过验证和审查的阈值秘密共享方案来分发恢复材料。
• 允许用户配置完成恢复所需的最低恢复份额数量。
• 确保恢复联系人仅收到其指定的恢复份额，而非用户身份验证凭据的副本。
• 防止任何个人联系人、服务器或服务运营者在未达到配置阈值时独立重建保险库密钥。
• 要求经过身份验证的恢复请求以及所需数量授权联系人的明确参与。
• 清楚说明恢复阈值、联系人职责以及丢失恢复份额的后果。
• 将恢复请求和批准绑定到预期的保险库、恢复会话和当前恢复配置。
• 防止重放的批准、重复的份额、未经授权的恢复尝试以及恢复会话的替换。
• 在安全通信可用的情况下，通知用户和相关恢复参与者有关恢复请求和已完成的恢复操作。
• 支持通过经过身份验证的管理流程添加、移除或替换恢复联系人。
• 在恢复配置变更时支持恢复份额轮换。
• 说明移除联系人无法擦除该联系人已复制的恢复份额。
• 要求适当的恢复后密钥轮换、会话审查和设备重新授权。
• 允许用户禁用社会恢复并选择替代恢复方法。
• 当配置的恢复阈值无法满足或恢复材料可能不足时提供警告。
• 绝不引入集中式恢复后门或允许恢复服务绕过用户配置的阈值。
• 清楚传达如果所有授权设备和足够的恢复材料均丢失，可能发生永久性保险库丢失。

加密备份与恢复

• 支持创建凭据保险库的加密备份。
• 确保备份独立于存储位置保持加密。
• 允许用户将备份导出到本地存储或用户选择的目标位置。
• 支持通过经过身份验证的流程恢复到新设备。
• 在恢复数据之前验证备份完整性和兼容性。
• 防止损坏、不完整或被篡改的备份文件。
• 清楚标识备份创建日期和相关格式版本。
• 在可行的情况下支持备份版本控制。
• 允许用户在不暴露保险库内容的情况下验证备份可用性。
• 提供安全存储备份文件和恢复材料的指导。
• 防止备份在未经适当确认的情况下静默替换较新的保险库。
• 记录每种备份格式中包含哪些设置、元数据、设备关联和恢复配置。
• 当备份在没有额外凭据或恢复材料的情况下无法恢复时警告用户。

设备管理与访问控制

• 维护与每个保险库关联的授权设备列表。
• 在添加新设备之前要求明确授权。
• 支持设备命名和标识。
• 在可用的情况下显示设备注册和最后出现信息。
• 允许用户撤销设备访问权限。
• 支持会话终止和重新身份验证。
• 在可能的情况下通知用户有关安全敏感的注册、撤销和恢复事件。
• 保护设备管理操作免受未经授权的更改。
• 在破坏性或安全敏感操作之前要求适当的确认。
• 支持设备更换或操作系统重装后的重新注册。
• 说明从同步中移除设备与从该设备安全擦除数据之间的区别。
• 提供应对丢失或被盗设备的明确流程。

安全、隐私与威胁防护

• 定义并维护有文档记录的威胁模型。
• 防范未经授权的保险库访问、数据窃取、同步篡改、恢复滥用和凭据泄露。
• 对加密、锁定、设备注册和恢复使用安全默认值。
• 对身份验证和恢复操作实施速率限制和适当的滥用防护。
• 验证导入的数据，并安全地拒绝格式错误或不支持的凭据记录。
• 尽量减少个人信息的收集和保留。
• 当分析数据和遥测数据对安全性或功能并非必需时，默认将其禁用。
• 绝不为了分析、广告或不相关的处理而传输身份验证机密或明文保险库内容。
• 避免使用广告标识符、不必要的跟踪以及未披露的第三方数据共享。
• 提供隐私声明，说明所有收集的信息及其用途。
• 支持独立安全审查和负责任的漏洞披露。
• 为加密边界、访问控制、同步和恢复行为包含自动化测试。
• 记录已知限制、安全假设和事件响应程序。
• 避免声称仅靠加密就能防范恶意软件、受感染的设备、胁迫或对已解锁应用的物理访问。

导入、导出与迁移

• 在可行的情况下，支持从成熟的验证器导出格式导入兼容的 TOTP 和 HOTP 凭据。
• 当源应用提供兼容格式时，支持基于二维码的迁移。
• 验证导入的记录，并报告无法转移的凭据。
• 保留签发方名称、账户标识符、算法、位数以及其他支持的参数。
• 为敏感凭据数据提供加密导出选项。
• 在生成明文导出或显示敏感迁移二维码之前，明确警告用户。
• 在导出或迁移凭据之前要求适当的授权。
• 避免通过不受信任的中间方发送迁移数据。
• 在可能的情况下支持有文档记录、带版本号的迁移格式。
• 允许用户迁移离开 E2EAuth，而无需持续访问专有服务。
• 为临时导出文件和迁移会话提供安全处理指南。
• 确保导入不会在未经用户明确确认的情况下静默覆盖现有凭据。

用户界面与无障碍性

• 提供清晰的界面，用于查看和使用身份验证码。
• 按签发方、账户、类别、收藏和搜索结果组织凭据。
• 在受支持的平台上提供无障碍的导航和控件。
• 支持屏幕阅读器、键盘导航、可缩放文本和适当的对比度。
• 清晰地传达验证码过期、同步状态、设备信任和恢复状态。
• 区分常规状态消息与安全警告和恢复确认。
• 提供对安全设置易于理解的解释，而无需专业的密码学知识。
• 提供可配置的外观和无障碍偏好设置。
• 避免不必要地显示敏感信息。
• 对不可逆操作（如凭据删除、恢复重新配置和破坏性还原）要求明确确认。
• 提供有用的错误消息，且不泄露机密或内部安全敏感细节。

可审计性与安全事件历史

• 维护一份注重隐私的重要安全事件历史记录。
• 记录相关事件，例如设备注册、撤销、恢复配置变更、备份还原以及安全敏感设置变更。
• 避免记录身份验证密钥、生成的验证码、密码、恢复份额或解密后的保管库内容。
• 在可行的情况下，保护事件记录免遭未经授权的修改。
• 明确区分本地记录的事件与通过同步接收到的事件。
• 在可用的情况下保留时间戳和事件上下文。
• 允许用户查看相关安全活动。
• 支持安全导出事件历史记录，且不暴露凭据材料。
• 记录设备离线、受损或无法上报事件时的局限性。
• 绝不将不完整的本地日志呈现为所有设备上全部活动的完整记录。

---

可选插件模块

浏览器集成插件

• 为受支持的身份验证工作流提供可选的基于浏览器的访问方式。
• 在浏览器集成能够访问凭据数据之前，要求获得明确授权。
• 将访问限制在请求操作所需的最少信息范围内。
• 避免将整个保管库暴露给网页或无关的浏览器扩展。
• 提供清晰的来源验证和针对钓鱼的防护措施。
• 保持浏览器集成可选，并可独立禁用。
• 绝不自动将身份验证码提交至不受信任的目标。

命令行界面插件

• 为经批准的保管库操作提供命令行访问方式。
• 要求安全身份验证和适当的授权。
• 避免通过命令历史记录、进程参数、终端日志或 shell 输出暴露机密信息。
• 支持针对非敏感管理任务的脚本编写。
• 在显示或导出身份验证码之前，要求采取明确的防护措施。
• 遵循与主应用程序相同的访问控制和安全策略。

硬件安全插件

• 在可用的情况下支持兼容的硬件支持的密钥保护。
• 允许与受支持的平台安全模块或外部安全设备集成。
• 保护受支持的密钥操作，避免其不必要地暴露于应用程序内存。
• 明确标识哪些操作受硬件保护，哪些不受保护。
• 在受支持的硬件不可用时提供优雅的降级行为。
• 避免声称硬件支持的保护能够防止一切形式的设备受损。

自托管同步插件

• 允许用户运营自己的同步基础设施。
• 保持端到端加密和客户端授权。
• 支持经过身份验证的连接和完整性受保护的同步。
• 为自托管部署提供配置和运维指导。
• 防止服务器管理员独立解密用户保管库。
• 允许在同步提供商之间迁移，而无需重新输入凭据。
• 记录自托管服务的可用性、备份和运维安全责任。

附加恢复插件

• 允许集成替代恢复机制，例如离线恢复工具包或用户控制的恢复密钥。
• 保持恢复机制独立于常规身份验证操作。
• 要求用户明确设置，并清晰说明恢复的后果。
• 在所选机制允许的情况下，支持恢复材料的轮换和撤销。
• 防止插件绕过核心恢复阈值或加密要求。
• 清晰记录每种恢复方法的安全假设和局限性。

策略与管理插件

• 为受管或组织部署提供可选的策略控制。
• 支持对设备注册、保险库锁定、同步和恢复的可配置要求。
• 让管理策略对受影响的用户保持透明。
• 防止管理员在用户不知情的情况下访问明文凭据。
• 提供可审计的策略变更和明确的授权边界。
• 保护用户隐私，避免为合规报告收集身份验证机密。

---

测试与验证

• 针对既定的参考向量测试 TOTP 和 HOTP 行为。
• 验证加密、解密、密钥派生和身份验证行为。
• 测试安全的设备注册、同步和设备吊销。
• 测试社交恢复阈值、缺失份额、无效批准、重放尝试和恢复份额轮换。
• 测试备份创建、恢复、完整性验证和兼容性。
• 测试跨受支持凭据格式的导入和导出。
• 验证日志、崩溃报告和诊断输出不会泄露敏感数据。
• 测试离线运行、同步中断和并发凭据更新。
• 执行以安全为重点的代码审查和独立的密码学审查。
• 为已发现的漏洞维护回归测试。
• 记录测试覆盖率、未解决的安全问题和已知的实现限制。

---

规范品牌许可（SBL）

标准

• 完全符合 AGPL-3.0+ 的系统
• 对网络部署强制执行 Copyleft
• 必需的署名：
  • Roxanne Ardary
  • https://www.roxanneardary.com/

可选

• 规范品牌许可（SBL）
  • 免署名的商业部署
  • 定价基于规模、使用量和部署范围
  • https://roxanneardary.com/e2eauth/

---

许可与声明要求

E2EAuth 依据 GNU Affero 通用公共许可证第 3.0 版或更高版本（AGPL-3.0+） 发布。
通过向任何 Open Arsenal 项目做出贡献，您同意您的贡献也将依据本许可证发布。

请注意以下事项：

• 所有贡献必须遵守 AGPL-3.0+ 条款。
• 根据许可证的 第 7 条，所有再分发、分支和衍生作品必须保留对以下对象的署名：
  Roxanne Ardary 和 roxanneardary.com。
• E2EAuth 规范可免费使用，但需署名。可根据请求协商规范品牌许可。
• 项目的 notice.md 文件记录署名要求和贡献者致谢。
  任何新增贡献者或修改署名的更新也应同时更新 notice.md。
• 提交拉取请求时，请确保任何新文件在适用情况下保留署名标头。
• 本软件的网络部署版本也必须保持完全符合 AGPL-3.0+，包括在许可证适用情况下公开源代码修改。

有关完整的法律细节，请参阅 AGPL-3.0+ 许可证和项目的 notice.md 文件。

Open Arsenal Hub
https://gitlab.com/Roxanne_Ardary/open-arsenal-specs