WebAPI

入口：POST /api/web.php?k=<AppKey>&sw=<软件ID>，请求体仅一个字段 data=<全密文 base64>，没有任何明文业务参数。

act 一览

响应

外层：{"data":"<S2C 密文>"}；解密后：{"code":0,"msg":"ok","data":{…},"ts":1700000000}

返回码

全密文协议（v4 · ECDH + AES-256-GCM）

1. 获取服务器公钥

首次通信前，客户端 GET api/web.php?k=<AppKey>&act=get_server_pub，得到 {"ok":true,"server_pub":"<base64 SPKI>"}。公钥可公开，不含任何私钥信息。

2. 派生会话密钥

客户端本地生成 ECDH P-256（或 RSA-2048）密钥对
共享密钥 S = ECDH(client_priv, server_pub)        ← 服务端用 server_priv + client_pub 独立算出同一个 S
salt       = SHA256("HVM-E2EE-SALT")
info       = SHA256(app_key | "|" | client_pub_b64 | "|" | server_pub_b64)
会话密钥 K = HKDF-SHA256(S, salt, info, 32)       ← 32 字节，全程不出现在网络上

3. 请求封包（C2C）

wire = IV(16)
     | ts(8, 小端)
     | nonce(32, hex)
     | mode(1)                       // 0 = 静态密钥, 1 = ECDH/RSA 非对称
     | cpubLen(2, 小端) | client_pub_b64
     | spubLen(2, 小端) | server_pub_b64
     | AES-256-GCM 密文(变长)
     | GCM tag(16)
     | body_sig(64, hex 的 HMAC-SHA256)

明文 JSON = {ver:4, act, app_key, ts, nonce, client_id, safe_code,
             client_pub, server_pub, body:{...}}

GCM AAD    = IV | ts | nonce | mode | 公钥段（公钥被篡改 → 认证失败）
body_sig   = HMAC-SHA256(secret + "::body", act|nonce|ts|明文JSON|client_pub|server_pub)
POST body  = data=

4. 响应封包（S2C）

wire = IV(16) | GCM 密文 | GCM tag(16)
AAD  = app_key | "|" | client_pub_b64 | "|" | server_pub_b64 | "|" | 请求 nonce
密钥 = 同一个会话密钥 K
明文 = {"code":0,"msg":"ok","data":{...},"ts":...}
外层 = {"data":""}

5. 安全机制

• 全密文无特征：线上只有 AppKey 与密文，业务参数零明文。
• 端对端加密：会话密钥由双方各自从公私钥交换推导，外部仅截获公钥与密文，无法解密。
• 认证加密：AES-256-GCM 同时保证机密性与完整性，任何位翻转都会被拒绝（4002）。
• 多重签名：client_id（运行 ID）、safe_code（封包安全码）、body_sig（包体 HMAC）。
• 一次性过期：nonce 与整包 SHA256 入库，二次发包触发 4001 并拉黑 IP / ClientID / 机器码 24 小时。
• 时间窗：ts 与服务端时间差超过 ±300 秒即拒绝（4003）。

多语言接入

WebAPI 是纯 HTTP + 全密文，任何能发 HTTP 并通过 OpenSSL / 系统 crypto 做 ECDH 与 AES-GCM 的语言都能接入。仓库内提供以下示例，均已实现完整的 ECDH 密钥交换与 AES-256-GCM 加解密：

近 20 项防破方案

内存保护指导（客户端侧）

服务端是 PHP，无客户端内存可破；客户端内存强度取决于你的实现与壳。建议：

1. 密钥拆分：secret / safe_code 拆成多片存储，运行时异或还原，内存中不出现完整字符串。
2. 反调试：IsDebuggerPresent / CheckRemoteDebuggerPresent / 时间差检测（DTR 级）。
3. 反注入：校验 PE 头与关键 API 完整性，防 IAT Hook。
4. 壳保护：VMP 或 Themida 对核心 DLL / EXE 加壳。
5. 核心逻辑云端化：关键算法走 invoke 云函数，客户端只留空壳（推荐）。

自动更新（update.exe）

更新程序随软件一同发布，主程序启动时调用：

update.exe [主程序名] [架构]
1) 读取 config.txt（api_url / k / sw / secret / safe_code / arch）
2) act=check_update 查询是否有新版本
3) 收到 latest=true 时，用返回的限次签名 URL 下载更新包
4) 校验 MD5 → 备份旧 EXE(.old) → 替换 → 重启主程序

服务端 api/update.php 校验 Token 有效期、使用次数与文件 MD5，防止被替换或盗链。