Repository navigation
feat(strategies): Linux 进程内 INT3 钩子密钥提取(基于 v5.1.0) - #38
Merged
Merged
Conversation
微信 4.1.2x 在 Linux 上无法用外部 ptrace tracer 抓 passphrase:内置 Chromium
crashpad 会自己 scoped_ptrace_attach 写 minidump,一个进程只能有一个 tracer,
外部 tracer 抢先附加后 crashpad 附加失败直接 abort():
[ERROR:scoped_ptrace_attach.cc(27)] ptrace: Operation not permitted (1)
这不是权限问题(kernel.yama.ptrace_scope=0 也一样),也不是断点打歪——只
attach 不打断点时进程能活,一旦保持被 trace 就死。改为把断点打在微信进程内,
全程没有 ptrace。
## 新增
* `siwx/linux_hook/elfhook.py` —— 在 .rodata 里定位
com.Tencent.WCDB.Config.Cipher 锚点,顺 RIP 相对 lea 交叉引用找到
cipher-config 消费函数偏移(与 wxextract 的算法同源,MIT,已在模块注释注明)
* `siwx/linux_hook/wxhook.c` —— 进程内 shim 源码,运行时由策略用系统 cc 编译
* `siwx/strategies/linux_hook.py` —— 策略入口:定位二进制 → 算偏移 → 构建
shim → 注入 → dde-am 拉起微信 → 收候选 → PBKDF2-SHA512(256000) 派生 +
page-1 HMAC 校验 → finally 精确还原环境
* `LINUX_SUPPORT.md` —— 方案说明与前置条件
## 打通 Linux 入口
只有策略还不够,CLI 与数据发现此前都对 Linux 关门:
* `siwx/cli.py` —— 平台闸门放行 Linux(否则 run.py 直接 "仅支持 Windows 和 macOS")
* `siwx/discover.py` —— 补 Linux 数据根(~/Documents/xwechat_files,含 XDG 文档
目录本地化的读取)与进程名(wechat/weixin/wechat-bin)
* `siwx/strategies/__init__.py` —— 平台条件注册,并计入 _PROCESS_DEPENDENT
## 注入方式:不需要 root
桌面环境经 systemd 用户管理器拉起微信,父进程是 systemd,直接给子进程设
LD_PRELOAD 会被丢掉。改用 `systemctl --user set-environment` 写用户管理器
环境,结束后精确还原(原有值恢复、无则删除)。无 systemd 用户会话时退化为
带环境变量直接执行二进制。全程不碰 /etc、不需要 root。
## 实现过程中修掉的三个硬 bug(都由 minidump 定位)
1. **SIGTRAP 处理器被顶掉**:shim 里包 sigaction 的那层原本是 `static` 函数,
符号从未导出,等于没有保护。微信的 crashpad 一安装自己的 SIGTRAP 处理器
就把我们的覆盖掉,INT3 落到对方手里被当成致命信号,进程每次都在 `bp+1`
处以 SIGTRAP 死亡(minidump 实测 4/4,RIP 精确等于 bp+1)。
现在真正导出 `sigaction`、`__libc_sigaction`、`__sigaction`,并加 50ms
看门狗复核:被顶掉就重装,复核三次仍装不回来就主动拆断点——绝不留下没人
接的 INT3。
2. **信号处理器里的非异步信号安全调用**:原来用 `snprintf` 拼日志、用范围判断
后直接 `memcpy` 读目标结构体。printf 族会碰 malloc/locale 锁,中断到持锁
线程就污染堆;野指针 memcpy 直接打死进程。改成手写十六进制 +
`process_vm_readv` 安全读取(纯 syscall,读不了返回错误而不是崩溃)。
3. **单步重布点的竞态**:早期在命中后"复原原字节 → 置 TF 单步 → 下一个
SIGTRAP 里重新布点"。这段窗口里其它线程会执行同一地址,实测捕获后必崩
(SIGSEGV @ exe+0x87B20C4,两次不同构建同一偏移)。改成**一次性布点**:
命中、记录、复原字节、把 RIP 拨回断点让原指令照常执行,随即拆断点不再重布。
一次命中就够(实测同一函数被调用多次,值完全相同)。改后连续观测 4 分钟
微信无崩溃、minidump 计数不再增长。
## 约束与安全
* 仅 Linux x86-64;非 Linux 平台不注册该策略,Windows/macOS 路径零改动
* shim 构造函数第一件事校验 /proc/self/exe,非目标微信进程直接返回
* 不新增 Python 依赖;shim 现场编译,失败时明确报错而非静默 0 命中
* 校验不过的 passphrase 一律不入库
## 实测
UOS/Deepin + 微信 4.1.13.23(4067695895),25 个数据库,用真实入口
`run.py keys extract`(空密钥库,非手工脚本):
已通过 systemctl --user 注入 shim
已通过 dde-am 拉起微信
捕获 1 个候选,开始校验
候选 <32 字节>… 命中,派生 25 个密钥
已还原 systemd 用户环境
密钥 25/25 已验证 (14533 ms)
* 25/25 page-1 HMAC 通过(含 sns.db、message_0..4、biz_message_0、contact.db)
* 无 root、无 ptrace;捕获后连续运行 4 分钟无崩溃
* 解密产物 247 MB,正文可正常读取
## 重新提交到 v5.1.0 基线
上一版 PR #35 因上游 `main` 被 git filter-repo 重写而自动关闭,本提交基于
v5.1.0(d7843f8)重放,`README.md` 的平台表与徽章冲突已按新基线合并。
顺带修掉上一版的三处文档与代码不一致(自查发现,不影响功能):
* `README.md` 声称注入走 `/etc/ld.so.preload` 且「需要一次性 root」——实际代码
走 `systemctl --user set-environment`,全程不需要 root。文档改为与实现一致。
* `LINUX_SUPPORT.md` / 策略 docstring 里的「置 TF 单步后重新布点」是早期实现,
最终代码是**一次性布点**(命中即复原字节、RIP 拨回、拆断点);单步重布实测
与其它线程执行同一地址竞态必崩。文档按最终实现重写。
* `LINUX_SUPPORT.md` 末尾一条重复说明合并。
上一版 PR 只有手工实测,没有自动化闸门。新增 tests/test_linux_hook.py: * 注册与闸门:Linux 上必须进 STRATEGY_REGISTRY 且计入 _PROCESS_DEPENDENT; 非 Linux 不得注册;模块在任何平台都能 import;非 x86-64 直接跳过。 * 候选解析:shim 的 hit-raw / hit-flat0 / hit-flat8 三种布局都要抓到 32 字节 候选,短数据与杂行必须忽略。 * 派生校验:用真实 SQLCipher page-1 HMAC 口径造夹具,正确 passphrase 派生全部 密钥并标 attrib=linux_hook;错误 passphrase 0 命中且不污染 key_map。 * ELF 定位:非 ELF、无锚点二进制抛 HookNotFoundError(不许崩);本机有微信时 真实二进制必须算得出偏移(偏移与构建绑定,不写死数值)。 * shim 构建:有系统 cc/gcc 时现场编译 wxhook.c 成功,并校验 sigaction / __libc_sigaction / __sigaction 真导出(漏导出 = crashpad 一装处理器断点变 致命信号)。 * KDF 参数钉死 256000 / sha512 / 32,且与 macos_lldb 策略同源,防止两条链路 各写一份不同的值。 本机(UOS/Deepin + 微信 4.1.13.23)实测:17 条全过(1 条非 Linux 用例按平台 skip), 全量 733 passed / 11 skipped。
真机三账号实测:当前登录账号 25/25 命中;另外两个账号目录(各 16 库)0/16, 因为它们不在登录态、没有对应的 WCDB passphrase 可抓。这条边界写进文档, 避免被当成 bug 提 issue。
多账号机器上 extract 会按账号目录逐个跑策略:第一个账号命中 25/25 之后, 对没有登录态的第二个账号又完整走了一遍"停微信 → 注入 → 拉起 → 等 300 秒"。 结果是用户正在用的微信被第二次杀掉,而那个账号本来就不可能抓到,只能空等 到超时;期间 systemd 用户环境的 LD_PRELOAD 也一直挂着不还原。 改动: - 新增 _account_is_live():扫 /proc/*/fd,看有没有进程打开该账号 db_storage 下的文件,作为"该账号此刻是否登录"的判据。 - 新增模块级 _ATTEMPTED:一次 extract 里"停微信 + 注入"最多一次。已注入过 之后再遇到未登录账号,直接打印"该账号当前未登录…跳过",不解析二进制、 不碰微信。 - _wait_for_candidates() 增加 alive 探针:启动宽限 20 秒(dde-am → 瞬态单元 有延迟),一旦微信出现过又消失就立刻结束等待,让 finally 马上还原 systemd 用户环境,不再拖到超时之后。 测试:tests/test_linux_hook.py 新增 3 条闸门(未登录账号不得调用 _stop_wechat/_launch_wechat;第一个账号仍要引导拉起;微信消失时等待须 提前返回)。全量 736 passed, 11 skipped。
CI 的 test job 覆盖 windows-latest(3.10/3.11/3.12) 与 macos-latest。 `extract()` 在非 Linux 上第一步就 return 0,所以断言 _stop_wechat / _launch_wechat 被调用的用例会在那两个平台必红。按文件既有约定加 skipUnless(platform.system() == "Linux");纯逻辑的等待提前返回用例 仍全平台跑。
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
这个 PR 做什么
Linux 平台的密钥提取:全程无 ptrace、不需要 root,在微信进程内打一次性 INT3 断点抓 WCDB passphrase,再用 PBKDF2-SHA512(256000) 派生每库密钥,并逐库做 page-1 HMAC 校验后才入库。
为什么不用 ptrace
微信 4.1.2x 内置 Chromium crashpad 自己会
scoped_ptrace_attach;一个进程只能有一个 tracer,外部抢先附加后 crashpad 附加失败直接abort()(SIGABRT)。把kernel.yama.ptrace_scope设成 0 也一样;也不是断点打歪——只 attach 不打断点时进程能活,一旦保持被 trace 就死。实现要点
siwx/linux_hook/elfhook.py):.rodata里找com.Tencent.WCDB.Config.Cipher锚点,顺 RIP 相对lea交叉引用定位 cipher-config 消费函数,得到相对镜像基址的偏移(本机微信 4.1.13.23 为0x87ac370)。定位失败抛HookNotFoundError,不会静默 0 命中。siwx/linux_hook/wxhook.c,现场用系统cc编译,不新增 Python 依赖):构造函数用dl_iterate_phdr取 PIE 基址,把base+偏移的首字节改成INT3,注册自己的SIGTRAP处理器,并导出/拦截sigaction与__libc_sigaction(否则 crashpad 一旦装自己的 SIGTRAP 处理器就会把我们顶掉,INT3 落到对方手里,进程按致命信号被杀)。ucontext取REG_RSI/REG_RDX,按三种入参布局各读 32 字节写入日志当候选;复原原字节、把 RIP 拨回断点让原指令照常执行,随即拆点。一次性布点,避免早期"置 TF 单步后重布"与其它线程执行同一地址的竞态。LD_PRELOAD会被丢掉,所以走systemctl --user set-environment;保存原值、结束时精确还原。没有用户 systemd 会话时退化为带环境变量直接执行,且优先经dde-am启动器(官方 deb 布局下直启二进制会 SIGABRT)。siwx/strategies/linux_hook.py):只在platform.system() == "Linux"时注册进STRATEGY_REGISTRY并计入_PROCESS_DEPENDENT;非 Linux 不 import。相对已关闭的 #35 / #37
#35、#37 已关闭。本分支基于 main 的 v5.1.0(
d7843f8)重新整理,并新增两处修复:extract里"停微信 + 注入"最多一次。已注入过之后再遇到没有登录态的账号(判据:有没有进程打开该账号的db_storage),直接打印"该账号当前未登录…跳过",不再关一次微信、也不再空等 300 秒超时。finally还原 systemd 用户环境,不再把LD_PRELOAD挂到超时之后。实测(UOS/Deepin,微信 4.1.13.23,x86-64)
contact.db6827 联系人、session.db525 会话、sns.db829 条朋友圈、message_0.db405 张表LD_PRELOAD/WXS_HOOK_LOG残留,临时 shim 目录已删,断点已拆测试
tests/test_linux_hook.py:19 passed, 1 skipped(skip 为"非 Linux 不注册")extract()的两条用例带skipUnless(Linux);CI 的 test job 覆盖 windows-latest(3.10/3.11/3.12) 与 macos-latest,已用"import 前 patchplatform.system为 Darwin"验证——2 条 skip、0 失败影响面
extract()的平台闸门在该策略之前。功能零变化,测试多两条 skip。已知边界(已写入
LINUX_SUPPORT.md)cc/gcc;偏移随微信构建变化,升级后重算