- 功能:AMT凭证的增删改查管理 - 支持设置默认凭证 - 支持单个和批量测试凭证连接 - 数据库表:amt_credential - 后端: * AmtCredential实体类 * AmtCredentialMapper * AmtCredentialService业务逻辑 * AmtCredentialController控制器 * 使用Result统一返回格式 - 前端: * AMT设置页面重构 * 凭证列表展示(分页、搜索) * 添加/编辑凭证弹窗 * 批量测试功能 * API接口封装 - 部署脚本: * init_amt_credential_table.bat - 初始化数据库 * test_amt_api.bat - 测试API接口 * rebuild_and_start_backend.bat - 重新编译后端 - 文档: * AMT_CREDENTIAL_FEATURE.md - 功能说明 * DEPLOY_AMT_FEATURE.md - 部署说明
172 lines
4.9 KiB
Markdown
172 lines
4.9 KiB
Markdown
# AMT 批量管理凭证功能
|
||
|
||
## 功能概述
|
||
|
||
在"系统设置 > AMT设置"页面添加了 AMT 批量管理凭证功能,用于管理 Intel AMT 设备的登录凭证。
|
||
|
||
## 主要功能
|
||
|
||
### 1. 凭证管理
|
||
- ✅ 添加凭证:创建新的 AMT 登录凭证
|
||
- ✅ 编辑凭证:修改现有凭证信息
|
||
- ✅ 删除凭证:删除不需要的凭证(默认凭证不可删除)
|
||
- ✅ 设为默认:将凭证设置为默认凭证(优先用于新设备)
|
||
|
||
### 2. 凭证测试
|
||
- ✅ 单个测试:测试单个凭证的连接状态
|
||
- ✅ 批量测试:批量测试多个凭证的连接状态
|
||
|
||
### 3. 凭证信息
|
||
- 凭证名称:便于识别的名称
|
||
- 用户名:AMT 登录用户名
|
||
- 密码:AMT 登录密码(加密存储)
|
||
- 描述:凭证的详细说明
|
||
- 默认标记:是否为默认凭证
|
||
- 状态:启用/禁用
|
||
|
||
## 技术实现
|
||
|
||
### 后端
|
||
|
||
#### 数据库表
|
||
- `amt_credential` - AMT 凭证管理表
|
||
- 字段:credential_id, credential_name, username, password, description, is_default, status, created_by, created_time, updated_time
|
||
|
||
#### Java 类
|
||
- `AmtCredential.java` - 实体类
|
||
- `AmtCredentialMapper.java` - MyBatis Mapper
|
||
- `AmtCredentialDTO.java` - 数据传输对象
|
||
- `AmtCredentialService.java` - 业务逻辑层
|
||
- `AmtCredentialController.java` - 控制器层
|
||
|
||
#### API 接口
|
||
- `GET /api/amt/credential/list` - 分页查询凭证列表
|
||
- `GET /api/amt/credential/all` - 获取所有启用的凭证
|
||
- `GET /api/amt/credential/{id}` - 根据ID获取凭证
|
||
- `POST /api/amt/credential` - 创建凭证
|
||
- `PUT /api/amt/credential/{id}` - 更新凭证
|
||
- `DELETE /api/amt/credential/{id}` - 删除凭证
|
||
- `PUT /api/amt/credential/{id}/default` - 设置默认凭证
|
||
- `POST /api/amt/credential/{id}/test` - 测试凭证连接
|
||
- `POST /api/amt/credential/batch-test` - 批量测试凭证
|
||
|
||
### 前端
|
||
|
||
#### 文件
|
||
- `src/views/system/amt/index.vue` - AMT 设置页面
|
||
- `src/service/api/amt.ts` - AMT API 接口
|
||
|
||
#### 功能特性
|
||
- 数据表格展示凭证列表
|
||
- 分页、搜索、筛选
|
||
- 添加/编辑凭证弹窗
|
||
- 批量选择和批量测试
|
||
- 实时状态显示
|
||
|
||
## 安装步骤
|
||
|
||
### 1. 初始化数据库表
|
||
运行批处理脚本:
|
||
```bash
|
||
init_amt_credential_table.bat
|
||
```
|
||
|
||
或手动执行 SQL:
|
||
```bash
|
||
mysql -uroot -proot -hlocalhost -P3306 < backend/src/main/resources/sql/create_amt_credential_table.sql
|
||
```
|
||
|
||
### 2. 重启后端服务
|
||
```bash
|
||
cd backend
|
||
mvn spring-boot:run
|
||
```
|
||
|
||
或使用批处理脚本:
|
||
```bash
|
||
restart_backend_and_test.bat
|
||
```
|
||
|
||
### 3. 访问页面
|
||
登录系统后,访问:系统设置 > AMT设置
|
||
|
||
## 使用说明
|
||
|
||
### 添加凭证
|
||
1. 点击"添加凭证"按钮
|
||
2. 填写凭证信息:
|
||
- 凭证名称(必填)
|
||
- 用户名(必填)
|
||
- 密码(必填)
|
||
- 描述(可选)
|
||
- 是否设为默认
|
||
- 状态(启用/禁用)
|
||
3. 点击"确定"保存
|
||
|
||
### 测试凭证
|
||
1. 单个测试:点击凭证行的"测试"按钮
|
||
2. 批量测试:
|
||
- 勾选要测试的凭证
|
||
- 点击"批量测试"按钮
|
||
- 查看测试结果
|
||
|
||
### 设置默认凭证
|
||
1. 点击凭证行的"设为默认"按钮
|
||
2. 系统会自动取消其他凭证的默认状态
|
||
3. 默认凭证将优先用于新设备
|
||
|
||
### 编辑凭证
|
||
1. 点击凭证行的"编辑"按钮
|
||
2. 修改凭证信息
|
||
3. 点击"确定"保存
|
||
|
||
### 删除凭证
|
||
1. 点击凭证行的"删除"按钮
|
||
2. 确认删除操作
|
||
3. 注意:默认凭证不能删除
|
||
|
||
## 注意事项
|
||
|
||
1. **密码安全**:密码在数据库中应该加密存储(当前为明文,建议后续加密)
|
||
2. **默认凭证**:系统只能有一个默认凭证
|
||
3. **凭证测试**:当前为模拟测试,实际使用时需要集成 AMT SDK
|
||
4. **权限控制**:建议只有管理员角色可以访问此功能
|
||
|
||
## 后续优化建议
|
||
|
||
1. **密码加密**:使用 AES 或 RSA 加密存储密码
|
||
2. **AMT SDK 集成**:集成真实的 AMT SDK 进行连接测试
|
||
3. **凭证应用**:将凭证应用到具体设备
|
||
4. **操作日志**:记录凭证的创建、修改、删除操作
|
||
5. **批量导入**:支持从 CSV/Excel 批量导入凭证
|
||
6. **凭证分组**:支持凭证分组管理
|
||
|
||
## 文件清单
|
||
|
||
### 后端文件
|
||
- `backend/src/main/resources/sql/create_amt_credential_table.sql`
|
||
- `backend/src/main/java/com/soybean/admin/entity/AmtCredential.java`
|
||
- `backend/src/main/java/com/soybean/admin/mapper/AmtCredentialMapper.java`
|
||
- `backend/src/main/java/com/soybean/admin/dto/AmtCredentialDTO.java`
|
||
- `backend/src/main/java/com/soybean/admin/service/AmtCredentialService.java`
|
||
- `backend/src/main/java/com/soybean/admin/controller/AmtCredentialController.java`
|
||
|
||
### 前端文件
|
||
- `src/views/system/amt/index.vue`
|
||
- `src/service/api/amt.ts`
|
||
- `src/service/api/index.ts` (更新)
|
||
|
||
### 脚本文件
|
||
- `init_amt_credential_table.bat`
|
||
|
||
## 测试建议
|
||
|
||
1. 测试添加凭证功能
|
||
2. 测试编辑凭证功能
|
||
3. 测试删除凭证功能
|
||
4. 测试设置默认凭证功能
|
||
5. 测试单个凭证连接
|
||
6. 测试批量凭证连接
|
||
7. 测试分页和搜索功能
|
||
8. 测试表单验证
|