steven/hyp

History

Steven Polley b318bcb3c1 All checks were successful continuous-integration/drone/push Build is passing Details invert conditionals, removing crazy nesting Thank you code aesthetic		2024-05-09 20:17:02 -06:00
..
bpf_endian.h	enter eBPF, libpcap and CGO = bloat	2024-04-13 21:22:22 -06:00
hyp_bpf_bpfeb.go	added generated go code from ebpg-go	2024-04-14 21:03:22 -06:00
hyp_bpf_bpfel.go	added generated go code from ebpg-go	2024-04-14 21:03:22 -06:00
hyp_bpf.c	invert conditionals, removing crazy nesting	2024-05-09 20:17:02 -06:00
packet.go	Add support for timeout action	2024-04-20 15:41:26 -06:00
README.md	README add/edit	2024-04-16 20:09:37 -06:00
vmlinux.h	enter eBPF, libpcap and CGO = bloat	2024-04-13 21:22:22 -06:00

README.md

hypd server

hypd is the port knocking daemon which runs on an edge device connecting to an untrusted network. Leveraging eBPF's XDP hook point, it extracts header information directly and sends to userspace the specific information required. This method is faster than alternative methods such as using libpcap.

eBPF

The hyp_bpf.c program can be recompiled using go generate.

# Debian: sudo apt install git clang linux-headers-amd64 libbpf-dev
go generate .

Generating vmlinux.h

vmlinux.h is included in hyp_bpf.c and can be regenerated with bpftool.

# Debian: sudo apt install bpftool
sudo bpftool btf dump file /sys/kernel/btf/vmlinux format c > ../headers/vmlinux.h

Building hypd

hypd has no CGO dependencies and so can run on musl systems as well.

# To ensure it can run on  systems don't use CGO
CGO_ENABLED=0 go build .