2fae 中文文档教程

Question

Two factor authentication encryption file format

此库提供功能用于加密、解密和操作 .2fae 文件。

2fae 是一种文件格式，用于向已加密的文件添加双因素身份验证。 这为加密文件增加了另一层安全性，确保只有文件的预期接收者能够解密它，即使文件密码被泄露也是如此。

文件格式本身不提供此功能，而是加密数据的容器以及 2fae 客户端和服务器执行加密和解密所需的元数据。

Encryption/Decryption flows

当用户加密文件时，原始文件数据默认使用aes-256-gcm 加密方式进行加密。 在加密发生的同时，一个唯一的文件 ID 被生成，这个信息连同执行加密的人的用户 ID、加密 IV、密钥、auth 标签和文件密码被发送到服务器。 同时生成一个2fae文件，里面只包含加密后的数据和文件id。

服务器安全地存储与给定文件 ID 和用户相关的解密信息。

解密时，用户需要成功提供文件密码并通过双重身份验证过程。 如果两者都正确，则服务器将解密密钥发送给客户端，并使用此信息解密和恢复原始文件。

Format specification

2fae 文件内容具有以下逐字节格式。

• 标题。 2 个字节 (0-1)。 带有常量的文件头，将其标识为 2fae 文件。 应始终具有十六进制值 2FAE。

• 格式版本。 1 个字节 (2)。 2fae 格式的版本。 十六进制数。

• 加密协议。 1 个字节 (3)。 文件使用的加密协议。 十六进制数。

• 文件 ID。 16 个字节 (4-19)。 文件的唯一标识符。 16 字节的十六进制 UUID。

• 加密数据。 n 个字节 (20-n)。 原始加密数据。 它还包含原始文件名。 有关加密数据内容的更多详细信息，请参阅下一节。

Encrypted content

字节 20 到 n 包含加密数据。 但是，加密的数据不仅是原始文件数据，还包括一些经过加密以妥善保管的附加信息。 解密后，数据具有以下格式。 为简单起见，字节计数从解密数据的开头开始。

• 文件名。 k 字节 (0-k)。 文件加密前的原始名称。 这可用于恢复其原始名称和/或扩展名。

• 文件名结束标志。 4 个字节 ((k+1)-(k+4))。 用于标识原始文件名何时完成的标志。 这允许考虑名称中的可变长度。 始终具有十六进制值 2FAEFDED。

• 原始数据。 n 个字节 ((k+5)-n)。 原始文件数据已经解密。

Caveats

2fae 的主要缺点是文件无法在没有互联网连接的情况下加密或解密，因为实际的解密密钥和双因素身份验证流存在于服务器中。