Android OkHttp 自定义请求头定位:hook addHeader 堆栈 + native calSign 的路径/时间戳/JSON/key 拼接 MD5
mobile/android · verified
一句话结论
App 用 OkHttp 的 Request.Builder.addHeader 添加 X-Client-Sign/X-Auth-Token 时,hook addHeader 并打印 Java 堆栈即可从调用链定位到签名方法;本例签名是 native calSign(path, timestamp, JSON, key),把四个参数拼接后交给 libscan.so 做标准 MD5,复刻拼接顺序即可离线生成签名。
原理
- 为什么 hook addHeader:OkHttp 的请求头最终都经过
okhttp3.Request$Builder.addHeader(name, value)(或header/Headers.Builder);hook 它并打印Thread.currentThread().getStackTrace(),可以直接看到业务代码/拦截器/网络层的调用链,比在混淆后的 dex 里盲搜字段名快得多。 - 定位签名入口:堆栈里出现
X-Client-Sign的赋值点后,跟到calSign声明:public static native String calSign(String str, String str2, String str3, String str4)。native 方法本身在libscan.so(不在原始 APK 中,运行时释放/下载到/data/data/<pkg>/),pull 出来用 IDA 分析可见标准 MD5。 - 参数语义(样本):
1.
defaultID():接口路径(如/api/app/applet/applet/queryAppletV2/ISO8859-1); 2.time = date.getTime() / 1000:秒级时间戳,与X-Client-Timestamp一致; 3. JSON:{"appletAlias": appID, "baseAppletAlias": "io.base.v8"}(Gson 序列化,键顺序/空格会影响结果); 4.defaultKey():固定字符串(样本m9HplCStJFZMaWng)。 - 拼接与哈希:按
path + timestamp + json + key直接拼接(无分隔符),整体 MD5;服务端用同样规则校验。因为 key 在客户端,签名只能防篡改/防重放,不能防逆向。 - 动态验证:hook
addHeader时同时打印value与堆栈,抓到一次正常请求后,用 Frida 调用calSign或 Python 复刻 MD5,对比抓包值即可确认参数顺序与 JSON 序列化细节。
触发条件
- App 使用 OkHttp(或基于 OkHttp 的 Retrofit)发起请求,自定义签名头通过
addHeader/header添加。 - 签名逻辑在 Java/Kotlin 或 native,参数可从堆栈/字段/常量中还原。
- 有 Frida/可调试环境;目标未启用强反调试/证书固定(或已绕过)。
- 服务端签名只校验客户端计算结果,没有额外设备绑定/一次性 nonce。
利用步骤
- 启动 Frida,hook
okhttp3.Request$Builder.addHeader,对目标头名(如X-Client-Sign)打印name、value和 Java 堆栈。 - 触发一次正常请求,从堆栈定位业务类/拦截器与签名方法(
calSign)。 - 反编译该方法所在类,确认参数来源:路径、时间戳、JSON 对象、固定 key;记录 JSON 的字段顺序与序列化方式。
- 若签名在 native,pull
libscan.so(或从/data/data/<pkg>/找运行时释放的 so),IDA 确认哈希算法与拼接顺序。 - 用 Python/Frida 复刻:
md5(path + str(timestamp) + json + key),与抓包X-Client-Sign对比。 - 之后可修改请求参数并重新签名,做接口测试/越权验证;注意时间戳有效期与重放限制。
PoC
// Frida:hook addHeader 并打印堆栈
let Builder = Java.use("okhttp3.Request$Builder");
Builder["addHeader"].implementation = function (name, value) {
if (name.indexOf("X-Client-Sign") !== -1 || name.indexOf("X-Auth-Token") !== -1) {
console.log("[addHeader] " + name + " = " + value);
console.log(Java.use("android.util.Log").getStackTraceString(
Java.use("java.lang.Exception").$new()));
}
return this.addHeader(name, value);
};
import hashlib, json, time
path = "/api/app/applet/applet/queryAppletV2/ISO8859-1"
ts = int(time.time())
payload = json.dumps({"appletAlias": "APP_ID", "baseAppletAlias": "io.base.v8"},
separators=(",", ":"))
key = "m9HplCStJFZMaWng"
sign = hashlib.md5((path + str(ts) + payload + key).encode()).hexdigest()
print(sign)
变体与关联
- Hook 点变体:
Request.Builder.header、Headers.Builder.add、Interceptor.intercept、Retrofit@Header注解;不同库/版本选择不同。 - 签名算法变体:MD5/SHA1/SHA256/HMAC、加盐、参数排序、URL 编码、大小写;以 native/Java 实现为准。
- 密钥来源变体:硬编码、
defaultKey()native 返回、从 so 字符串解密、服务端下发;可在 Frida 中直接调用返回函数。 - 反调试变体:Frida 检测、ptrace、SSL Pinning;需先绕过(见关联卡)。
- 关联卡片:[[mobile-android-ssl-pinning-bypass-cert-frida]](抓包/证书固定绕过)、[[mobile-android-apk-xor-string-batch-deobfuscation]](字符串还原)、[[mobile-android-jni-native-unicorn-emulation-constant-extraction]](native 常量提取)。
- 边界:签名含一次性 nonce/设备指纹/服务端时间窗时,离线复刻只能用于短时重放;native 强混淆/白盒时需动态调用。
检测与防御
- 检测特征:请求头含
X-Client-Sign/X-Client-Timestamp等自定义字段;OkHttp 拦截器/addHeader调用;nativecalSign/MD5 常量。 - 修复:签名密钥不要硬编码在客户端;使用服务端下发的短时密钥/设备绑定 + 一次性 nonce;关键接口加 TLS Pinning 与完整性校验;服务端校验时间窗与重放。
- 分析建议:先 hook 头添加点拿堆栈,再定位签名函数;不要从混淆字符串盲搜。