Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/containers/oci-seccomp-bpf-hook

OCI hook to trace syscalls and generate a seccomp profile
https://github.com/containers/oci-seccomp-bpf-hook

bcc containers oci seccomp-profile syscalls

Last synced: 2 months ago
JSON representation

OCI hook to trace syscalls and generate a seccomp profile

Host: GitHub
URL: https://github.com/containers/oci-seccomp-bpf-hook
Owner: containers
License: apache-2.0
Created: 2019-09-21T14:31:03.000Z (almost 5 years ago)
Default Branch: main
Last Pushed: 2024-02-16T11:56:36.000Z (4 months ago)
Last Synced: 2024-02-17T10:26:40.275Z (4 months ago)
Topics: bcc, containers, oci, seccomp-profile, syscalls
Language: Go
Homepage:
Size: 4.16 MB
Stars: 271
Watchers: 14
Forks: 33
Open Issues: 2
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE-OF-CONDUCT.md
- Security: SECURITY.md

Lists

awesome-linux-containers - oci-seccomp-bpf-hook
awesome-containerized-security - oci-seccomp-bpf-hook
awesome-software-supply-chain-security - containers/oci-seccomp-bpf-hook: OCI hook to trace syscalls and generate a seccomp profile
awesome-linux-containers - oci-seccomp-bpf-hook
awesome-cloud-security - oci-seccomp-bpf-hook - Terratest is a Go library that makes it easier to write automated tests for your infrastructure code. (蓝队工具 / 云原生相关工具)

README

        [![Build Status](https://api.cirrus-ci.com/github/containers/oci-seccomp-bpf-hook.svg)](https://cirrus-ci.com/github/containers/oci-seccomp-bpf-hook/main)

# oci-seccomp-bpf-hook

This project provides an OCI hook to generate seccomp profiles by tracing the syscalls made by the container. The generated profile would allow all the syscalls made and deny every other syscall.

The syscalls are traced by launching a binary by using the prestart OCI hook. The binary started spawns a child process which attaches function `enter_trace` to the `raw_syscalls:sys_enter` tracepoint using eBPF. The function looks at all the syscalls made on the system and writes the syscalls which have the same PID namespace as the container to the perf buffer. The perf buffer is read by the process in the userspace and generates a seccomp profile when the container exits.

There are a few limitations to this approach:

* Needs `CAP_SYS_ADMIN` to run

* Compiles C code on the fly

* Cannot use `podman run --rm` along with this ability

To build it, we need extra dependencies namely bcc-devel and kernel-headers for Fedora and bcc-tools and linux-headers-[..] for Ubuntu.

Interface:

```bash

sudo podman run --annotation io.containers.trace-syscall="if:[absolute path to the input file];of:[absolute path to the output file]" IMAGE COMMAND

```

The profile will be created at the output path provided to the annotation. Providing `of:` is mandatory, while `if:` is optional. An input file can be used to create a baseline and newly recorded syscalls will be added to the set and written to the output. If a syscall is blocked in the base profile, then it will remain blocked in the output file even if it is recorded while tracing.

Please refer to an article on [Enable Sysadmin](https://www.redhat.com/sysadmin/container-security-seccomp) for more details.

`Copyright {2018-2022} {containers/oci-seccomp-bpf-hook maintainers}`