221 lines
5.9 KiB
Markdown
221 lines
5.9 KiB
Markdown
# 授权文件功能测试指南
|
||
|
||
## 前置准备
|
||
|
||
1. 确保已启动开发服务器：`npm run dev`
|
||
2. 确保数据库中已有以下数据：
|
||
- 至少一个设备型号（如 GD-30 Supreme）
|
||
- 至少一个配置文件
|
||
- 至少一个设备（用于测试下载接口）
|
||
|
||
## 测试步骤
|
||
|
||
### 1. 创建授权记录
|
||
|
||
**方式一：通过管理界面**
|
||
1. 访问 `http://localhost:3000/licenses`
|
||
2. 点击"选择授权项"按钮
|
||
3. 选择设备型号、授权模块和到期时间
|
||
4. 点击保存，系统会自动生成授权文件JSON
|
||
|
||
**方式二：通过API**
|
||
```bash
|
||
curl -X POST http://localhost:3000/api/licenses \
|
||
-H "Content-Type: application/json" \
|
||
-d '{
|
||
"model": "GD-30",
|
||
"modules": "一维自电/电阻率/激电测试模块, 二维自电/电阻率/激电测试模块, 三维自电/电阻率/激电测试模块",
|
||
"expiry": "2027-04-30",
|
||
"status": "生效",
|
||
"config_id": 1
|
||
}'
|
||
```
|
||
|
||
### 2. 预览授权文件
|
||
|
||
1. 在授权管理页面找到刚创建的授权记录
|
||
2. 点击"预览"按钮
|
||
3. 查看生成的JSON格式授权文件
|
||
4. 可以点击下载JSON按钮保存到本地
|
||
|
||
### 3. 下载授权文件
|
||
|
||
1. 在授权管理页面点击"下载"按钮
|
||
2. 文件将以 `license_GD-30_1.json` 格式下载
|
||
|
||
### 4. 测试手机APP下载接口 ⭐
|
||
|
||
**首先需要创建一个测试设备：**
|
||
|
||
```bash
|
||
# 创建设备（如果还没有的话）
|
||
curl -X POST http://localhost:3000/api/devices \
|
||
-H "Content-Type: application/json" \
|
||
-d '{
|
||
"sn": "GD30-TEST-001",
|
||
"model": "GD-30 Supreme",
|
||
"type": "电法仪",
|
||
"status": "装配中",
|
||
"production_date": "2026-04-30"
|
||
}'
|
||
```
|
||
|
||
**然后测试下载接口：**
|
||
|
||
```bash
|
||
# 方式一：使用curl
|
||
curl "http://localhost:3000/api/licenses/download?sn=GD30-TEST-001"
|
||
|
||
# 方式二：使用浏览器直接访问
|
||
# 打开浏览器访问：http://localhost:3000/api/licenses/download?sn=GD30-TEST-001
|
||
|
||
# 方式三：使用JavaScript
|
||
fetch('http://localhost:3000/api/licenses/download?sn=GD30-TEST-001')
|
||
.then(res => res.json())
|
||
.then(data => console.log(data))
|
||
.catch(err => console.error(err))
|
||
```
|
||
|
||
**预期响应：**
|
||
```json
|
||
{
|
||
"version": "1.0",
|
||
"generatedAt": "2026-04-30T16:00:00.000Z",
|
||
"deviceModel": "GD-30 Supreme",
|
||
"deviceSN": "GD30-TEST-001",
|
||
"validUntil": "2027-04-30",
|
||
"status": "active",
|
||
"authModules": [
|
||
{
|
||
"id": "1D",
|
||
"name": "一维自电/电阻率/激电测试模块",
|
||
"category": "一维",
|
||
"enabled": true
|
||
},
|
||
...
|
||
],
|
||
"config": {
|
||
"name": "...",
|
||
"version": "...",
|
||
"emissionParams": {...},
|
||
"acquisitionParams": {...},
|
||
"networkParams": {...}
|
||
},
|
||
"signature": {
|
||
"algorithm": "SHA256",
|
||
"value": "...",
|
||
"publicKey": "platform-public-key-placeholder"
|
||
}
|
||
}
|
||
```
|
||
|
||
### 5. 测试错误情况
|
||
|
||
**测试设备不存在：**
|
||
```bash
|
||
curl "http://localhost:3000/api/licenses/download?sn=NONEXIST-001"
|
||
# 应返回：{"error": "设备不存在"}
|
||
```
|
||
|
||
**测试无授权的设备：**
|
||
```bash
|
||
# 先创建一个没有授权的设备
|
||
curl -X POST http://localhost:3000/api/devices \
|
||
-H "Content-Type: application/json" \
|
||
-d '{
|
||
"sn": "GD30-NO-LICENSE-001",
|
||
"model": "GD-30 Supreme",
|
||
"type": "电法仪",
|
||
"status": "装配中",
|
||
"production_date": "2026-04-30"
|
||
}'
|
||
|
||
# 然后尝试获取授权
|
||
curl "http://localhost:3000/api/licenses/download?sn=GD30-NO-LICENSE-001"
|
||
# 应返回：{"error": "该设备暂无有效授权", ...}
|
||
```
|
||
|
||
### 6. 验证签名
|
||
|
||
可以使用以下Node.js脚本验证授权文件签名：
|
||
|
||
```javascript
|
||
const crypto = require('crypto');
|
||
|
||
function verifyLicense(licenseJson) {
|
||
const license = typeof licenseJson === 'string' ? JSON.parse(licenseJson) : licenseJson;
|
||
const { signature, ...dataWithoutSig } = license;
|
||
|
||
const jsonString = JSON.stringify(dataWithoutSig, null, 2);
|
||
const calculatedHash = crypto.createHash('sha256').update(jsonString).digest('hex');
|
||
|
||
return calculatedHash === signature.value;
|
||
}
|
||
|
||
// 测试
|
||
fetch('http://localhost:3000/api/licenses/download?sn=GD30-TEST-001')
|
||
.then(res => res.json())
|
||
.then(license => {
|
||
const isValid = verifyLicense(license);
|
||
console.log('签名验证结果:', isValid ? '✅ 通过' : '❌ 失败');
|
||
});
|
||
```
|
||
|
||
### 7. 查看下载日志
|
||
|
||
```bash
|
||
# 可以直接查询数据库查看下载记录
|
||
sqlite3 data/app.db "SELECT * FROM license_download_logs ORDER BY id DESC LIMIT 10;"
|
||
```
|
||
|
||
或在SQLite浏览器中打开 `data/app.db` 查看 `license_download_logs` 表。
|
||
|
||
## 常见问题
|
||
|
||
### Q1: 下载接口返回404？
|
||
- 检查设备SN是否正确
|
||
- 确认该设备型号有有效的授权记录
|
||
- 检查授权状态是否为"生效"且未过期
|
||
|
||
### Q2: 授权文件中config为空？
|
||
- 确保已为该设备型号创建了配置文件
|
||
- 配置文件状态需要是"生效"
|
||
|
||
### Q3: 如何区分设备级授权和型号级授权？
|
||
- 设备级授权：`device_sn` 字段有值
|
||
- 型号级授权：`device_sn` 字段为空
|
||
- 下载时优先匹配设备级授权
|
||
|
||
### Q4: 授权文件何时重新生成？
|
||
- 创建新授权时自动生成
|
||
- 更新授权信息时自动重新生成
|
||
- 首次下载时如果license_file为空会生成并保存
|
||
|
||
## 性能优化建议
|
||
|
||
1. **缓存策略**：授权文件生成后保存在数据库中，避免重复生成
|
||
2. **索引优化**：为licenses表的device_sn、model、status字段添加索引
|
||
3. **日志清理**：定期清理过期的下载日志
|
||
4. **CDN加速**：生产环境可以考虑将授权文件缓存到CDN
|
||
|
||
## 下一步开发建议
|
||
|
||
1. **前端增强**：
|
||
- 在设备详情页显示授权状态
|
||
- 添加授权文件批量导出功能
|
||
- 显示授权下载统计
|
||
|
||
2. **安全增强**：
|
||
- 实现真实的RSA签名（目前使用SHA256占位）
|
||
- 添加授权文件加密
|
||
- 实现授权文件版本控制
|
||
|
||
3. **功能扩展**：
|
||
- 支持授权模板批量应用
|
||
- 添加授权到期提醒
|
||
- 实现授权历史记录
|
||
|
||
4. **监控告警**：
|
||
- 监控授权下载次数
|
||
- 异常下载行为检测
|
||
- 授权即将到期预警 |