# API验签参数逆向分析工具集

这个工具集帮助您分析和捕获巨量百应API的验签参数。

## 工具列表

### 1. capture_params.py - Python参数捕获工具

**功能：** 使用Playwright自动监听并捕获API请求的所有参数

**使用方法：**

```bash
# 安装依赖
pip install playwright
playwright install chromium

# 运行工具（使用默认URL和API）
python tools/capture_params.py

# 自定义目标URL和API接口
python tools/capture_params.py "https://buyin.jinritemai.com/dashboard" "getInstituteDarenData"
```

**输出示例：**

```
🔍 捕获到API请求
================================================================================

📍 URL: https://buyin.jinritemai.com/api/authorTradeData/getInstituteDarenData

🔑 关键验签参数:
  verifyFp     = verify_millxb4n_b5lvAUK8_0SU3_4NHS_9B2f_mO7PPJowv2Hb
  fp           = verify_millxb4n_b5lvAUK8_0SU3_4NHS_9B2f_mO7PPJowv2Hb
  msToken      = u9l7geNk7XjY4PmBKfEJlyLcbDA0LC1gp9U4XpDpEgCrGGLVxV_f8xU...
  a_bogus      = Q70fhHyyxNQVaplSmOkjeRAlAggMNBWjBMiObnnPtFTTcZtaY9Bp...

📋 业务参数:
  page                 = 1
  pageSize             = 20
  start_time           = 2025/11/29
  end_time             = 2025/11/29
```

### 2. browser_hook.js - 浏览器Hook脚本

**功能：** 在浏览器Console中拦截所有API请求，实时显示参数和调用栈

**使用方法：**

1. 打开Chrome浏览器，访问目标网站
2. 按F12打开开发者工具
3. 切换到Console标签
4. 复制 `tools/browser_hook.js` 的全部内容
5. 粘贴到Console并回车
6. 进行正常操作，脚本会自动捕获请求

**可用命令：**

```javascript
// 查看所有捕获的请求
window._showCapturedRequests()

// 查看第一个请求的详细信息
window._capturedRequests[0]

// 导出所有请求为JSON文件
window._exportCapturedRequests()

// 清空捕获记录
window._clearCapturedRequests()
```

**输出示例：**

```javascript
🔍 捕获到 GET 请求
================================================================================

📍 URL: https://buyin.jinritemai.com/api/authorTradeData/getInstituteDarenData

🔑 验签参数:
┌─────────┬──────────────────────────────────────────┐
│ (index) │                 Values                   │
├─────────┼──────────────────────────────────────────┤
│ verifyFp│ verify_millxb4n_b5lvAUK8_0SU3_4NHS...   │
│ fp      │ verify_millxb4n_b5lvAUK8_0SU3_4NHS...   │
│ msToken │ u9l7geNk7XjY4PmBKfEJlyLcbDA0LC1gp9...  │
│ a_bogus │ Q70fhHyyxNQVaplSmOkjeRAlAggMNBWjBM...  │
└─────────┴──────────────────────────────────────────┘

📚 调用栈:
    at XMLHttpRequest.send (hook.js:123)
    at request (app.js:456)
    at getData (component.js:789)
```

## 完整逆向流程

### 方法1: 使用Chrome DevTools（推荐新手）

1. **打开开发者工具**
   ```
   F12 或 右键 -> 检查
   ```

2. **切换到Network标签**
   - 勾选 "Preserve log" (保留日志)
   - 筛选 Fetch/XHR

3. **触发API请求**
   - 在页面上进行操作（如切换页面、点击按钮）
   - 找到 `getInstituteDarenData` 请求

4. **查看请求详情**
   - 点击请求
   - 查看 Headers、Payload、Preview、Response

5. **找到参数生成位置**
   - 右键请求 -> Copy -> Copy as fetch
   - 在Sources标签中搜索参数名（如 `a_bogus`）

### 方法2: 使用capture_params.py（推荐进阶）

```bash
# 1. 运行捕获工具
python tools/capture_params.py

# 2. 在打开的浏览器中登录并操作
# 工具会自动显示所有参数

# 3. 按Ctrl+C停止
```

### 方法3: 使用browser_hook.js（推荐专业）

```javascript
// 1. 打开Console，运行hook脚本

// 2. 进行操作，查看实时捕获

// 3. 导出数据分析
window._exportCapturedRequests()
```

## 参数说明

### verifyFp / fp (设备指纹)
- **长度：** 约40字符
- **格式：** `verify_` 开头
- **特点：** 同一设备相对固定
- **生成位置：** 通常在主JS包中
- **搜索关键词：** `fingerprint`, `canvas`, `webgl`

### msToken (会话Token)
- **长度：** 约150+字符
- **格式：** Base64编码
- **特点：** 每次会话不同
- **生成位置：** Cookie或JS生成
- **搜索关键词：** `msToken`, `_signature`

### a_bogus (反爬虫签名)
- **长度：** 约80字符
- **格式：** Base64编码
- **特点：** 每个请求不同
- **生成位置：** 通常在webmssdk.js中
- **搜索关键词：** `bogus`, `sign`, `_webmsdk`

## 实战示例

### 示例1: 快速测试是否需要验签

```python
import requests

# 方法A: 只带Cookie
cookies = {'sessionid': 'xxx', ...}
response = requests.get(url, cookies=cookies)

# 方法B: 完整参数
params = {
    'page': 1,
    'verifyFp': 'xxx',
    'msToken': 'xxx',
    'a_bogus': 'xxx'
}
response = requests.get(url, params=params, cookies=cookies)

# 对比两种方法的响应，确定哪些参数是必需的
```

### 示例2: 提取JS中的签名算法

```bash
# 1. 在Sources标签中找到包含签名的JS文件
# 2. 格式化代码（点击左下角{}）
# 3. 搜索关键词
Ctrl+F -> "a_bogus" 或 "sign" 或 "_webmsdk"

# 4. 设置断点
点击行号 -> 刷新页面 -> 单步调试

# 5. 查看调用栈
Call Stack 面板查看完整调用链
```

### 示例3: 使用execjs执行JS代码

```python
import execjs
import requests
from pathlib import Path

# 1. 提取JS代码（假设保存为sign.js）
js_code = Path('sign.js').read_text(encoding='utf-8')

# 2. 编译JS环境
ctx = execjs.compile(js_code)

# 3. 调用JS函数生成签名
url = "https://buyin.jinritemai.com/api/authorTradeData/getInstituteDarenData"
params = {'page': 1, 'pageSize': 20}

# 假设JS中有generateSign函数
a_bogus = ctx.call('generateSign', url, params)

# 4. 使用签名发送请求
params['a_bogus'] = a_bogus
response = requests.get(url, params=params)
print(response.json())
```

### 示例4: 使用Selenium获取参数

```python
from selenium import webdriver
from selenium.webdriver.common.by import By
import time

driver = webdriver.Chrome()
driver.get("https://buyin.jinritemai.com/...")

# 登录等操作...

# 执行JS获取参数
a_bogus = driver.execute_script("""
    // 查找全局签名函数
    if (window._webmsdk && window._webmsdk.sign) {
        return window._webmsdk.sign(arguments[0]);
    }
    return null;
""", url)

print(f"a_bogus: {a_bogus}")
```

## 常见问题

### Q1: 捕获不到请求？

**A:** 
- 确保API接口名称正确
- 检查是否在页面加载完成后才触发操作
- 尝试手动刷新页面

### Q2: 参数生成算法找不到？

**A:**
- 使用全局搜索（Ctrl+Shift+F）
- 搜索多个关键词：`sign`, `bogus`, `token`, `encrypt`
- 查看网络请求的Initiator（发起者）

### Q3: 逆向的算法不工作？

**A:**
- 检查是否缺少依赖（如window对象、其他函数）
- 使用execjs时确保JS环境完整
- 对比浏览器执行结果和Python执行结果

### Q4: 参数总是变化怎么办？

**A:**
- 这是正常的，签名通常包含时间戳
- 使用真实浏览器环境（Selenium/Playwright）
- 或者完全逆向算法并在Python中实现

## 推荐方案

根据不同场景选择：

### 场景1: 偶尔抓取（推荐：Cookie方案）
```python
# 优点：简单稳定
# 缺点：需要定期更新Cookie

from core.api_client import ByteDanceAPIClient
client = ByteDanceAPIClient()
data = client.request('GET', '/api/...')
```

### 场景2: 频繁抓取（推荐：Playwright方案）
```python
# 优点：稳定可靠
# 缺点：需要浏览器环境

from playwright.sync_api import sync_playwright
with sync_playwright() as p:
    browser = p.chromium.launch()
    # ... 自动操作
```

### 场景3: 高性能抓取（推荐：完全逆向）
```python
# 优点：速度快
# 缺点：维护成本高

def generate_sign(url, params):
    # 实现签名算法
    pass

params['a_bogus'] = generate_sign(url, params)
response = requests.get(url, params=params)
```

## 法律声明

⚠️ **重要提示**

- 本工具仅用于学习和研究目的
- 使用前请确保遵守目标网站的服务条款
- 不要用于商业用途或恶意攻击
- 控制访问频率，避免对服务器造成负担
- 账号被封风险自负

## 技术支持

如有问题，请查看：
- `逆向分析指南.md` - 详细的逆向分析教程
- 项目主README - 基本使用说明

祝您逆向顺利！🎉