PazeSSH/CHANGELOG.md

CHANGELOG

本项目 (PazeSSL / PazeSSH) 的变更记录。格式参考 Keep a Changelog；版本号按里程碑独立标注（仓库未打 tag，以日期与功能阶段为准）。

[开发主线] — 2026-08-14

新增 —— 自动重连（实用版）

• pssh ssh -o ReconnectInterval=N:断线(keepalive 心跳发送失败判定)时由外层循环自动重连并重新执行命令/重开 shell(pssh_cmd_ssh 返回 -2 触发)。
• 说明:依赖 ServerAliveInterval 心跳探测(建议配 -o ServerAliveInterval=N -o ReconnectInterval=N);恢复的是"重连+重跑",不能恢复进行中的 PTY 状态。

新增 —— agent 转发（-A）

• pssh ssh -A:打开 auth-agent@openssh.com 通道，事件循环把本地 agent socket 与通道双向桥接（ssh_agent_fd 暴露 POSIX fd）。
• 平台限制:PazeSSH 在 POSIX 上可用;Windows 上 agent 为命名管道、无可供 select 的 fd,运行时明确禁用并提示(不崩溃)。
• 无本地 agent 时给出明确提示(cannot connect local agent)。

新增 —— keyboard-interactive 认证 (RFC 4256)

• 客户端:password 失败后 fallback 到 keyboard-interactive(发请求、收 USERAUTH_INFO_REQUEST、以密码响应首个 prompt)。
• 服务端:方法列表含 keyboard-interactive,收发 INFO_REQUEST/INFO_RESPONSE 并复用用户库密码校验;psshd -kbdint 可强制仅接受 ki(测试/策略)。
• 验证:pssh -pwd 连 psshd -kbdint 时经 keyboard-interactive 认证成功(exit 0,命令正常执行)。

新增 —— 长连接保活 + fail2ban 兼容

• keepalive 保活：pssh ssh 新增 -o ServerAliveInterval=N（默认 15s，0=禁用），空闲时定时发 keepalive@openssh.com global request（ssh_keepalive_send，fire-and-forget），保持空闲连接不被 NAT/防火墙回收；服务端对 GLOBAL_REQUEST 回包形成保活闭环。
• fail2ban 兼容：psshd 认证失败日志对齐 OpenSSH 格式（Invalid user X from <IP> port N ssh2 / Failed password for X from <IP> port N ssh2），并记录对端 IP（ssh_session_set_peer_ip），可用 fail2ban 默认 sshd filter 封禁。

新增 —— SSH config 兼容读取 + ECDSA KAT 基线

• pssh ssh config 读取优先级:-F <file> > ~/.ssh/config(OpenSSH 兼容) > ~/.pssh/config.conf;支持 Host/HostName/Port/User/IdentityFile/ProxyJump/StrictHostKeyChecking。
• 新增可重复回归脚本 build/run_ecdsa_selfcheck.ps1(KAT 基线):对 P-256/384/521 各跑 ECDSA sign→verify 自洽,作为防回归基线。

新增 —— TLS 1.3 会话恢复持久化

• session ticket key：新增 paze_tls_config_set_session_ticket_file（持久化文件）与 paze_tls_ensure_ticket_key（首次生成时读取/写盘，PSK 验证入口亦加载），服务端跨进程重启后 ticket 仍可校验、会话恢复继续有效。
• CLI：pazessl s_server -ticket_file <file>。端到端验证：重启服务端（同 ticket 文件）后 resumed=YES。

新增 —— session ticket key 轮换

• 支持 2 代 ticket key：新增 paze_tls_config_rotate_ticket_key（当前 key 转上一位、新 key 装当前；写盘 2×32 字节）；验证用所有已就绪 key 遍历匹配 MAC，轮换后旧 ticket 仍由上一代 key 平滑验证。
• CLI：pazessl s_server -rotate_ticket_key。验证：轮换后旧会话仍恢复 + 新会话跨进程恢复。

新增 —— TLS secp521r1 (P-521) 完整链路

• 新增 P-521 椭圆曲线：src/crypto/p521.c + include/paze/p521.h（域 p = 2^521-1，标量/仿射点 66/133 字节，常量时间标量乘；非整字节对齐，标量乘按大端位遍历）。
• ECDSA 支持 P-521 签名/验签（RFC 6979 确定性 k，配合 SHA-512）与 RFC 5915 私钥解析（paze_ecdsa_p521_sign/verify、paze_ecdsa_p521_priv_from_pem/der）。
• X.509 支持 secp521r1 证书解析、验签与签发（pk_kind==ECDSA_P521、ecdsa_p521_pub[133]、paze_x509_build_spki521、签发者 ecdsa_d521[66]、ecdsa-with-SHA512）。
• TLS 1.3 支持 secp521r1 命名组与签名算法：
  • 组 0x0019（PAZE_TLS_GROUP_SECP521R1）纳入 key_share / supported_groups / ECDH（按 SEC1 x 坐标，66 字节） / HelloRetryRequest / 服务端组选择。
  • 签名算法 PAZE_TLS_SIG_ECDSA_SECP521R1_SHA512 (0x0603) 纳入 CertificateVerify 签发与验签。
• TLS 1.2 ECDHE 亦支持 P-521 组。
• CLI：pazessl s_client -key_share P-521。
• 验证：曲线（n·G=∞、3G=2G+G）、ECDSA 双向（OpenSSL 验我的签名 + 我验 OpenSSL 签名）、X.509 P-521 自签名证书 OpenSSL verify=OK、TLS 端点 P-521 密钥交换（hrr=YES）+ 证书链/主机名验证全部通过；既有自测无回归。

[开发主线] — 2026-08-13

新增 —— TLS secp384r1 (P-384) 完整链路

• 新增 P-384 椭圆曲线：src/crypto/p384.c + include/paze/p384.h（Jacobian 点运算、常量时间标量乘、仿射编解码，结构与 p256 对齐）。
• ECDSA 支持 P-384 签名/验签（RFC 6979 确定性 k）与 RFC 5915 私钥解析（paze_ecdsa_p384_sign/verify、paze_ecdsa_p384_priv_from_pem/der）。
• X.509 支持 secp384r1 证书解析、验签与签发（pk_kind==ECDSA_P384、paze_x509_build_spki384、签发者 ecdsa_d384）。
• TLS 1.3 支持 secp384r1 命名组与签名算法：
  • 组 0x0018（PAZE_TLS_GROUP_SECP384R1）纳入 key_share / supported_groups / ECDH（按 SEC1 x 坐标） / HelloRetryRequest / 服务端组选择。
  • 签名算法 PAZE_TLS_SIG_ECDSA_SECP384R1_SHA384 (0x0503) 纳入 CertificateVerify 签发与验签。
• TLS 1.2 ECDHE 亦支持 P-384 组。
• CLI：pazessl s_client -key_share P-384。
• 验证：曲线、ECDSA、X.509 证书均与 OpenSSL 双向交叉验证；TLS 端点 P-384 密钥交换（hrr=YES）+ 证书链/主机名验证通过，既有自测无回归。

修复

• ECDSA bits2int：输入（摘要）短于群阶 qlen 时应右对齐填充，而非左移；此前会导致 P-384 + SHA-256 场景验签错误。
• 对端证书 DER 生命周期：新增 paze_tls_store_peer_cert，将证书 DER 拷贝到自有缓冲，避免 issuer_dn/subject_dn/tbs_der 等指针指向被记录层复用的缓冲，导致 TLS 1.3 / 1.2 客户端证书链验证失败。

其他

• 新增 CHANGELOG.md；更新 STATUS.md / AGENT.md。
• 规则：Git 推送仅发往 parlz(gitea)，不再提交 origin(GitHub)。
• SSH ProxyJump：确认 -J 代理跳板（单跳）核心链路已实现并同步到文档；新增 pssh ssh -W host:port（标准 I/O 转发/netcat 模式，目标 TCP 隧道桥接本地 stdio）与 -N（不执行远程命令、仅端口转发，配合 -L/-R/-D）。说明：-J 接受逗号分隔的多跳语法，但多级级联跳板在同步 I/O 架构下的应用数据阶段交互不稳定，当前会打印警告并退化为仅第一跳的稳定单跳。

[功能阶段] — 2026-08（TLS 1.3 完善期）

新增

• TLS 1.3 0-RTT 数据路径（RFC 8446 §4.2.10 / §4.5 / §8）：
  • 客户端 early_data 扩展、握手前早数据发送、EndOfEarlyData（early 密钥加密并计入 transcript）。
  • 服务端 early_read 解密接受早数据；-early / -sess_in / -sess_out 选项。
  • 公共 API：paze_tls_config_enable_early_data、paze_tls_early_write、paze_tls_early_data_accepted、paze_tls_early_data_len、paze_tls_hrr_occurred。
  • 端到端验证通过（early accepted + hrr=YES）。
• HRR（HelloRetryRequest）（RFC 8446 §4.1.3 / §4.1.4）：
  • 服务端 key_share 不匹配时发送 HRR（固定魔数 random）、transcript 合成 MessageHash 重放、客户端 CH2（仅选定组 share）响应、HRR 后放弃 0-RTT。
• TLS 1.3 PSK 会话恢复（RFC 8446 §4.2.11 / §4.6.1）：
  • NewSessionTicket 签发与解析、ticket + binder 校验、selected_identity 回选、恢复握手跳过证书；-sess_in / -sess_out 端到端验证。
• TLS 1.3 SHA-384 密码套件（TLS_AES_256_GCM_SHA384）服务端/客户端握手。

修复

• TLS 1.3 ECDSA 证书互操作：CertificateVerify 改用 DER 签名（RFC 8446 §4.2.3），补齐 NewSessionTicket extensions，支持 X.509 ECDSA 证书验签。

构建 / 其他

• 构建输出移至 bin/；新增 standalone 命令（pscp/pkeygen/pkeyscan/pcopy-id/pagent/padd/psshd）与 psftp 客户端。
• 新增 STATUS.md 完成度文档。

早期（TLS 1.2 与 SSH-2 基础）

新增

• TLS 1.2 握手与版本回退（版本回退、ECDHE-RSA/ECDSA/RSA AES-GCM、CHACHA20-POLY1305）。
• SSH-2 完整协议栈：transport / kex / auth / channel，含 SFTP 子系统 v3，与 OpenSSH / Git sftp / scp 互操作。
• 密码学原语：哈希（SHA-1/256/512/MD5）与 HMAC/HKDF/PBKDF2；对称（AES、ChaCha20-Poly1305）；曲线（X25519、Ed25519、P-256）；非对称 RSA；X.509 / ASN.1 / PEM/DER。
• pssh、pazessl 等多个 CLI 命令。

修复

• TLS 记录层 GCM 实现与 RFC 的偏差。
• 构建与编译相关修复（如 early key_share 参数不匹配）。