diff --git a/STATUS.md b/STATUS.md new file mode 100644 index 0000000..c95f49d --- /dev/null +++ b/STATUS.md @@ -0,0 +1,71 @@ +# STATUS — 项目完成度 + +> PazeSSL / PazeSSH:从零实现、仅依赖 libc 的 OpenSSL / OpenSSH 平替(纯 C, ISO C17)。 +> 按层推进,本文件汇总当前各层完成度(2026-08-13 更新)。 + +## 总体 + +| 层 | 模块 | 状态 | +|---|---|---| +| 原语层 | `src/crypto` — 哈希/对称/非对称/编码/ASN.1/X.509 | ✅ 完整实现 | +| 协议层 | `src/ssl` — TLS 1.2 / 1.3 | 🔶 TLS 1.3 完成;TLS 1.2 未实现(返回 NOTSUP) | +| 协议层 | `src/ssh` — SSH-2 transport/kex/auth/channel + SFTP | ✅ 完整实现 | +| 应用层 | `apps/*` — 11 个 CLI | ✅ 可用 | +| 测试 | ~~tests/*~~ | ❌ 已从仓库移除(KAT 本地化) | + +## 密码学原语(✅ 完整) + +- 哈希:SHA-1 / SHA-256 / SHA-512 / MD5 / HMAC / HKDF / PBKDF2 +- 对称:AES-128/192/256、AES-CBC/GCM、ChaCha20、Poly1305、ChaCha20-Poly1305 AEAD +- 曲线:X25519、Ed25519、P-256、ECDSA(大数运算自研:模幂、模逆、Montgomery) +- 非对称:RSA(密钥生成/加解密/签名)、X.509 证书解析与构建、PEM/DER 编解码 +- 其他:ASN.1 DER、base64、hex、常量时间准则 + +## PazeSSL — TLS(🔶 部分完成) + +- ✅ TLS 1.3 客户端/服务端状态机(record、handshake、key schedule、扩展) +- ✅ 证书链与信任锚加载、RSA/ECDSA 私钥 PEM 解析 +- ⬜ TLS 1.2 回退(`tls_handshake12` 当前返回 NOTSUP) +- ⬜ TLS 1.3 服务端 SHA-384 密码套件握手重放(SHA-256 已覆盖) +- ⬜ PSK / 0-RTT / HRR 实际数据路径 + +## PazeSSH — SSH-2(✅ 完成) + +- transport:版本交换、密钥交换(curve25519-sha256)、NEWKEYS、包加密 +- 认证:password / publickey(authorized_keys 校验) +- 通道:session(exec/shell 真实进程执行)、direct-tcpip(出站桥接) +- **SFTP 子系统 v3**:OPEN/READ/WRITE/OPENDIR/READDIR/STAT/REALPATH 等,与 OpenSSH sftp / scp -s 互操作(Git OpenSSH 实测通过) +- 客户端命令: + - `pssh ssh` — 远程 shell / 执行命令,`-L`/`-R`/`-D` 端口转发 + - `pssh scp` — SFTP 优先(OpenSSH 9.x 默认),回退 legacy SCP;`-r` 递归、`-p` 保留时间戳 + - `pssh keygen` / `keyscan` / `copy-id` — 密钥工具 + - `pssh agent` / `add` / `ssha` — agent 守护进程与密钥管理 + - `pssh sshd` — 服务端:多用户库 + 分级权限 + publickey 认证 + SFTP 子系统 +- 密码套件:chacha20-poly1305@openssh.com、aes128/256-gcm@openssh.com + +## 应用(✅ 可用) + +| 命令 | 说明 | +|---|---| +| `pssh` | SSH 工具集入口(ssh/scp/sshd/keygen/keyscan/copy-id/agent/add/useradd) | +| `pazessl` | 类 openssl 命令行(s_client/s_server/verify/genrsa/req/x509) | +| `pssh useradd` | 管理 sshd 用户库(用户名:哈希:权限) | + +## 与 OpenSSH 对比 + +| OpenSSH | PazeSSH | 说明 | +|---|---|---| +| `ssh` | `pssh` / `pssh ssh` | 远程 shell / 执行命令 / 端口转发 | +| `scp` | `pssh scp` | SFTP 优先 + legacy SCP 回退 | +| `sftp` | `pssh sshd` 子系统 | 服务端 SFTP v3,互操作通过 | +| `ssh-keygen` | `pssh keygen` | ed25519/rsa/ecdsa | +| `ssh-keyscan` | `pssh keyscan` | known_hosts 格式 | +| `ssh-copy-id` | `pssh copy-id` | 安装公钥 | +| `ssh-agent` / `ssh-add` | `pssh agent` / `add` | agent 密钥管理 | +| `sshd` | `pssh sshd` | 多用户 + 权限 + 公钥认证 + SFTP | + +## 遗留项(已知) + +- TLS 1.2 回退未实现 +- X.509 ECDSA 证书解析仍失败(P-256 曲线点验证) +- TLS 1.3 SHA-384 服务端握手重放、PSK/0-RTT 未覆盖