修改密码
This commit is contained in:
127
docs/CurrentUserPasswordApi.md
Normal file
127
docs/CurrentUserPasswordApi.md
Normal file
@@ -0,0 +1,127 @@
|
||||
# 当前登录账号修改密码接口说明
|
||||
|
||||
## 功能说明
|
||||
|
||||
- 适用范围：任意端口账号登录后修改当前登录账号自己的密码
|
||||
- 安全限制：只能修改当前登录态对应账号的密码，不能修改其他账号或其他端口账号的密码
|
||||
- 推荐接口：`PUT /system/user/profile/updatePwd`
|
||||
- 兼容接口：`PUT /system/user/profile/updateSubPwd`
|
||||
|
||||
## 规则说明
|
||||
|
||||
- 超级管理员修改的是 `sys_user.password`
|
||||
- 普通端口账号修改的是当前登录端口记录 `sys_user_login_port.sub_password`
|
||||
- 后端会从当前登录 token 中自动识别当前账号
|
||||
- 前端不需要传目标账号 ID
|
||||
- 如果传了 `portId`，且与当前登录端口不一致，后端会直接返回失败：`只能修改当前登录账号密码`
|
||||
|
||||
## 1. 推荐接口
|
||||
|
||||
- 路径：`PUT /system/user/profile/updatePwd`
|
||||
- 说明：当前登录用户修改自己的密码
|
||||
|
||||
### 请求头
|
||||
|
||||
| 请求头 | 是否必填 | 说明 |
|
||||
| --- | --- | --- |
|
||||
| `Authorization` | 是 | 登录 token |
|
||||
| `isEncrypt` | 是 | 传 `true`，与现有加密请求保持一致 |
|
||||
| `repeatSubmit` | 否 | 可传 `false` |
|
||||
| `Content-Type` | 是 | `application/json` |
|
||||
|
||||
### 请求参数
|
||||
|
||||
| 字段 | 类型 | 必填 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| `oldPassword` | String | 是 | 旧密码 |
|
||||
| `newPassword` | String | 是 | 新密码 |
|
||||
| `portId` | Long | 否 | 非必填；建议不要传，若传入的不是当前登录端口 ID 会被拒绝 |
|
||||
|
||||
### 请求示例
|
||||
|
||||
```json
|
||||
{
|
||||
"oldPassword": "123456",
|
||||
"newPassword": "NewPwd@2026"
|
||||
}
|
||||
```
|
||||
|
||||
### 返回成功示例
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 200,
|
||||
"msg": "操作成功",
|
||||
"data": null
|
||||
}
|
||||
```
|
||||
|
||||
### 常见失败响应
|
||||
|
||||
| 提示 | 说明 |
|
||||
| --- | --- |
|
||||
| `修改密码失败，旧密码错误` | 旧密码校验失败 |
|
||||
| `新密码不能与旧密码相同` | 新旧密码一致 |
|
||||
| `只能修改当前登录账号密码` | 试图修改非当前登录端口账号密码 |
|
||||
| `当前登录账号未绑定端口，无法修改密码` | 当前登录态无端口信息 |
|
||||
| `当前登录账号不存在或无权修改` | 当前登录端口记录不存在或不属于当前用户 |
|
||||
| `修改密码异常，请联系管理员` | 数据更新失败 |
|
||||
|
||||
## 2. 兼容接口
|
||||
|
||||
- 路径：`PUT /system/user/profile/updateSubPwd`
|
||||
- 说明：为兼容历史前端保留，实际安全限制与推荐接口一致，也只能修改当前登录账号密码
|
||||
|
||||
### 请求方式
|
||||
|
||||
- `body` 仍传：
|
||||
|
||||
```json
|
||||
{
|
||||
"oldPassword": "123456",
|
||||
"newPassword": "NewPwd@2026"
|
||||
}
|
||||
```
|
||||
|
||||
- 历史前端若在 query 中传 `portId`，只有在它等于当前登录端口 ID 时才允许通过
|
||||
|
||||
## 3. 前端调用示例
|
||||
|
||||
### Web 端
|
||||
|
||||
```ts
|
||||
request({
|
||||
url: '/system/user/profile/updatePwd',
|
||||
method: 'put',
|
||||
headers: {
|
||||
isEncrypt: true,
|
||||
repeatSubmit: false
|
||||
},
|
||||
data: {
|
||||
oldPassword,
|
||||
newPassword
|
||||
}
|
||||
})
|
||||
```
|
||||
|
||||
### uni-app / 移动端
|
||||
|
||||
```js
|
||||
request({
|
||||
url: '/system/user/profile/updatePwd',
|
||||
method: 'put',
|
||||
header: {
|
||||
isEncrypt: true
|
||||
},
|
||||
data: {
|
||||
oldPassword,
|
||||
newPassword
|
||||
}
|
||||
})
|
||||
```
|
||||
|
||||
## 4. 对接建议
|
||||
|
||||
- 新接入前端统一调用 `PUT /system/user/profile/updatePwd`
|
||||
- 不要让前端选择目标账号，也不要透传其他账号或其他端口的 `portId`
|
||||
- 修改成功后，建议前端提示用户重新使用新密码登录
|
||||
@@ -148,35 +148,10 @@ public class SysProfileController extends BaseController {
|
||||
@PutMapping("/updatePwd")
|
||||
public R<Void> updatePwd(@Validated @RequestBody SysUserPasswordBo bo) {
|
||||
Long userId = LoginHelper.getUserId();
|
||||
// 如果是超级管理员，走原来的密码修改逻辑
|
||||
if (LoginHelper.isSuperAdmin(userId)) {
|
||||
SysUserVo user = userService.selectUserById(userId);
|
||||
String password = user.getPassword();
|
||||
if (!BCrypt.checkpw(bo.getOldPassword(), password)) {
|
||||
return R.fail("修改密码失败，旧密码错误");
|
||||
}
|
||||
if (BCrypt.checkpw(bo.getNewPassword(), password)) {
|
||||
return R.fail("新密码不能与旧密码相同");
|
||||
}
|
||||
int rows = DataPermissionHelper.ignore(() -> userService.resetUserPwd(user.getUserId(), BCrypt.hashpw(bo.getNewPassword()), null));
|
||||
if (rows > 0) {
|
||||
return R.ok();
|
||||
}
|
||||
return R.fail("修改密码异常，请联系管理员");
|
||||
return updateAdminPwd(bo, userId);
|
||||
}
|
||||
|
||||
// 普通用户，修改当前登录端口的子密码
|
||||
// 优先使用前端传来的 portId
|
||||
Long targetPortId = bo.getPortId();
|
||||
if (targetPortId == null) {
|
||||
targetPortId = LoginHelper.getLoginUser().getCompanyRoleId();
|
||||
}
|
||||
|
||||
if (targetPortId == null) {
|
||||
return R.fail("无法确定修改的目标企业，请指定portId");
|
||||
}
|
||||
|
||||
return updateSubPwd(bo, targetPortId);
|
||||
return updateCurrentLoginPortPwd(bo, bo.getPortId());
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -190,29 +165,43 @@ public class SysProfileController extends BaseController {
|
||||
@Log(title = "个人信息", businessType = BusinessType.UPDATE)
|
||||
@PutMapping("/updateSubPwd")
|
||||
public R<Void> updateSubPwd(@Validated @RequestBody SysUserPasswordBo bo, @RequestParam(required = false) Long portId) {
|
||||
Long requestedPortId = portId != null ? portId : bo.getPortId();
|
||||
return updateCurrentLoginPortPwd(bo, requestedPortId);
|
||||
}
|
||||
|
||||
private R<Void> updateAdminPwd(SysUserPasswordBo bo, Long userId) {
|
||||
SysUserVo user = userService.selectUserById(userId);
|
||||
String password = user.getPassword();
|
||||
if (!BCrypt.checkpw(bo.getOldPassword(), password)) {
|
||||
return R.fail("修改密码失败，旧密码错误");
|
||||
}
|
||||
if (BCrypt.checkpw(bo.getNewPassword(), password)) {
|
||||
return R.fail("新密码不能与旧密码相同");
|
||||
}
|
||||
int rows = DataPermissionHelper.ignore(() -> userService.resetUserPwd(user.getUserId(), BCrypt.hashpw(bo.getNewPassword()), null));
|
||||
if (rows > 0) {
|
||||
return R.ok();
|
||||
}
|
||||
return R.fail("修改密码异常，请联系管理员");
|
||||
}
|
||||
|
||||
private R<Void> updateCurrentLoginPortPwd(SysUserPasswordBo bo, Long requestedPortId) {
|
||||
Long userId = LoginHelper.getUserId();
|
||||
Long targetPortId = portId;
|
||||
if (targetPortId == null) {
|
||||
targetPortId = LoginHelper.getLoginUser().getCompanyRoleId();
|
||||
if (LoginHelper.getLoginUser() == null || LoginHelper.getLoginUser().getCompanyRoleId() == null) {
|
||||
return R.fail("当前登录账号未绑定端口，无法修改密码");
|
||||
}
|
||||
if (targetPortId == null) {
|
||||
return R.fail("无法确定修改的目标企业，请指定portId");
|
||||
Long currentPortId = LoginHelper.getLoginUser().getCompanyRoleId();
|
||||
if (requestedPortId != null && !requestedPortId.equals(currentPortId)) {
|
||||
return R.fail("只能修改当前登录账号密码");
|
||||
}
|
||||
|
||||
// Fetch port
|
||||
SysUserLoginPort port = sysUserLoginPortService.getById(targetPortId);
|
||||
if (port == null || !port.getUserId().equals(userId)) {
|
||||
return R.fail("未找到对应企业端口或无权修改");
|
||||
SysUserLoginPort currentPort = sysUserLoginPortService.getById(currentPortId);
|
||||
if (currentPort == null || !userId.equals(currentPort.getUserId())) {
|
||||
return R.fail("当前登录账号不存在或无权修改");
|
||||
}
|
||||
|
||||
// Check old password
|
||||
String currentSubPwd = port.getSubPassword();
|
||||
String currentSubPwd = currentPort.getSubPassword();
|
||||
if (StringUtils.isBlank(currentSubPwd)) {
|
||||
// 如果没有设置子密码，视为未设置密码或无法修改（需根据业务决定，这里假设必须先有子密码）
|
||||
// 或者，如果为空，允许直接设置？
|
||||
// 考虑到用户迁移，如果为空，可能允许使用空密码验证？或者要求联系管理员重置。
|
||||
// 这里遵循用户指令：完全依赖子密码。如果为空，可能无法通过旧密码验证。
|
||||
// 但为了首次设置，如果为空，允许旧密码为空？
|
||||
if (StringUtils.isNotBlank(bo.getOldPassword())) {
|
||||
return R.fail("修改密码失败，旧密码错误");
|
||||
}
|
||||
@@ -220,17 +209,16 @@ public class SysProfileController extends BaseController {
|
||||
if (!BCrypt.checkpw(bo.getOldPassword(), currentSubPwd)) {
|
||||
return R.fail("修改密码失败，旧密码错误");
|
||||
}
|
||||
if (BCrypt.checkpw(bo.getNewPassword(), currentSubPwd)) {
|
||||
return R.fail("新密码不能与旧密码相同");
|
||||
}
|
||||
}
|
||||
|
||||
if (BCrypt.checkpw(bo.getNewPassword(), currentSubPwd)) {
|
||||
return R.fail("新密码不能与旧密码相同");
|
||||
currentPort.setSubPassword(BCrypt.hashpw(bo.getNewPassword()));
|
||||
if (sysUserLoginPortService.updateById(currentPort)) {
|
||||
return R.ok();
|
||||
}
|
||||
|
||||
// Update
|
||||
port.setSubPassword(BCrypt.hashpw(bo.getNewPassword()));
|
||||
sysUserLoginPortService.updateById(port);
|
||||
|
||||
return R.ok();
|
||||
return R.fail("修改密码异常，请联系管理员");
|
||||
}
|
||||
|
||||
/**
|
||||
|
||||
Reference in New Issue
Block a user