OhMyKeymint如何Hook系统服务?binder ioctl拦截原理深度剖析

原创2026-11-12 16:08:361,921 阅读

OhMyKeymint如何Hook系统服务?binder ioctl拦截原理深度剖析

OhMyKeymint(OMK) 是一个完整的 Android Keystore 自定义实现,它通过一个独立的 injector 组件,对系统 keystore2 进程进行注入,并在其内部对 binder 驱动的 ioctl 系统调用进行PLT 拦截,从而在用户态"偷听并重写"所有进出 KeyMint 服务的 IPC 通信。这篇文章面向新手,用尽量少的代码讲清楚:它为什么必须 Hook 系统服务、注入是怎么完成的、ioctl 拦截如何工作,以及拦截之后数据流去了哪里。

一、为什么必须 Hook 系统服务?

先理解背景:Android 上 App 使用密钥时,并不是直接读文件,而是通过 binder IPC 调用系统服务 keystore2,后者再转交给底层的 KeyMint(TEE/StrongBox 或软实现)。

关键点:所有"设备信息""密钥认证证书"等敏感回答,都走这条 binder 通道。

OMK 的目标,是让被选中的 App 拿到一套"干净"的 Keystore 实现。要做到这一点,它不能简单替换 keystore2 进程(那会影响整个系统),而是选择在 keystore2 进程内部拦截它和外界的所有 binder 通信,按需把请求"改道"到自己的实现上。

App ──binder──► keystore2(被注入)──改道──► OMK 服务
                      │
                      └── 默认透传 ──► 原生 System KeyMint

这套 Hook 逻辑全部集中在 injector/src/hook/ 模块下,入口在 injector/src/main.rs 的 entry() 函数里调用 hook::init_hook()。

二、注入流程:先把自己塞进 keystore2

Hook 之前,injector 得先进入目标进程。它分两步(见 injector/src/inject.rs):

  1. ptrace attach:用 ptrace::attach(pid) 附加到 keystore2 进程并暂停它。
  2. 远程 dlopen:在远端进程栈上构造参数,调用 android_dlopen_ext 加载 OMK 的 payload 库(一个随机命名的 lib*.so),然后通过 dlsym 找到并执行 entry 符号。

注入完成后,entry() 在目标进程内运行,初始化日志、读取配置,并调用 hook::init_hook() 安装拦截钩子。整个过程结束后恢复寄存器、detach 退出,对 keystore2 无感。

细节亮点:payload 的 fd 是通过 Unix socket 的 SCM_RIGHTS 机制跨进程传递的(见 injector/src/inject/payload_fd.rs),避免了在目标机器上留下明文路径依赖。

三、PLT Hook:改写谁?改写哪里?

真正的 Hook 安装逻辑在 injector/src/hook/install.rs 的 install_hooks():

  • 定位目标库:读取本进程的 /proc/self/maps,找出所有名为 libbinder* 或 libhwbinder.so 的加载映像,用 ElfImageSelector(device+inode)精确定位每一个 binder 库实例。
  • 选择符号:对每个 binder 库,要求(required)Hook ioctl/__ioctl 与 close/__close,外加 android_fdsan_close_with_tag;可选(optional)Hook dup/dup2/dup3/fcntl。
  • 原子提交:通过 omhook::install_hook_groups 批量提交,成功后把原函数指针保存到 OLD_IOCTL/OLD_CLOSE 等全局原子指针(定义在 injector/src/hook/mod.rs)。

为什么 Hook ioctl?因为 Android 的 binder 驱动完全通过 ioctl(fd, BINDER_WRITE_READ, ...) 这一个入口驱动:发请求、收响应全走它。Hook 住这里,就等于拿到了 KeyMint 通道的总闸。

替换函数 new_ioctl 定义在 injector/src/hook/intercept/ioctl.rs。

四、ioctl 拦截的核心原理

new_ioctl 的执行逻辑可以概括为一条"影子缓冲"流水线:

  1. 过滤非 binder 请求:如果 request != BINDER_WRITE_READ(常量 0xc0306201,定义在 injector/src/hook/binder.rs),直接透传给原 ioctl。
  2. fd 世代校验:通过 synchronize_binder_fd_generation 跟踪 binder fd 的"世代",防止 fd 复用导致状态串台(fd 生命周期管理在 injector/src/hook/intercept/fd.rs)。
  3. 把用户态缓冲拷出到影子缓冲:把 binder_write_read 里的 write buffer 复制到 injector 自己的内存(host_write),read buffer 则稍后处理。这样对缓冲的改写不会污染内核视图,改错了可以丢弃。
  4. 改写写缓冲(请求方向):prepare_write_buffer + parse_prepared_write_buffer 解析 binder 命令流(BC_TRANSACTION 等),对需要改道的出站请求提前准备 OMK 侧的响应缓冲。
  5. 调用原始 ioctl:把影子 bwr 指针交给真正的内核调用,拿到 write_consumed/read_consumed 计数,并做合法性校验(非法则置 EPROTO)。
  6. 解析读缓冲(响应方向):parse_read_buffer(injector/src/hook/intercept/ioctl/read.rs)逐条解析内核填回的 binder 命令:
    • BR_TRANSACTION:新到达的请求 → 交给 handle_br_transaction 路由决策;
    • BR_REPLY:对端响应 → 完成挂起的同步事务状态;
    • BR_ACQUIRE / BR_TRANSACTION_COMPLETE 等:维护 binder 对象引用与事务完成。
  7. 回写结果:把改写后的 read buffer 与消耗计数拷回进程内存;若回写失败,进入 PENDING_IOCTL_COPYBACKS 挂起队列,在下一次同一 fd 的 ioctl 上重试——保证不丢数据、不乱序。

这种"拷出—改写—原样调用—校验—拷回"的设计,是整篇原理里最核心的部分:它让 Hook 层可以安全地篡改 IPC 内容,同时保留随时"放弃改写"的能力。

五、拦截之后:请求如何被"改道"

拿到一条 binder 事务后,路由决策在 injector/src/hook/rewrite/request.rs 的 handle_br_transaction 中完成:

  1. 识别接口:解析 parcel 里的 AIDL 接口名,只处理 5 个已知 Keystore 接口(IKeystoreService、IKeystoreOperation 等,清单在 injector/src/identify.rs 顶部),其余流量原样放行。
  2. 提取调用者:从 binder_transaction_data 中取出 sender_pid/sender_euid 和 SELinux 上下文,构造 CallerInfo。
  3. 过滤决策:filter::evaluate(injector/src/filter.rs)根据配置里的 scoop 应用白名单、Android 系统包阻断规则、未知包策略,给出 FilterDecision。
  4. 路由:RouteTarget::Omk 或 RouteTarget::System(见 injector/src/hook/rewrite.rs)——

整个"改道"对 keystore2 完全透明:它以为自己在和系统 KeyMint 对话,实际上收到的是 OMK 合成的响应。

六、工程细节:让它"看起来正常"的几个设计

  • BypassGuard 防重入:injector 自己通过 binder 调用 OMK 时,用 injector/src/forward.rs 的 BypassGuard 进入旁路模式,避免自己的流量又被拦截,造成死循环。
  • fd 世代与连接生命周期:BinderFdLifecycle 用引用计数 + 世代号管理每条 binder 连接,close/dup/fcntl 也被 Hook,确保连接销毁时清理挂起状态。
  • 事务影子缓冲:入站事务的 parcel 会先做 TransactionPayloadShadow 拷贝再解析(见 injector/src/hook/intercept.rs 中 TransactionPayloadShadow 实现),解析失败可整体回滚,不破坏内核协议状态。
  • 权限最小化:模块只需要 keystore 域能读写自己的 socket 和文件,规则见 template/sepolicy.rule;注入走 ptrace,要求 root 框架环境(KernelSU / Magisk)。

七、总结:一次请求的完整旅程

用一句话串起全文:

injector 用 ptrace 把自己 dlopen 进 keystore2,改写 libbinder 的 ioctl PLT 槽位;此后每一次 BINDER_WRITE_READ 都会被拷出到影子缓冲,请求侧按 scoop 白名单决定透传还是转给 OMK,响应侧则可能注入 OMK 合成的 parcel——全程 keystore2 与 App 毫无察觉。

阶段 位置 关键函数
进程注入 injector/src/inject.rs inject_library → 远端 dlopen
Hook 安装 injector/src/hook/install.rs install_hooks
ioctl 拦截 injector/src/hook/intercept/ioctl.rs new_ioctl
响应解析 injector/src/hook/intercept/ioctl/read.rs parse_read_buffer
路由决策 injector/src/hook/rewrite/request.rs handle_br_transaction
白名单过滤 injector/src/filter.rs evaluate

想继续深挖的话,建议按这个顺序读源码:inject.rs(怎么进)→ hook/install.rs(Hook 谁)→ hook/intercept/ioctl.rs(怎么拦)→ hook/rewrite/(拦下来之后去哪)。配置项(scoop 白名单、<a href="https://link.gitcode.com/i/7621cac29e0160dbb5404a1d13a72f60" target="_blank">intercept] 开关)的行为说明见 [docs/CONFIGURATION.md,常见问题见 docs/FAQ.md。

提示:OMK 仅覆盖 Keystore/KeyMint 这一层,它不隐藏 root,也不是通用的完整性检测绕过方案;拦截范围越小,系统稳定性越好——这也是它默认严格白名单的原因。

登录后查看全文
OhMyKeymint