DeepSafe 网络验证 — API 对接文档

版本 2.1  |  服务地址 cli.deepsafe.top:29295  |  通信协议 HTTP GET  |  加密方式 AES-256-CBC

1. 架构概览

DeepSafe 提供基于卡密的网络授权验证服务。客户端引入 DLL 后，通过 HTTP 与服务端交互完成登录、心跳、解绑等操作。

2. 加密与通信规范

2.1 请求格式

GET /{endpoint}?&key1=URL_ENCODE(val1)&key2=URL_ENCODE(val2)&Nonce={随机数} HTTP/1.1
Host: cli.deepsafe.top:29295

通用规则：

• 所有参数值必须经过 URL-Encode（字母数字及 - _ . ~ 保留原样）
• 每条请求末尾附带 &Nonce={随机正整数}
• 涉及时间校验的接口附带 &TimeStemp={Unix时间戳}

2.2 密钥派生

// 固定密钥 (构建时 VMProtect 加密，运行时解密)
string g_AESEncrypyKey = "DeepSafe";          // 实际项目请改为自定义值

// 密钥派生 (AESHelper)
MD5(g_AESEncrypyKey + Nonce)                   // → 16 字节
最终密钥 = MD5_Digest || MD5_Digest            // 复制拼接 → 32 字节

2.3 响应解密流程

HTTP Response Body (Base64 字符串)
    │
    ├─ Base64 Decode
    │      ↓
    ├─ AES-256-CBC Decrypt (key = 派生密钥, iv = 0×16)
    │      ↓
    └─ UTF-8 JSON 字符串 → json::parse()

3. 典型对接流程

可选操作：解绑 → /deepsafeUnbind  |  拉黑设备 → /deepsafeLBlocking

4. 接口列表

4.1 获取项目通知

成功响应 JSON：

{
  "result": ["Succeed"],
  "cause":  ["这是一条公告内容，支持 UTF-8 中文"]
}

该接口用于在登录界面展示项目公告，无加密或使用通用密钥加密。

4.2 初始化项目

成功响应 JSON：

{
  "code":   ["100"],
  "result": ["Succeed"],
  "state":  ["网络验证"]       // ← 此字段经过 URL-Encode，需 url_decode()
}

state 取值含义：

错误码：

4.3 卡密登录

成功响应 JSON：

{
  "code":      ["100"],
  "result":    ["succeed"],
  "EndTime":   ["2026-12-31 23:59:59"],
  "TimeStemp": ["1714200000"],
  "SafeKey":   ["94041a"],
  "CheckKey":  ["8e044c"]
}

错误码：

4.4 心跳维持

调用频率：每 60 秒一次  |  容错：连续失败 3 次后退出进程

成功响应 JSON：

{
  "code": ["100"]
}

错误码：

4.5 卡密解绑

成功响应 JSON：

{
  "result": ["Succeed"],
  "cause":  [""]
}

解绑成功后，该卡密可在其他设备上重新登录。

4.6 设备拉黑

成功响应：

okay

5. 通用错误码汇总

6. 客户端接入示例 (C++)

6.1 初始化与全局配置

// init() — DLL 入口调用
void init(HMODULE hModule) {
    // 项目配置 (编译时由一键加验证客户端注入)
    g_UserName      = "Admins";
    g_ProjectName   = "深度云授权";
    g_SafeKey       = "94041a";
    g_CheckKey      = "8e044c";
    VersionNumber   = "10";

    // 收集设备信息
    QQ     = GetQQ_Plus();       // 获取当前登录的 QQ 号
    机器码  = GetMachineID();     // MAC + CPU 序列号

    // 初始化校验
    if (!GetInitrRequst()) {
        ExitProcess(0);
    }

    // 显示登录窗口 → 启动心跳线程
    LoadWindow();
    std::thread t(HeartThreat);
    t.detach();
}

6.2 构建请求 URL（推荐封装）

// 生成随机 Nonce
int GenerateNonce() {
    unsigned int n;
    HCRYPTPROV hProv;
    CryptAcquireContext(&hProv, NULL, NULL, PROV_RSA_FULL, CRYPT_VERIFYCONTEXT);
    CryptGenRandom(hProv, sizeof(n), (BYTE*)&n);
    CryptReleaseContext(hProv, 0);
    return n;
}

// 构建 URL: path?&key1=urlencode(val1)&key2=urlencode(val2)&Nonce=xxx
static string BuildUrl(const string& path,
                       const vector<pair<string, string>>& params) {
    string url = path + "?";
    for (auto& p : params) {
        url += "&" + p.first + "=" + url_encode(p.second);
    }
    return url += "&Nonce=" + to_string(GenerateNonce());
}

// 发送 GET 并解密响应
static string GetDecrypt(const string& url) {
    auto res = cli.Get(url);
    if (!res || res->status != 200) return "";
    return E_AES256_Decrypt(res->body.c_str(), g_AESEncrypyKey);
}

6.3 调用示例

// 获取公告
string notice = GetDecrypt(BuildUrl("/deepsafeGetNotice", {
    {"user", g_UserName},
    {"rjm",  g_ProjectName}
}));

// 卡密登录
string result = GetDecrypt(BuildUrl("/deeosafeloadkhd", {
    {"user",     g_UserName},
    {"username", g_ProjectName},
    {"km",       卡密},
    {"jqm",      机器码},
    {"hQQ",      QQ},
    {"TimeStemp", to_string(time(nullptr))}
}));

// 心跳
string heart = GetDecrypt(BuildUrl("/deepsafeHeart", {
    {"user",      g_UserName},
    {"km",        LoginKey},
    {"deviceKey", 机器码},
    {"rjm",       g_ProjectName}
}));

// 解绑
string unbind = GetDecrypt(BuildUrl("/deepsafeUnbind", {
    {"user", g_UserName},
    {"km",   卡密},
    {"rjm",  g_ProjectName}
}));

DeepSafe Network Authentication © 2026