♧ Godown 安全知识树

Go 接口与 SwissMap 反汇编识别:eface/iface/itab、slice interface 与 runtime.mapassign/mapaccess

code-analysis/reverse · verified

一句话结论

在 IDA 伪代码里看到 runtime_eface/runtime_iface、_slice_interface_、runtime_convTstring、runtime_mapassign_fast64/mapassign_faststr 等符号时,可以按 Go 运行时的固定布局还原接口与 map 语义:空接口是 {_type, data} 两字,非空接口是 {itab, data} 两字,[]interface{} 是三字切片头,Go 1.24+ 的 map 是使用 used/seed/dirPtr/globalDepth 的 SwissMap;识别这些结构后能把大量“看不懂的间接调用/写屏障”还原成正常的赋值与输出逻辑。

原理

  • 空接口 interface{}(eface):runtime_eface 为 {internal_abi_Type *_type; void *data},共 16 字节。_type 描述动态类型(Size_、PtrBytes、Hash、TFlag、Align_、FieldAlign_、Kind_、Equal、GCData、Str、PtrToThis 等),data 指向实际值。
  • 非空接口(iface):runtime_iface 为 {internal_abi_ITab *tab; void *data}。itab 是接口方法表,包含动态类型信息与接口所有方法的函数指针,作用类似 C++ 虚表;例如 fmt.Println 的 io.Writer 参数使用 go_itab__ptr_os_File_comma_io_Writer 作为 tab、os_Stdout 作为 data。
  • _slice_interface_:[]interface{} 的切片头是 {interface *array; int len; int cap},24 字节。fmt_Fprintln(writer, slice) 的第二个参数就是它;fmt_Fprintf 则多一个 string 格式化串。识别这两组参数(io_Writer + _slice_interface_,或再加 string)可以快速区分 Print/Printf 系列调用。
  • runtime_convTstring:把栈上的 string 值复制到堆上并返回 string*,再把 RTYPE_string_0 与该指针组成 eface。这样做的原因是栈帧销毁后栈上数据可能失效,接口值必须拥有稳定的副本;伪代码里表现为“先取类型 &RTYPE_string_0,再调用 runtime_convTstring,然后填两个 qword”。
  • 输入路径:fmt.Scanln(&a) 先 runtime_newobject(&RTYPE_string_0) 在堆上分配 string 对象,再用 RTYPE__ptr_string 构造 *string 的 eface;io.Reader 同样用 go_itab__ptr_os_File_comma_io_Reader + os_Stdin。输出/输入结构几乎对称,只是 Writer 换成 Reader。
  • 切片扩容:make([]T, len) 后 append 会调用 runtime_growslice(et, old, cap);返回的 runtime_slice 是 {void *array; int len; int cap}。Go 在向含指针的元素写值时插入 runtime_gcWriteBarrier1 慢路径;伪代码里 if (runtime_writeBarrier.enabled) { ... } 通常可视为“正常赋值 + GC 写屏障”,不是业务分支。
  • SwissMap(Go 1.24+):internal_runtime_maps_Map 的关键字段为 used(+0x00,元素个数)、seed(+0x08,哈希种子)、dirPtr(+0x10,目录数组指针)、dirLen(+0x18)、globalDepth(+0x20)、globalShift(+0x21)、writing(+0x22)、clearSeq(+0x28)。初始化时用 runtime_duffzero 清零目录、m.dirPtr = ...、m.seed = runtime_rand()。
  • 类型专用 map 函数:runtime_mapassign_fast64/mapaccess1_fast64 对应 64 位整数键(如 map[int]string),runtime_mapassign_faststr/mapaccess1_faststr 对应字符串键;函数名里的 fast64/faststr 和 RTYPE_map_int_string/RTYPE_map_string_string 直接暴露键值类型。mapassign_* 返回 value 槽指针,因此伪代码常见 v2[1] = 长度; *v2 = 数据指针 的两次写;mapaccess1_* 返回 value 的副本。
  • 为什么可复用:Go 编译器把接口、切片、map 语法全部降级为固定的运行时调用与内存布局,符号名和结构偏移在同类版本的二进制中稳定;掌握这套映射后,即使 -ldflags="-w -s" 去符号,也能靠 RTYPE_*、runtime_* 和结构形态恢复变量类型与控制流。

触发条件

  • 目标是 Go 编译的二进制,反汇编器为 IDA/Ghidra 等,能看到 runtime_*/go_itab_*/RTYPE_* 符号或类型信息。
  • 伪代码中出现接口调用、fmt 系列调用、make(map)/mapassign/mapaccess、append/growslice 等模式。
  • 需要还原结构体字段、函数参数类型或 map 的键值类型,以便继续逆向业务逻辑或漏洞点。
  • 目标 Go 版本为 1.24+ 时使用 SwissMap 布局;较早版本是 hmap(count/flags/B/buckets 等),字段名与偏移不同,需先确认版本。

利用步骤

  1. 确认 Go 二进制与版本:查 .gopclntab、Go build ID、runtime.main,必要时用 go version -m 或字符串中的 go1.x 判断是否为 SwissMap。
  2. 在 IDA 中运行 go_parser/redress 恢复符号与类型;若已去符号,仍可用 RTYPE_* 字符串和 runtime_* 调用定位。
  3. 遇到 16 字节结构体且第一个字段指向 RTYPE_*:按 eface 解读为 {type, data};若第一个字段指向 go_itab_*:按 iface 解读为 {itab, data}。
  4. 遇到 24 字节的 {array, len, cap} 且 array 元素是 interface:按 []interface{} 解读;遇到同样三字但元素是 string:按普通 []string 解读。
  5. 遇到 runtime_mapassign_fast64/faststr:第一个参数是 SwissMapType*(或 RTYPE_map_*),第二个是 map 头 &m,第三个是 key,返回值是 value 槽指针;mapaccess1_* 同样三参,返回 value 副本。
  6. 按 internal_runtime_maps_Map 的偏移注解 m,忽略 runtime_duffzero 的清零块与 gcWriteBarrier 慢路径,聚焦 dirPtr/used 的变化,即可还原 map 的插入、查询与遍历逻辑。
  7. 对 fmt_Fprintln/fmt_Fprintf 等调用,按“writer iface + slice interface(+ format string)”的顺序回填参数,伪代码中的 v10.array/v10.len/v10.cap 就是可变参数列表。

PoC

// IDA 中可直接套用的类型定义(64 位)
struct runtime_eface { void *_type; void *data; };       // interface{}
struct runtime_iface { void *tab; void *data; };         // io.Writer / io.Reader 等非空接口
struct slice_interface { void *array; long len; long cap; }; // []interface{}
struct go_slice { void *array; long len; long cap; };    // []T

// fmt.Println(a) 的典型降级
// v5[0] = &RTYPE_string_0; v5[1] = runtime_convTstring(a);
// v10 = {&v5, 1, 1}; fmt_Fprintln(writer_iface, v10);

// map[int]string 的写入与读取
// v = runtime_mapassign_fast64(&RTYPE_map_int_string, &m, key);
// v[1] = len; *v = data_ptr;             // 写 value 槽
// s = *(string *)runtime_mapaccess1_fast64(&RTYPE_map_int_string, &m, key);
// SwissMap 头(Go 1.24+),按 IDA 结构体偏移注解
struct internal_runtime_maps_Map {
    unsigned long long used;        // +0x00
    unsigned long long seed;        // +0x08
    void *dirPtr;                   // +0x10
    int dirLen;                     // +0x18
    unsigned char globalDepth;      // +0x20
    unsigned char globalShift;      // +0x21
    unsigned char writing;          // +0x22
    unsigned long long clearSeq;    // +0x28
};

变体与关联

  • Go 1.24 之前是 hmap 布局(count、flags、B、noverflow、hash0、buckets、oldbuckets 等),mapassign/mapaccess 的桶结构与 SwissMap 不同;先确定版本再套偏移。
  • Go 1.17+ 部分平台改为寄存器传参(register ABI),栈传参的伪代码形态会变化;接口与 map 的运行时结构不变,但参数位置需按 ABI 重新确认。
  • 与 [[code-analysis-reverse-go-binary-layout-symbol-recovery]] 互补:该卡讲 string/slice/map 基础布局与 stripped 符号恢复,本卡补充 eface/iface/itab、[]interface{} 和 SwissMap 的具体字段与类型专用 map 函数。
  • 与 [[binary-pwn-stack-go-stack-overflow-rop]] 关联:识别 runtime_convTstring 等运行时调用有助于理解 Go 栈溢出 payload 为什么必须保留字符串指针。

检测与防御

  • 逆向方:优先用 go_parser/redress 恢复类型;对去符号二进制,先搜 RTYPE_/go_itab_ 字符串,再按结构形态手工注解。
  • 开发方:发布时使用 -ldflags="-w -s",必要时用 garble 混淆标识符与字符串;但 Go 运行时依赖类型信息,完全去除会影响反射与接口,防御目标是提高分析成本。
  • 注意:本卡是逆向分析技巧,不是可直接利用的漏洞;severity 标 low。