阅读记录接口的权限边界:账号隔离、元数据补全与安全删除
本文目录
阅读记录看似只有目标 ID、百分比和更新时间,但它会关联文章、图书与账号。常见实现直接查出用户的记录,再把所有目标完整联表返回。这样会泄露隐藏文章的标题、加密正文,甚至让删除接口操作其他用户的数据。
本篇围绕一个具体资源设计接口,不重复通用登录教程。身份验证回答“请求是谁发的”;授权还需回答“他能读到哪个目标、哪些字段,以及能删除什么”。
先从会话得到账号,再查询
受保护接口的 userId 来自服务端验证过的会话。不要接受请求体或查询参数里的 userId 作为当前身份。
const items = await prisma.readingProgress.findMany({
where: { userId: authenticatedUser.id },
orderBy: [{ updatedAt: 'desc' }, { id: 'asc' }],
take: 100,
});
updatedAt 相同的时候,增加 id 排序使结果稳定。这里展示最近 100 条,产品应明确说明;需要完整历史再设计游标分页,不要让 UI 把前 100 条声称为账号全部记录。
查询私有数据应使用 private, no-store 缓存策略。即使接口在浏览器中需要令牌,也不代表中间代理、Service Worker 或 CDN 可以缓存响应。
记录存在,不代表目标仍可读
用户昨天读过的文章,今天可能撤回、移入回收站或设为定时发布。历史记录属于用户,但关联文章的展示权限需要重新判断。
| 目标 | 返回历史条目 | 关联标题与跳转 |
|---|---|---|
| 正常公开文章 | 可以 | 可以返回标题与 slug |
| 已隐藏或删除文章 | 可以保留记录 | 使用通用不可访问提示 |
| 加密文章 | 依产品允许展示元数据 | 正文仍需密码验证 |
| 已下架图书 | 可以保留记录 | 根据当前角色重新授权 |
| 会员限定图书 | 可以保留记录 | 普通账号不能获得受限内容 |
返回 null 元数据能让前端显示“目标已下架或当前账号无权阅读”。不要返回原始标题后仅把按钮禁用;泄露已经发生在接口响应中。
分批补全元数据,避免 N+1
从最近记录提取唯一图书 ID 与文章 slug,各执行一次有界查询,再用 Map 回填。不要循环每条记录都访问数据库。下列示例适用于项目现有 Prisma Client 的 findMany 接口:
const articles = slugs.length
? await prisma.document.findMany({
where: {
slug: { in: slugs },
isPublished: true,
deletedAt: null,
OR: [{ date: null }, { date: { lte: new Date() } }],
},
select: { slug: true, title: true, isEncrypted: true },
})
: [];
const bySlug = new Map(articles.map(article => [article.slug, article]));
select 只包括列表需要的字段。不要查询正文后再用对象解构删掉,容易在后续重构中误带 password、content、审核备注或原始文件路径。字段选择不是完整权限系统,它只是减少数据暴露的另一层约束。
图书还需要校验上架状态与阅读等级。管理员预览权限和普通读者权限可以不同,但差异必须在服务端显式实现。不能从 localStorage 读取“管理员”标记后发送给后端充当可信角色。
历史 URL 要转换成可信目标
文章记录可能存相对路径,也可能是过去保存的绝对 URL。后端不应把任意外部 URL 当成本站文档 slug,前端也不能直接用原始 targetId 作为 href。
解析时指定本站基准 URL,检查协议和主机属于允许集合,要求路径位于文章命名空间,再解码得到 slug。对解码错误、控制字符和反斜杠拒绝处理。生产域名应来自受控配置,不能使用客户端任意传入的 Host 值。
前端仍需独立生成站内跳转。一个数据库中的历史字段不能天然获得信任,迁移数据和旧版本客户端同样可能留下异常内容。本文的解析只为识别已有文章,不应拿它作服务器抓取 URL 的通用 SSRF 防护器。
删除条件里同时写账号与记录 ID
只做 findUnique 验证再执行 delete,并不是理想边界;开发者容易忘掉验证,分开的读取和写入也增加了时序复杂度。把所属账号直接写进删除谓词:
const result = await prisma.readingProgress.deleteMany({
where: {
id: validatedRecordId,
userId: authenticatedUser.id,
},
});
return { removed: result.count > 0 };
不存在记录和其他用户的记录都返回 removed:false,不暴露哪位用户拥有这个 ID。当前账号自己的记录删除成功返回 true。重复删除的最终效果一致,可以安全地让用户重试。
这删除的是“阅读记录”,不是文章或图书。确认弹窗必须准确写明:只移除云端历史,不删除内容;用户下次继续阅读仍可能重新生成记录。不要让一个泛化“删除”按钮制造资源被永久删除的误解。
输入校验和权限检查分开
记录 ID 可以限制字符与长度,减少异常输入,但合法 ID 不代表有权限。必须始终带上 userId 谓词。密码和读取凭据也不能通过“随机 ID 很难猜”来替代校验。
编辑昵称时同样只允许白名单字段;后端不能把客户端整个对象传入 user.update.data。账号 ID、角色、状态、邮箱验证标志必须走自己的受控流程。trim、Unicode 规范化和长度检查之后,再拒绝控制字符;公开昵称不要求唯一,但需要清楚说明它会展示在评论中。
客户端反馈也有权限语义
删除成功后只移除当前账号的那条历史;请求期间换账号,旧响应不能操作新账号列表。服务端授权和客户端会话代次需要同时存在。
失败保留确认弹窗与原有条目,显示可重试提示。成功后恢复焦点到列表中合理位置;如果当前筛选只剩最后一条记录,显示明确的空结果而不是突然跳回其他筛选。读取失败与空列表使用不同状态,避免用户误以为历史被清空。
验证清单
- 甲带自己的凭据删除乙的记录:乙的数据保持不变。
- 不存在 ID、乙的 ID、已删除 ID:均不泄露其他账号信息。
- 一次历史读取最多两次元数据查询;相同目标去重。
- 未发布、回收站、未来发布文章:不返回标题和正文。
- 已公开的加密文章:只返回允许展示的标题标记,正文接口继续校验密码。
- 普通读者请求管理员限定图书:列表不能带出封面原文件或私有下载地址。
- 非法 URL、外部 URL、编码异常:不生成可点击的危险链接。
- 删除时账号切换、读取失败重试、相同时间排序:行为可预测。
权限测试要断言真实查询谓词或使用隔离数据库验证结果,不能只搜索源码里有没有 userId 字样。浏览器隐藏按钮只是体验控制;服务端每一次请求都需要独立授权。
参考
示例使用当前项目的 Prisma Client 查询方式;升级 ORM 大版本时应核对目标版本接口,不直接替换成其他版本文档的写法。
留言提交后直接公开,请友善交流。