Python 运行时函数劫持:用 types.CodeType 替换 __code__
web/python · verified
一句话结论
只要能对任意已有函数对象执行 setattr(f, '__code__', new_code),就能用 types.CodeType 构造的代码对象把该函数改写成任意逻辑;函数名、模块、路由注册和其他调用方接口都保持不变,可把只读接口变成任意文件读取或命令执行。
原理
- Python 函数对象持有
__code__属性(code object),调用函数时解释器执行其中的字节码。__code__可写,给它赋新 code object 不会重建函数对象,也不会影响装饰器、Flask 路由表等外部引用。 types.CodeType允许直接构造 code object。Python 3.8 的参数顺序为:co_argcount、co_posonlyargcount、co_kwonlyargcount、co_nlocals、co_stacksize、co_flags、co_code、co_consts、co_names、co_varnames、co_filename、co_name、co_firstlineno、co_lnotab、co_freevars、co_cellvars;Python 3.11+ 以co_linetable/co_exceptiontable取代co_lnotab,需按目标版本取字段。- 最省事的改写方式不是重写字节码,而是复用模板函数的
co_code/co_names,只替换co_consts中LOAD_CONST引用的字符串。例如模板函数open("app.py").read()的字节码不变,把常量'app.py'换成'/flag',函数行为就从读源码变成读 flag。 co_code是bytes。用_codecs.encode(s, 'latin-1')(或base64解码)可把字符串按 1:1 映射为原始字节;用 utf-8 会改写\x80以上的字节,导致SystemError: unknown opcode。- 控制点不限于 pickle:变量覆盖、对象属性注入、Python 原型链/属性污染、SSTI 中可赋值表达式等,只要能拿到函数对象并执行一次属性赋值,就能复用该原语。
触发条件
- 目标为 Python 3(参数列表随版本变化),攻击者能导入
types/builtins(默认可导入)。 - 攻击者能对目标函数对象执行属性赋值(
setattr、对象注入、变量覆盖、污染等)。 - 目标函数可被访问触发(如已注册的 Web 路由),且其签名与模板函数兼容(参数个数、局部变量数、栈大小等需匹配)。
- 能获得或推断目标函数
__code__的字段值;同签名模板函数可直接提供。
利用步骤
- 选定要劫持的函数
target(例如负责返回页面的路由函数)与一个同签名模板函数src。 - 枚举
src.__code__的字段,确认co_argcount、co_stacksize、co_flags、co_names、co_varnames等值。 - 按目标版本构造新的 code object:复用模板字段,修改
co_consts(把文件名/命令替换为目标值);如重写co_code,用 latin-1 或 base64 还原成 bytes。 - 执行
target.__code__ = new_code(或在 pickle/变量覆盖中调用setattr)。 - 通过正常业务入口访问
target,其返回值/副作用即变为攻击者逻辑。
PoC
import types
def src():
return open("app.py", "r", encoding="utf-8").read()
def secret():
return
o = src.__code__
secret.__code__ = types.CodeType(
o.co_argcount,
o.co_posonlyargcount,
o.co_kwonlyargcount,
o.co_nlocals,
o.co_stacksize,
o.co_flags,
o.co_code,
tuple(c if c != "app.py" else "/flag" for c in o.co_consts),
o.co_names,
o.co_varnames,
o.co_filename,
o.co_name,
o.co_firstlineno,
o.co_lnotab,
o.co_freevars,
o.co_cellvars,
)
print(secret()) # 读取 /flag
改写 co_code 时生成 bytes 的等价写法:
import _codecs
co_code = _codecs.encode(raw_bytecode_as_latin1_str, "latin-1")
变体与关联
- 只改
co_consts是最小改动;改co_code可执行全新逻辑(命令执行、内存马、任意函数调用)。 - 在 pickle 场景中可用
builtins.getattr/builtins.setattr/types.CodeType/_codecs.encode完成同样操作并绕过关键字黑名单,见 pickle 链卡片。 - 其他控制点:变量覆盖(如题目中的
Student.__init__属性覆盖)、对象注入、pydash.set_属性污染、SSTI 中可赋值表达式。 co_filename、co_name、co_lnotab对执行结果影响很小,通常直接复制模板值即可。- 关联:[[web-python-deserialization-pickle-codetype-function-hijack]]、[[web-python-pydash-set-attribute-path-pollution]]。
检测与防御
- 禁止不可信输入触发对函数对象的属性赋值;对
setattr的目标做白名单,尤其禁止__code__、__globals__、__dict__等敏感属性。 - 对代码执行上下文做最小权限:限制文件读、命令执行与网络访问,降低函数劫持后的危害。
- 用
sys.addaudithook监控code.__new__、function.__new__等审计事件,检测异常的 code object 构造与__code__赋值。 - 不要依赖“函数未重新定义”来假设行为不变;运行时可校验关键函数的
__code__指纹。 - 由于该原语常由其他漏洞(变量覆盖、属性污染、反序列化)触发,根本措施是修复上游注入点。