管理后台登录与安全¶
后台网页使用独立管理员身份,App手机号/邮箱凭证和VIP角色均不能访问后台。页面与API同源;部署访问入口及证书信任方式以部署交付说明为准,不使用忽略证书校验的客户端。
当前页面地址为https://admin.budyoo.cn/admin/,属于唯一正式部署环境,目前处于上线前开发与验收阶段;已使用公共CA证书并完成公网HTTPS可达性检查。页面提供公开静态入口,管理员业务请求继续要求独立管理员Cookie、CSRF、公共头和JWE;应用实际运行配置仍为dev,不代表另有测试服。新域名需重新登录,旧IP Cookie不会自动转移。HTTP App固定码例外不适用于管理员。
请求和加密¶
后台JavaScript、CSS和图标由https://static.budyoo.cn/site-assets/admin/assets/公开分发,文件名带内容哈希,旧文件保留。后台HTML继续从原域名提供并保持no-store,CSP明确允许该静态源。资源请求不携带管理员Cookie;所有管理员API仍与页面同源,身份、CSRF及JWE规则不变。详见网站静态资源CDN。
后台API均位于/api/v1/admin/,必须HTTPS;JSON业务必须真实JWE。业务JSON字段写在各自独立文档,外层固定RSA-OAEP-256+A256GCM,参见AES协议。新增的明确用户头像/相册文件端点不套JWE,但保留独立Cookie、完整公共头、同源及写CSRF;不增加开发HTTP登录例外,也不能只发送加密标记而不做加解密。
所有请求发送八项元数据:X-Client-Type=admin、X-Platform=web、X-App-Version=网页版本、X-App-Build=构建号、X-Channel=admin_web、X-Device-Id=持久浏览器安装UUID、每次新X-Request-Id及X-Request-Timestamp;Accept-Language使用当前页面语言。JSON外层Accept=application/jose,写入Content-Type=application/jose,GET密文在X-Budyoo-JWE且无正文。明确的媒体端点使用multipart上传/PNG读取/无正文DELETE,不传JWE标记;写CSRF仍必填。公开公钥接口继续不带管理员Cookie。
登录和会话¶
- 登录成功由Set-Cookie保存
__Secure-budyoo_admin,Secure、HttpOnly、SameSite=Strict、Path=/api/v1/admin/。页面JS不读取Cookie,不将Token或密码写入浏览器存储。 - 登录rememberMe=true时Cookie的Max-Age为2592000秒,固定30天有效且不受空闲限制;省略、null或false保持原8小时绝对期限、30分钟空闲限制和28800秒Cookie。rememberMe只接受JSON布尔值或null,不能用字符串/数字代替。请求不会延长绝对期限,历史会话不自动升级。均绑定浏览器安装ID,同一安装重新登录替换旧会话,每管理员最多5个有效会话。账号禁用、角色修改、会话撤销在下一请求重读。
- 页面内存保留响应的csrfToken。除登录外的POST/PUT/PATCH/DELETE必须发送X-Admin-CSRF,并且Origin与配置的后台源完全一致。跨站Origin拒绝;不能用App当前关闭CSRF的规则解释后台行为。
- 刷新或重新打开网页通过读取会话接口恢复身份及CSRF;401返回登录。网页默认勾选“保持登录30天”,取消后沿用短期会话;密码输入使用标准autocomplete供浏览器密码管理器识别,网页不自行保存密码。管理员首次登录直接按角色进入后台,不强制改密。兼容字段mustChangePassword固定返回false;账号安全网页已移除,既有改密接口仍可供受控客户端调用,成功后撤销所有会话并重新登录。
- 登录名不区分大小写的规范化由页面执行,接口只接受小写3–32位标识。密码BCrypt成本12;新密码至少8字符且UTF-8最多72字节。错误登录与临时锁定统一401,连续5次失败锁定15分钟,IP另有每10分钟20次限制;网关也有限流。
OWNER允许用户列表、配置读取/写入、日志查询及新增的用户资料读写;VIEWER仅可读取。资料读取权限为ADMIN_USER_PROFILES_READ,修改及代传/丢弃图片要求ADMIN_USER_PROFILES_WRITE。资料写入需expectedVersion,不能修改性别、身份、注册状态或VIP。独立VIP测试读取要求ADMIN_USERS_READ,设置/取消要求ADMIN_USER_VIP_WRITE(仅OWNER)及dev且非prod,使用独立version/expectedVersion;该测试权限不属于App。新增接口实现和实际部署状态见后台目录。角色、用户范围和菜单不是客户端自报权限。当前管理员创建/角色分配页面尚未实现,首个管理员通过受控一次性初始化创建,不提供固定默认密码。
版本与渠道读取要求ADMIN_VERSIONS_READ,OWNER/VIEWER均具备;草稿创建/修改/删除及发布/停用要求ADMIN_VERSIONS_WRITE,仅OWNER具备。写操作仍需CSRF、JWE及expectedVersion(创建除外),不会因页面按钮可见而绕过服务端权限。
管理操作¶
账号列表仅返回最小投影并有分页;配置当前仅开放VIP门槛,读取后使用完整updatedAt字符串作为expectedUpdatedAt提交。409表示期间已有修改,需刷新并重新确认,不自动覆盖。成功配置更新和审计同事务提交,日志不包含密码、Cookie或完整用户资料。
登录、退出、修改密码和VIP策略变更记录操作审计。新增资料保存、代传头像/相册、丢弃暂存照片也记录审计;写入和审计同事务,失败一起回滚,仅保存受控目标及版本/数量摘要。用户VIP测试调整记录USER_VIP_TEST_ENABLE/USER_VIP_TEST_DISABLE及前后状态/版本,与变更同事务。账号生命周期禁用/删除、真实付费会员发放、支付/退款和任意配置键写入尚未开放。
版本管理的APP_VERSION_CREATE/UPDATE/PUBLISH/WITHDRAW/DELETE以及替换旧发布的APP_VERSION_REPLACE也与业务写入同事务;仅保存版本UUID、渠道、构建、状态及策略摘要,不复制下载URL或更新说明正文。
通用失败¶
后台错误使用公共code/message/data/errors四语协议。未能建立JWE上下文的失败可能为明文,此时客户端报告加密/传输错误,不信任为业务结果;不自动重发修改配置等写请求。
| HTTP | code | 含义 |
|---|---|---|
| 401 | ADMIN_LOGIN_INVALID | 凭证错误或临时锁定,不区分未知账号 |
| 401 | UNAUTHORIZED | Cookie无效/失效、安装不匹配或误用App凭证 |
| 403 | ADMIN_CSRF_INVALID | 来源、跨站标记或CSRF校验失败 |
| 403 | FORBIDDEN | 角色权限不足 |
| 400 | ADMIN_PASSWORD_INVALID | 新密码不符合规则 |
| 409 | ADMIN_CONFIG_CONFLICT | 配置并发版本已变化 |
| 426 | HTTPS_REQUIRED | 后台禁止明文HTTP |
| 429 | TOO_MANY_REQUESTS | IP/网关限流 |
后台权限不授予App角色;后台管理员也不能因此操作App用户私有接口。