外观
守住日志服务边界:对象授权、危险输入与数据保护
摘要
接口已经校验 JSON,却仍可能让用户查询别人的日志、读取目录外文件或触发无界任务。本篇面向已有后端经验的 Python 学习者,以可运行的越权与路径负例解释信任边界、资源预算和安全验收。
场景:知道日志 ID 就能读到别人的数据
这是教学场景。日志查询接口使用参数化 SQL,输入类型校验也通过;但路由只按 event_id 查询,忘记用可信身份限定 tenant。同一个登录用户修改 URL 中的 ID 就能拿到另一租户日志。此时换 ORM、加类型注解或者改成异步都不能修复问题,因为漏洞发生在“谁有权操作哪个对象”的契约层。
在每次可能产生效果的位置,分开问两件事:这份数据按协议是什么意思,这个可信主体是否允许作用于目标对象。JSON合法和SQL参数化主要回答第一件事,不能推出第二件事。下面固定一条租户字段tenant为A的记录对象record与文本字段message,只改变可信身份对象Principal,预测返回内容或拒绝;再保持允许主体,只改变字段和路径,检验不同解释边界。
前置类型与输入校验负责转换与范围,本篇把判断延伸到对象权限、资源与输出。攻击输入仅进入本地临时实验,Principal只是受信身份替身,没有真实token验签;这些负例不能扩大为完整认证或真实网络防护证据。 可进一步阅读限流算法与容量保护:容量保护与限流不是互相替代。
基础:认证身份、授权动作与对象归属
Authentication(认证)确认调用者身份,Authorization(授权)判断该身份能否执行当前操作。客户端 JSON 中的 tenant、role 或 is_admin 都是请求数据,不能直接构造受信身份。认证组件应验证凭据并建立 Principal,业务层再根据权限与对象归属做判断。对象 ID 难猜可以降低偶然发现,不能替代授权;攻击者仍可能从日志、共享链接或历史响应得到 ID。
OWASP 授权指南强调默认拒绝和每次请求检查权限。检查范围包括读、写、导出、后台任务、管理接口与批量接口;只在前端隐藏按钮没有服务端保证。一次批量请求包含十个对象时,需要明确是否逐个检查、全失败还是返回允许子集,不能因为第一个合法就信任其余对象。策略与响应行为应成为可以测试的契约。
对象查询应绑定可信租户边界,例如 SQL 谓词同时使用 tenant_id 与 event_id。即使先查对象再判断,也要保证判断之前不返回内容、不写敏感日志或执行副作用。是否用 403 还是 404 隐藏资源存在性,是具体产品与威胁模型的选择,不能随意把二者当成同义。无论响应选哪种,拒绝都不能增加记录、泄露内容或留下已启动的后台导出任务。
原理:沿数据流标注信任和资源边界
图表将在阅读到此处时加载…
每一层回答不同问题。字节预算防止在 JSON 解析之前消耗过多内存;字段形状阻止未知字段被悄悄透传;业务范围决定金额、时间跨度和查询规模;授权绑定可信身份;资源边界控制下游时间与并发。将一个布尔“校验通过”传到所有层会掩盖遗漏。类型注解是工具约定,并不自动阻止运行时将 bool 当作其他数值;精确边界需要显式检查。
Python 3.14 的 json 文档提醒不可信 JSON 可能消耗大量 CPU 和内存。先限制网络入口字节,再限制容器项数、字段长度、递归深度或业务结构,避免无限嵌套与大查询。仅在 json.loads 之后检查长度,解析费用已经付出。主例只处理固定小字典,没有实现通用流式 JSON 深度限制,不能用于无边界的文件导入协议。
不要对不可信数据执行 pickle、eval 或 exec。pickle 是对象重建协议,反序列化可能调用可执行机制;“只在内部用”不是信任来源,消息队列、上传文件和缓存都可能被其他主体影响。把 pickle 换成 JSON 只消除了特定执行风险,还要有 schema、授权和资源预算。动态代码即使语法合法,也可能访问文件与网络,相关边界见 AST 与解释器执行。本篇不执行恶意载荷来证明这一点。
实战:越权、超长字段和目录逃逸必须被拒绝
独立文件 35_security.py只使用标准库。两名 Principal 代表两个租户;合法主体只能收到允许的 message 字段,跨租户主体和没有 read 权限的主体被拒绝。网络输入先限制 1024 字节,再接受唯一 message 字段及最多 64 字符文本。路径实验仅构造临时目录中的目标,不读取外部文件。
powershell
python docs/python/examples/35_security.pypython
"""Authorization, explicit input limits, safe paths and log redaction."""
from dataclasses import dataclass
import json
from pathlib import Path
import tempfile
@dataclass(frozen=True)
class Principal:
tenant: str # Created by trusted authentication boundary, not request JSON.
can_read: bool
def read_record(principal, record):
if not principal.can_read or principal.tenant != record["tenant"]:
raise PermissionError("forbidden")
return {"message": record["message"]}
def parse_body(raw):
if len(raw) > 1024: # Byte budget before decoding and parsing.
raise ValueError("body too large")
data = json.loads(raw.decode("utf-8"))
if type(data) is not dict or set(data) != {"message"}:
raise ValueError("invalid fields")
message = data["message"]
if type(message) is not str or len(message) > 64:
raise ValueError("invalid message")
return data
def safe_path(root, untrusted_name):
target = (root / untrusted_name).resolve()
if not target.is_relative_to(root.resolve()) or target == root.resolve():
raise ValueError("outside allowed root")
return target # Directory must not be writable by adversaries: resolve has TOCTOU limits.
def audit(principal, operation, status):
# Allow-list fields; never log token, password or complete request body.
return {"tenant": principal.tenant, "operation": operation, "status": status}
def must_reject(function, *args):
try:
function(*args)
except (PermissionError, ValueError):
return
raise AssertionError("dangerous input accepted")
def main():
alice, bob = Principal("A", True), Principal("B", True)
record = {"tenant": "A", "message": "ok", "token": "example-secret"}
assert read_record(alice, record) == {"message": "ok"}
must_reject(read_record, bob, record)
must_reject(read_record, Principal("A", False), record)
assert parse_body(b'{"message":"ok"}') == {"message": "ok"}
for raw in (b'x'*1025, b'{"message":1}', b'{"message":"ok","tenant":"A"}'):
must_reject(parse_body, raw)
with tempfile.TemporaryDirectory() as directory:
root = Path(directory)
assert safe_path(root, "export.json").parent == root.resolve()
must_reject(safe_path, root, "../outside.json")
must_reject(safe_path, root, str(root.parent / "outside.json"))
entry = audit(alice, "read", 200)
assert "example-secret" not in json.dumps(entry)
print("authorization, shape/size, traversal and redaction negatives: passed")
if __name__ == "__main__":
main()确定性验收包括:合法读取正确;跨租户与缺权限拒绝;超大字节、非文本 message、未知 tenant 字段拒绝;相对 ../ 与绝对外部路径拒绝;审计日志没有演示 secret。未知字段策略是本例明确选择的严格拒绝,不代表所有 JSON API 的统一规则。对兼容接口允许未知字段时,也要避免它们进入权限判断、SQL 或下游命令。
按同题对比追一次读取:A有read权限且record归A,返回只含message;B有read权限但归属不匹配,拒绝;A没有read权限,仍拒绝。同一条record与合法message在三次调用中未变,差异只在可信权限关系。主例的must_reject与精确响应断言分别验证拒绝和最小输出,不能只证明A成功。
再检查返回边界:record里有演示token,直接返回整个对象会让允许读取message扩大成允许读取秘密。显式构造DTO(跨边界的数据结构)把输出权限压到允许字段;audit同样只构造允许字段,不先泄露再靠正则猜敏感值。响应与日志是两个数据出口,应该复用最小披露的判断,不能因日志“仅后端可见”放宽。
路径、命令与 URL:字符串合法不等于目标安全
Path.resolve 将路径中的符号链接和 .. 等实际解析,随后使用 is_relative_to 检查目标是否仍在允许根内。仅做字符串 startswith 会误判相似目录前缀,也会受大小写、分隔符和链接影响。相关方法以 pathlib 3.14为准。更稳妥的业务设计是客户端只给逻辑导出 ID,由服务端映射到固定文件,而不是让调用者任意提供文件路径。
沿路径追同一个目标:export.json解析后仍在临时root内,应允许;../outside.json解析后落到root之外,应拒绝。is_relative_to检查的是解析后的关系,而字符串前缀只看到输入外形。改变锚点或符号链接会改变最终目标,所以合法字符串不能直接等于安全文件。
现在再增加一个变化:检查后攻击者替换父目录或链接。输入和第一次解析结果都没变,真正使用时目标却可能变了,这是TOCTOU(检查与使用之间状态变化)。本例root及父路径由可信进程控制,没有验证这条竞争路径;要扩大边界,就按OS补目录句柄、链接和实际打开行为的证据。Windows路径断言不能替代Linux文件句柄保证。
命令调用优先选择固定可执行文件与参数列表,例如 subprocess.run([fixed_executable, '--format', validated_format], shell=False),不能将用户字符串拼成 shell 命令。这里是局部示意,不执行系统工具。即使不用 shell,目标工具自身仍可能把 --output、配置文件或脚本选项解释为危险功能,所以参数也要允许列表及必要的 -- 边界。shell=False 防的是一层 shell 解析,不是所有程序能力。
subprocess 3.14 安全说明还指出 Windows batch 文件可能由 OS 通过 shell 处理;不能把 POSIX 参数列表经验无条件推广到 .bat 与 .cmd。对不可信输入最好避免调用批处理入口,固定可信 Python 或原生程序,核对目标行为。输出预算也需要限制,capture_output 捕获无限输出可能耗尽内存,执行超时也不自动保证所有后代进程和副作用已结束。
SSRF(Server-Side Request Forgery,服务端请求伪造)发生在用户让服务端访问其指定网络目标。不能只检查 URL 字符串是否含 localhost:域名可能解析为私网,IPv6、重定向和 DNS 变化也影响实际目的地。OWASP SSRF 指南特别强调重定向与解析后的 IP 验证。优先固定下游或允许名单,并配合网络出口限制;本篇未执行真实网络攻击,不宣称一个 URL 正则可以完成防护。
资源耗尽也是边界失败
合法查询可能请求十年数据、百万条分页或极高基数聚合。请求结构完全合法,也能耗尽数据库连接与内存。需要每请求数据预算、每租户并发预算、全局队列容量、下游 deadline 和响应大小上限。限流的 key 必须基于可信身份,攻击者可控 header 不能成为绕过依据。多个 worker 的单进程限制是否累加要写清,不把每个进程各十项误称为全局十项。
有界队列与取消说明 Semaphore 只限制执行,并不阻止提前创建百万 Task。性能预算进一步把拒绝率和资源同时纳入验收:安全防护不能靠无限排队“保证不丢请求”,也不能把所有用户都拒绝后称为性能达标。对于超时后的副作用,授权上下文和操作身份仍要随后台任务传递,不能在异步执行时丢失租户限制。
依赖供应链同样属于信任边界。版本锁和哈希保证取得已声明文件,不证明没有已知漏洞或恶意行为;需要可靠来源、依赖清单、审查与修复流程。扫描发现漏洞后还要判断使用路径和修复兼容性,不能只更新版本字符串。参考 构建与回滚的运行身份证据,确认服务实际使用已修复产物,避免开发环境升级了但生产仍导入旧包。
容易踩的坑:错误与日志也会越过边界
直接将异常 str(error) 返回客户端,可能泄露 SQL、文件路径或连接地址;错误契约应提供稳定业务码与 request_id,内部日志保留必要细节但做字段控制。请求 ID 若由客户端提供,应限制长度和字符并建立可信生成策略,避免换行伪造日志。审计字段的 tenant 也需要受信认证边界保证,而不是通过打印函数自动变安全。
另一个坑是只写正例安全测试。合法用户能够读取自己的对象,只说明可用,不说明其他人不能读取。测试矩阵应包含同租户无权限、跨租户同 ID、批量混合对象、过期身份、导出任务和异常路径。缓存 key 若缺租户维度,也可能绕过数据库侧的正确谓词,因此需要测试“先由 A 缓存,再由 B 请求”。涉及时间戳和签名的认证事实应按选定库核验,本文未覆盖 token 生命周期实现。
能力任务与独立验收
构造有区分力的安全测试矩阵
以租户 A 和 B 各有一个相同 event_id 的记录开始,分别执行 A 读 A、B 读 B、A 读 B、B 读 A;前两者返回各自内容,后两者按契约拒绝。再先由 A 填充查询缓存,让 B 请求同 ID,检查缓存不会绕过租户边界。只测试不同 ID 可能掩盖缓存键遗漏 tenant 的问题,同 ID 不同租户才是有区分力的输入。测试数据使用不同但非敏感内容,失败时可以清楚看到泄露来源。
对导出任务测试授权快照与执行时策略。用户提交任务时有权限,执行前权限被撤销,系统需要明确沿用提交授权还是重新检查;两种选择各有业务代价,不能让后台任务恰好读取哪份缓存决定。无论策略如何,任务记录都要包含可信主体与资源范围,而不是仅保存用户提供的文件名。验收报告说明授权生效时点、撤销影响和任务取消后的副作用,禁止把单次请求权限检查扩张成永久许可。
对输入预算测试边界两侧,例如1024字节与1025字节、64字符与65字符,并包含非ASCII文本。字节数与字符数不是同一指标,网络预算以字节计,字段语义长度按约定计。编码不合法应明确拒绝,不在默认替换字符之后让原本不同的标识变成同一个值。主例给的是小JSON协议,压缩请求、解压炸弹和多部分上传需要另外限制解压后体积与临时存储,不能被入口 Content-Length 检查自动覆盖。
对日志测试让请求携带演示 token、密码和带换行文本,检查业务日志和异常日志都只记录允许字段。成功路径脱敏而异常路径直接打印整个对象,仍会泄露。日志脱敏的目标是减少进入日志系统的数据,不是先泄露再承诺后续删除;需要追踪原始载荷时,应使用受限存储、明确保留策略与访问审计。日志字段被用来检索或告警时还要限制基数,避免攻击者制造大量独特标签放大监控费用。
安全测试与性能测试可以协同,但不能互相替代。在持续非法输入下观察拒绝路径是否比正常处理更耗费资源,例如每次失败都触发昂贵数据库查询或同步写大量日志。一个拒绝逻辑正确的接口仍可能被低成本流量拖垮。验收应检查拒绝不产生业务副作用、日志可控、CPU与队列有预算;没有吞吐实测则写待验证,不从代码行数少推断攻击成本低。
评审最后要求读者指出剩余风险,而不是编写泛泛的安全清单。具体说明哪些行为依赖认证库验签、哪些依赖目录权限、哪些依赖网络出口、哪些依赖跨进程数据库约束,并为每个边界给出一项可执行核验。若无法获取目标平台,不必编造结果,保留待验证关卡即可;已经完成的本地越权、路径和脱敏检查则应保存实际输出及坏变体失败证据。
把判断迁移到后台导出:提交入口检查可信主体与目标范围,入队保存必要的可信身份,执行时按明确的撤销策略再判断,结果读取仍检查归属。HTTP入口允许一次动作,不代表后台永久获得任意文件与租户权限。保持同一导出任务,只改变权限撤销时机,预测哪一步拒绝,并检查队列、文件和数据库没有越权效果。
演进服务还要提交读、写、分页、缓存和日志负例。下游URL则把“实际目标”从文件路径换成最终网络目的地:追解析、重定向与出口边界,不能只复用路径字符串规则。这里需要威胁模型与目标环境核验,不要求访问真实内网来制造证据。
通过标准是所有关键负例拒绝且正常功能保留,日志和响应不含演示秘密,资源预算在多 worker 范围明确。必须说明本地测试没有覆盖的认证库、DNS 与 OS 竞争边界,并给出目标环境核验任务。与 数据库事务的关系是拒绝和异常不能留下不明写入,不是依靠事务自动完成授权。安全缺陷不能以更高 QPS 或更多测试数量抵消。
一句话总结:安全来自可信身份、逐对象授权、受限资源和最小数据输出共同守住边界。
- 类型正确与 SQL 参数化不能替代对象授权,客户端身份字段始终不可信。
- 字节、路径、命令和网络各有解释层,验证必须覆盖实际目标与资源费用。
- 安全验收要包含拒绝后的零副作用,并检查日志、缓存和后台任务。