OhMyKeymint如何Hook系统服务?binder ioctl拦截原理深度剖析
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):
- ptrace attach:用
ptrace::attach(pid)附加到keystore2进程并暂停它。 - 远程 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)Hookdup/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 的执行逻辑可以概括为一条"影子缓冲"流水线:
- 过滤非 binder 请求:如果
request != BINDER_WRITE_READ(常量0xc0306201,定义在 injector/src/hook/binder.rs),直接透传给原ioctl。 - fd 世代校验:通过
synchronize_binder_fd_generation跟踪 binder fd 的"世代",防止 fd 复用导致状态串台(fd 生命周期管理在 injector/src/hook/intercept/fd.rs)。 - 把用户态缓冲拷出到影子缓冲:把
binder_write_read里的 write buffer 复制到 injector 自己的内存(host_write),read buffer 则稍后处理。这样对缓冲的改写不会污染内核视图,改错了可以丢弃。 - 改写写缓冲(请求方向):
prepare_write_buffer+parse_prepared_write_buffer解析 binder 命令流(BC_TRANSACTION等),对需要改道的出站请求提前准备 OMK 侧的响应缓冲。 - 调用原始 ioctl:把影子
bwr指针交给真正的内核调用,拿到write_consumed/read_consumed计数,并做合法性校验(非法则置EPROTO)。 - 解析读缓冲(响应方向):
parse_read_buffer(injector/src/hook/intercept/ioctl/read.rs)逐条解析内核填回的 binder 命令:BR_TRANSACTION:新到达的请求 → 交给handle_br_transaction路由决策;BR_REPLY:对端响应 → 完成挂起的同步事务状态;BR_ACQUIRE/BR_TRANSACTION_COMPLETE等:维护 binder 对象引用与事务完成。
- 回写结果:把改写后的 read buffer 与消耗计数拷回进程内存;若回写失败,进入
PENDING_IOCTL_COPYBACKS挂起队列,在下一次同一 fd 的ioctl上重试——保证不丢数据、不乱序。
这种"拷出—改写—原样调用—校验—拷回"的设计,是整篇原理里最核心的部分:它让 Hook 层可以安全地篡改 IPC 内容,同时保留随时"放弃改写"的能力。
五、拦截之后:请求如何被"改道"
拿到一条 binder 事务后,路由决策在 injector/src/hook/rewrite/request.rs 的 handle_br_transaction 中完成:
- 识别接口:解析 parcel 里的 AIDL 接口名,只处理 5 个已知 Keystore 接口(
IKeystoreService、IKeystoreOperation等,清单在 injector/src/identify.rs 顶部),其余流量原样放行。 - 提取调用者:从
binder_transaction_data中取出sender_pid/sender_euid和 SELinux 上下文,构造CallerInfo。 - 过滤决策:
filter::evaluate(injector/src/filter.rs)根据配置里的scoop应用白名单、Android 系统包阻断规则、未知包策略,给出FilterDecision。 - 路由:
RouteTarget::Omk或RouteTarget::System(见 injector/src/hook/rewrite.rs)——- 命中 OMK:injector 通过 RPC(injector/src/ipc.rs)把请求转发给独立的 OMK keymint 服务,再合成一条 binder 响应注入回
keystore2(BC_REPLY准备逻辑在 injector/src/hook/rewrite/pending.rs); - 未命中:原样透传给系统 KeyMint。
- 命中 OMK:injector 通过 RPC(injector/src/ipc.rs)把请求转发给独立的 OMK keymint 服务,再合成一条 binder 响应注入回
整个"改道"对 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 的
ioctlPLT 槽位;此后每一次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,也不是通用的完整性检测绕过方案;拦截范围越小,系统稳定性越好——这也是它默认严格白名单的原因。