feat: 密码储存 & 配置保存 · Pull Request !4 · openEuler/ssh-utils

## TL;DR

这个 PR 完成了密码储存 & 配置保存的代码编写，也编写了密码储存流程相关函数的测试，同时将它集成进上一个阶段编写的 GUI 中。

![demo](https://foruda.gitee.com/images/1722332142208498404/b3a34efe_5392303.gif "Peek 2024-07-30 17-20.gif")

## 密码储存的加密算法的实现

### 1. 加密文件的储存

1. 使用 SHA-256 对用户输入的 passphrase 派生出16字节的摘要，作为 salt。
2. 使用上面的摘要作为 salt，使用 `argon2id` KDF 派生出32字节的加密密钥，记为 `encryption_key`。这里 argon2id 的参数配置使用了 [OWASP](https://cheatsheetseries.owasp.org/cheatsheets/Password_Storage_Cheat_Sheet.html#argon2id) 推荐的密码储存配置。
3. 随机生成16字节  `IV`。
4. 使用前面生成的 `IV` 和 `encryption_key` 使用 `AES-256-CTR` 对称加密算法储存程序中的 Vault 结构体，记为 `encrypted_data`。
5. 使用前面的 `IV` `encryption_key` `encrypted_data` 计算 `HMAC` ，它用于确保数据的完整性，并作为程序启动时对 `passphrase` 是否正确的验证。
6. 最后，将 `IV` `encrypted_data` `HMAC` 写入 `encrypted_data.bin` 文件中，将该文件权限修改为 600，只允许拥有者写入和读取。

### 2. 加密文件的读取

1. 从 `encrypted_data.bin` 文件中读取数据。
2. 提取前 16 字节为 `IV`，中间部分为加密数据，最后 32 字节为 HMAC。
3. 使用 SHA-256 对用户输入的 passphrase 派生出 16 字节的 salt。
4. 使用 `argon2id` KDF 和 salt 派生出 32 字节的加密密钥 `encryption_key`。
5. 创建 HMAC 实例并验证数据完整性和密码正确性。
6. 使用`IV` & `encryption_key` 使用 `AES-256-CTR` 算法解密加密数据。
7. 将解密后的数据转换为字符串并解析为 Vault 对象。

### 3. 加密文件中服务器密码的储存

服务器密码储存在上面的加密文件中，同时继续使用 `argon2id` 作为 KDF，`AES-256-CTR` 对称加密算法储存。

1. 使用 SHA-256 对该服务器的 UUID 派生出16字节的摘要，作为 `IV`。
2. 使用前面生成的 `IV` 和 `encryption_key` 使用 `AES-256-CTR` 对称加密密码，然后保存回 Vault 结构体中。

### 4. 加密文件中服务器密码的读取

1. 使用 SHA-256 对服务器的 UUID 派生出 16 字节的 `IV`。
2. 使用前面生成的 `IV` 和 `encryption_key` 使用 `AES-256-CTR` 对称加密算法解密密码。
3. 将解密后的数据转换为字符串并返回。

## 加密算法测试的编写

主要验证的功能和外部命令行工具进行相互验证，使用到了

- https://github.com/P-H-C/phc-winner-argon2
- sha256sum 命令
- openssl 命令

验证了实现的一致性。

## 配置保存

配置文件储存在使用用户的 `~/.config/ssh-utils/` 文件夹下，使用 toml 格式。

`config.toml` ：

```toml
[[servers]]
id = "aef2aa18-b699-452c-811d-eb067086ee79"
name = "aliyun"
ip = "1.1.1.1"
user = "admin"
```

`encrypted_data.bin` 解密后的 `encrypted_data` 部分：

```toml
[[servers]]
id = "aef2aa18-b699-452c-811d-eb067086ee79"
password = "secret_password1"
```

类型	指派人员	状态
审查		已完成 (0/0)
测试		已完成 (0/0)

openEuler/ssh-utils .gitee-modal { width: 500px !important; }

搜索帮助

openEuler/ssh-utils