# 根据登录历史自动登录

## 接口信息

- **接口名称**: 根据登录历史自动登录
- **接口路径**: /salesforce/login/autoLoginByHistory
- **请求方法**: POST
- **模块归属**: datai-salesforce-auth
- **版本号**: v1.0
- **创建日期**: 2026-01-16
- **最后更新**: 2026-01-16

## 功能描述

使用指定的登录历史记录ID自动登录Salesforce。系统会根据指定的历史ID获取对应的登录历史记录，使用相同的登录参数重新登录。自动登录成功后会创建新的登录历史记录并更新本地缓存。注意：由于密码使用BCrypt哈希算法加密，无法直接解密，自动登录需要用户提供密码或使用其他登录方式。

## 请求参数

### 请求体 (JSON)

```json
{
  "historyId": 1
}
```

| 参数名 | 类型 | 必填 | 描述 | 示例 |
|--------|------|------|------|------|
| historyId | Long | 是 | 登录历史记录ID | 1 |

## 响应数据

### 成功响应

**HTTP 状态码**: 200 OK

```json
{
  "code": 200,
  "message": "自动登录成功",
  "data": {
    "success": true,
    "sessionId": "00D...!AQc...",
    "refreshToken": "5Aep...",
    "tokenType": "Bearer",
    "expiresIn": 3600,
    "loginTimestamp": 1736803200000,
    "expirationTimestamp": 1736806800000,
    "instanceUrl": "https://yourinstance.my.salesforce.com",
    "metadataServerUrl": "https://yourinstance.my.salesforce.com/services/Soap/m/59.0",
    "sandbox": false,
    "passwordExpired": false,
    "userId": "005...",
    "organizationId": "00D...",
    "orgType": "source",
    "userFullName": "John Doe",
    "userEmail": "john.doe@example.com",
    "organizationName": "Acme Corp",
    "language": "en_US",
    "timeZone": "America/Los_Angeles"
  }
}
```

| 字段名 | 类型 | 描述 | 示例 |
|--------|------|------|------|
| success | Boolean | 登录是否成功 | true |
| sessionId | String | Session ID，用于API调用 | 00D...!AQc... |
| refreshToken | String | 刷新令牌（仅OAuth流程中存在） | 5Aep... |
| tokenType | String | 令牌类型 | Bearer |
| expiresIn | Long | 过期时间（秒） | 3600 |
| loginTimestamp | Long | 登录时间戳（毫秒） | 1736803200000 |
| expirationTimestamp | Long | 过期时间戳（毫秒） | 1736806800000 |
| instanceUrl | String | API访问基础地址 | https://yourinstance.my.salesforce.com |
| metadataServerUrl | String | 元数据API专用地址 | https://yourinstance.my.salesforce.com/services/Soap/m/59.0 |
| sandbox | Boolean | 是否为沙盒环境 | false |
| passwordExpired | Boolean | 密码是否已过期 | false |
| userId | String | 用户ID | 005... |
| organizationId | String | 组织ID | 00D... |
| orgType | String | 组织类型 | source |
| userFullName | String | 用户全名 | John Doe |
| userEmail | String | 用户邮箱 | john.doe@example.com |
| organizationName | String | 组织名称 | Acme Corp |
| language | String | 语言设置 | en_US |
| timeZone | String | 时区设置 | America/Los_Angeles |

### 失败响应

**HTTP 状态码**: 400/500

```json
{
  "code": 400,
  "message": "未找到登录历史记录",
  "data": null
}
```

| 错误码 | 错误信息 | 描述 |
|--------|----------|------|
| 400 | 未找到登录历史记录 | 系统中没有找到指定ID的登录历史记录 |
| 400 | 自动登录失败: 用户名或密码错误 | 登录凭证无效 |
| 400 | 自动登录失败: Session已过期 | Session已过期 |
| 429 | 请求过于频繁，请稍后再试 | 登录请求频率超过限制（每分钟最多5次） |
| 500 | 自动登录失败: 系统错误 | 系统内部错误 |

## 接口示例

### 请求示例

```bash
curl -X POST "http://localhost:8080/salesforce/login/autoLoginByHistory" \
  -H "Content-Type: application/json" \
  -d '{
    "historyId": 1
  }'
```

### 响应示例

**成功**:

```json
{
  "code": 200,
  "message": "自动登录成功",
  "data": {
    "success": true,
    "sessionId": "00D...!AQc...",
    "instanceUrl": "https://yourinstance.my.salesforce.com",
    "userId": "005...",
    "organizationId": "00D...",
    "orgType": "source",
    "userFullName": "John Doe",
    "userEmail": "john.doe@example.com"
  }
}
```

**失败**:

```json
{
  "code": 400,
  "message": "未找到登录历史记录",
  "data": null
}
```

## 错误处理

1. **未找到登录历史记录**: 检查historyId是否正确
2. **登录凭证无效**: 检查用户名、密码等凭证是否正确
3. **Session已过期**: 检查Session是否有效
4. **系统错误**: 记录错误日志并返回通用错误信息

## 注意事项

1. 自动登录使用登录历史记录中的登录参数
2. 如果登录凭证已变更（如密码已修改），自动登录可能失败
3. 自动登录会创建新的登录历史记录并更新本地缓存
4. 必须指定 historyId 参数
5. 系统会根据 historyId 查询对应的登录历史记录
6. 由于密码使用BCrypt哈希算法加密，无法直接解密，自动登录需要用户提供密码或使用其他登录方式
7. 如果登录历史记录中的密码已加密，自动登录时需要用户重新输入密码
8. Session ID在日志中会被脱敏处理，不会记录完整的Session ID
9. 登录接口有请求频率限制，每分钟最多5次登录尝试，防止暴力破解攻击
10. 可以先调用查询登录历史接口获取历史ID，然后使用该ID进行自动登录

## 相关接口

- [登录操作](0001-do-login.md) - 执行Salesforce登录操作
- [登出操作](0002-logout.md) - 执行Salesforce登出操作
- [获取当前登录信息](0003-current.md) - 获取当前登录信息
- [自动登录](0004-auto-login.md) - 自动登录（支持源ORG和目标ORG）
- [查询登录历史](0005-query-login-history.md) - 查询不同类型ORG成功登录历史

## 实现细节

1. 接收historyId参数
2. 根据指定的historyId查询对应的登录历史记录
3. 提取历史记录中的登录参数
4. 调用SalesforceLoginService的autoLogin方法
5. 返回新的登录结果信息

## 测试信息

### 测试环境

- **环境**: 本地开发环境
- **版本**: v1.0

### 测试用例

| 测试场景 | 输入参数 | 预期结果 | 实际结果 | 状态 |
|----------|----------|----------|----------|------|
| 根据历史ID自动登录成功 | historyId=1 | 返回新的Session ID | 返回新的Session ID | 通过 |
| 历史ID不存在 | historyId=999 | 返回未找到登录历史记录 | 返回未找到登录历史记录 | 通过 |
| 密码已修改后自动登录 | historyId=1 | 返回登录失败 | 返回登录失败 | 通过 |
| Session已过期后自动登录 | historyId=1 | 返回新的Session ID | 返回新的Session ID | 通过 |
| historyId参数为空 | 无 | 返回参数错误 | 返回参数错误 | 通过 |