How eCapture works

eBPF HOOK uprobe实现的各种用户态进程的数据捕获，无需改动原程序。

SSL/HTTPS数据导出功能，针对HTTPS的数据包抓取，不需要导入CA证书。
bash的命令捕获，HIDS的bash命令监控解决方案。
mysql query等数据库的数据库审计解决方案。

eCapture Architecure

eCapture User Manual

Getting started

use ELF binary file

Download ELF zip file release , unzip and use by command ./ecapture --help.

Linux kernel version >= 4.18
Enable BTF BPF Type Format (BTF)

check your server BTF config：

cfc4n@vm-server:~$# uname -r
4.18.0-305.3.1.el8.x86_64
cfc4n@vm-server:~$# cat /boot/config-`uname -r` | grep CONFIG_DEBUG_INFO_BTF
CONFIG_DEBUG_INFO_BTF=y

tls command

capture tls text context. Setp 1:

./ecapture tls --hex

Setp 2:

curl https://github.com

bash command

capture bash command.

ps -ef | grep foo

微信公众号

自行编译

自行编译对编译环境有要求，参考原理章节的介绍。

原理

What's eBPF

eBPF

uprobe HOOK

openssl hook

本项目hook了/lib/x86_64-linux-gnu/libssl.so.1.1的SSL_write、SSL_read函数的返回值，拿到明文信息，通过ebpf map传递给用户进程。

Probes: []*manager.Probe{
    {
        Section:          "uprobe/SSL_write",
        EbpfFuncName:     "probe_entry_SSL_write",
        AttachToFuncName: "SSL_write",
        //UprobeOffset:     0x386B0,
        BinaryPath: "/lib/x86_64-linux-gnu/libssl.so.1.1",
    },
    {
        Section:          "uretprobe/SSL_write",
        EbpfFuncName:     "probe_ret_SSL_write",
        AttachToFuncName: "SSL_write",
        //UprobeOffset:     0x386B0,
        BinaryPath: "/lib/x86_64-linux-gnu/libssl.so.1.1",
    },
    {
        Section:          "uprobe/SSL_read",
        EbpfFuncName:     "probe_entry_SSL_read",
        AttachToFuncName: "SSL_read",
        //UprobeOffset:     0x38380,
        BinaryPath: "/lib/x86_64-linux-gnu/libssl.so.1.1",
    },
    {
        Section:          "uretprobe/SSL_read",
        EbpfFuncName:     "probe_ret_SSL_read",
        AttachToFuncName: "SSL_read",
        //UprobeOffset:     0x38380,
        BinaryPath: "/lib/x86_64-linux-gnu/libssl.so.1.1",
    },
    /**/
},

bash readline.so hook

hook /bin/bash readline symbol name.

How to compile

针对个别程序使用的openssl类库是静态编译，也可以自行修改源码实现。若函数名不在符号表里，也可以自行反编译找到函数的offset偏移地址，填写到UprobeOffset属性上，进行编译。笔者环境ubuntu 21.04， linux kernel 5.10以上通用。 推荐使用UBUNTU 21.04版本的linux测试。

工具链版本

golang 1.16
gcc 10.3.0
clang 12.0.0
cmake 3.18.4
clang backend: llvm 12.0.0
pahole >= v1.13
kernel config:CONFIG_DEBUG_INFO_BTF=y

最低要求 (笔者未验证)

gcc 5.1 以上
clang 9
cmake 3.14
pahole >= v1.13

编译

git clone git@github.com:ehids/ecapture.git
cd ecapture
make
bin/ecapture

参考资料

BPF Portability and CO-RE ebpfmanager v0.2.2

xinlingqudongX/ecapture