PUT/api/v1/admin/auth/password
管理员Cookie、CSRF、ADMIN_SESSIONJSON 响应接入指南 ↗

修改管理员密码

请求参数

仅后台web客户端。必须使用HTTPS和JWE;八项公共元数据必填,clientType=admin、platform=web、channel=admin_web。客户端类型不是管理员认证,App Bearer不能调用后台。

字段 类型 必填 约束
currentPassword string 是 当前密码,最多72字节
newPassword string 是 8字符起,UTF-8不超过72字节,不能与当前相同

请求示例

通过管理员统一请求约定加密后发送,下面表示解密后的业务内容。外层使用Accept: application/jose;GET无正文,密文置X-Budyoo-JWE。写请求Origin必须与后台源一致,会话操作另带X-Admin-CSRF;HttpOnly Cookie由浏览器自动携带。

{
  "currentPassword": "填写当前密码",
  "newPassword": "Replace-with-a-new-password-2026"
}

成功响应

HTTP200,Cache-Control:no-store。实际外层为JWE,解密后示例:

{
  "code": "SUCCESS",
  "message": "操作成功。",
  "data": null,
  "errors": []
}

用户主动改密成功后撤销该管理员全部会话、清除当前Cookie,需要重新登录。密码仅保存BCrypt摘要,不记录到审计。

失败响应

HTTP code 条件
400 BAD_REQUEST/VALIDATION_FAILED JSON、查询参数或字段校验失败
400 INVALID_CLIENT_HEADERS 元数据缺失/重复/不合法
400 ENCRYPTION_REQUIRED/INVALID_ENCRYPTED_REQUEST 缺少真实JWE或认证失败
401 UNAUTHORIZED/ADMIN_LOGIN_INVALID 会话无效、App凭证、登录或旧密码错误
403 FORBIDDEN/ADMIN_CSRF_INVALID 权限不足、来源或CSRF不符
400 ADMIN_PASSWORD_INVALID 仅改密:密码长度/相同密码不符合规则
426 HTTPS_REQUIRED 通过HTTP发送后台请求
429 TOO_MANY_REQUESTS 来源IP或网关限流
503 SERVICE_UNAVAILABLE 持久存储或Redis依赖不可用

错误按四语公共协议返回,不泄露密码、Cookie或内部异常;无法解密前的错误没有加密响应上下文,不作为已认证业务结果。

接入说明

当前管理网页已移除账号安全页面和菜单,本接口仍保留原鉴权与改密契约,不因网页入口删除而停用。

所有安全和会话约定见后台登录协议,权限由后端每次请求核验。正式凭证不通过未信任TLS链路发送。已通过服务器隔离数据库回归,覆盖独立身份、权限、字段校验和对应失败分支;旧环境曾使用已明确信任的IP证书完成浏览器登录、改密、列表、配置及审计检查。当前域名公共CA证书已签发,后台公网入口已发布并完成服务器内TLS校验,管理员创建/角色编辑及用户管理写操作仍待实现。