feat(go): port process access detectors

This commit is contained in:
Luna 2026-07-10 05:19:56 -07:00
parent f02509aab5
commit fc9b5f0448
22 changed files with 554 additions and 40 deletions

View file

@ -9,7 +9,9 @@ Current scope:
- standard-library-only flat TOML loading for the settings used so far;
- an injectable `/proc` process snapshot boundary;
- a cancellable sweep loop that emits JSONL `enodia.event.v1` records;
- exact `enodia.alert.v1` parity for the `deleted_exe` detector (SID `100012`);
- exact `enodia.alert.v1` parity for `ld_preload` (SID `100011`),
`deleted_exe` (`100012`), `input_snooper` (`100032`), and
`credential_access` (`100033`);
- `enodia.status.v1` heartbeat records with no persistence or retained-alert
claims;
- a shared fixture checked against the Python detector by

View file

@ -57,9 +57,18 @@ func (a *Agent) Sweep() ([]map[string]any, error) {
timestamp := a.Now().Local().Format(time.RFC3339Nano)
alerts := make([]model.Alert, 0)
if a.Config.Enabled("ld_preload") {
alerts = append(alerts, detectors.LDPreload(state)...)
}
if a.Config.Enabled("deleted_exe") {
alerts = append(alerts, detectors.DeletedExe(state)...)
}
if a.Config.Enabled("input_snooper") {
alerts = append(alerts, detectors.InputSnooper(state, a.Config)...)
}
if a.Config.Enabled("credential_access") {
alerts = append(alerts, detectors.CredentialAccess(state, a.Config)...)
}
events := make([]map[string]any, 0, len(alerts)+1)
for _, alert := range alerts {
record, err := schema.Build("alert", alert, host, timestamp)

View file

@ -52,3 +52,31 @@ func TestDisabledDetectorEmitsStatusOnly(t *testing.T) {
t.Fatalf("unexpected events: %#v", events)
}
}
func TestSweepPreservesPythonDetectorOrder(t *testing.T) {
agent := New(config.Default(), func() (model.State, error) {
return model.State{
LDPreload: "/tmp/global.so",
Processes: []model.Process{{
PID: 42,
Comm: "dropper",
Exe: "/tmp/dropper (deleted)",
FDTargets: map[string]string{"4": "/etc/shadow", "7": "/dev/input/event3"},
}},
}, nil
})
events, err := agent.Sweep()
if err != nil {
t.Fatal(err)
}
want := []string{"ld_preload", "deleted_exe", "input_snooper", "credential_access"}
if len(events) != len(want)+1 {
t.Fatalf("unexpected events: %#v", events)
}
for index, signature := range want {
alert := events[index]["alert"].(model.Alert)
if alert.Signature != signature {
t.Fatalf("event %d: got %s, want %s", index, alert.Signature, signature)
}
}
}

View file

@ -19,12 +19,26 @@ var defaultDetectors = []string{
"first_seen", "new_listener", "new_suid", "persistence", "egress",
}
var defaultInputSnooperAllowComms = []string{
"Xorg", "Xwayland", "gnome-shell", "kwin_wayland", "sway", "Hyprland",
"systemd-logind", "input-remapper", "keyd", "kanata",
}
var defaultCredentialAccessAllowComms = []string{
"sshd", "sudo", "su", "login", "gdm-session-worker", "polkitd",
"gnome-keyring-daemon", "kwalletd5", "kwalletd6", "firefox", "chromium",
"chrome", "google-chrome", "brave", "brave-browser",
}
// Config mirrors the Phase 1 settings consumed by the Go sweep loop. More
// fields are added as their detectors are ported.
type Config struct {
SampleInterval time.Duration
HeartbeatMaxAge int
Detectors map[string]bool
SampleInterval time.Duration
HeartbeatMaxAge int
Detectors map[string]bool
InputSnooperAllowComms map[string]bool
CredentialAccessAllowComms map[string]bool
CredentialAccessExtraPaths []string
}
// Default returns Python-compatible defaults for the fields currently used.
@ -34,9 +48,12 @@ func Default() Config {
detectors[name] = true
}
return Config{
SampleInterval: 4 * time.Second,
HeartbeatMaxAge: 120,
Detectors: detectors,
SampleInterval: 4 * time.Second,
HeartbeatMaxAge: 120,
Detectors: detectors,
InputSnooperAllowComms: stringSet(defaultInputSnooperAllowComms),
CredentialAccessAllowComms: stringSet(defaultCredentialAccessAllowComms),
CredentialAccessExtraPaths: []string{},
}
}
@ -90,11 +107,37 @@ func Load(path string) (Config, error) {
for _, name := range names {
cfg.Detectors[name] = true
}
case "input_snooper_allow_comms":
names, err := stringArray(value)
if err != nil {
return Config{}, fmt.Errorf("input_snooper_allow_comms: %w", err)
}
cfg.InputSnooperAllowComms = stringSet(names)
case "credential_access_allow_comms":
names, err := stringArray(value)
if err != nil {
return Config{}, fmt.Errorf("credential_access_allow_comms: %w", err)
}
cfg.CredentialAccessAllowComms = stringSet(names)
case "credential_access_extra_paths":
paths, err := stringArray(value)
if err != nil {
return Config{}, fmt.Errorf("credential_access_extra_paths: %w", err)
}
cfg.CredentialAccessExtraPaths = paths
}
}
return cfg, nil
}
func stringSet(values []string) map[string]bool {
result := make(map[string]bool, len(values))
for _, value := range values {
result[value] = true
}
return result
}
func assignments(text string) []string {
var out []string
var current strings.Builder

View file

@ -28,6 +28,9 @@ detectors = [
"deleted_exe",
"egress",
]
input_snooper_allow_comms = ["Xorg"]
credential_access_allow_comms = ["firefox"]
credential_access_extra_paths = ["/srv/secrets/"]
unknown_future_key = true
`)
if err := os.WriteFile(path, raw, 0o600); err != nil {
@ -43,6 +46,13 @@ unknown_future_key = true
if !cfg.Enabled("deleted_exe") || !cfg.Enabled("egress") || cfg.Enabled("reverse_shell") {
t.Fatalf("unexpected detector set: %#v", cfg.Detectors)
}
if !cfg.InputSnooperAllowComms["Xorg"] || cfg.InputSnooperAllowComms["sway"] {
t.Fatalf("unexpected input allowlist: %#v", cfg.InputSnooperAllowComms)
}
if !cfg.CredentialAccessAllowComms["firefox"] || len(cfg.CredentialAccessExtraPaths) != 1 {
t.Fatalf("unexpected credential tuning: %#v %#v",
cfg.CredentialAccessAllowComms, cfg.CredentialAccessExtraPaths)
}
}
func TestMissingFileKeepsDefaults(t *testing.T) {

View file

@ -0,0 +1,104 @@
// SPDX-License-Identifier: GPL-3.0-or-later
package detectors
import (
"fmt"
"path/filepath"
"strings"
"codeberg.org/anassaeneroi/enodia-sentinal/go-agent/internal/config"
"codeberg.org/anassaeneroi/enodia-sentinal/go-agent/internal/model"
)
var exactCredentialFiles = map[string]bool{
"/etc/shadow": true, "/etc/gshadow": true, "/etc/security/opasswd": true,
}
var browserSecretNames = map[string]bool{
"logins.json": true, "key4.db": true, "Login Data": true, "Cookies": true,
}
var browserPathMarkers = []string{
"/.mozilla/", "/firefox/", "/chromium/", "/google-chrome/",
"/chrome/", "/brave", "/vivaldi/", "/edge/",
}
// CredentialAccess ports the Python credential_access detector (SID 100033).
func CredentialAccess(state model.State, cfg config.Config) []model.Alert {
alerts := make([]model.Alert, 0)
for _, process := range state.Processes {
comm := process.Comm
if comm == "" {
comm = "?"
}
if cfg.CredentialAccessAllowComms[comm] {
continue
}
for _, fd := range sortedFDs(process.FDTargets) {
target := strings.TrimSuffix(process.FDTargets[fd], " (deleted)")
kind := sensitiveCredentialKind(target, cfg.CredentialAccessExtraPaths)
if kind == "" {
continue
}
alerts = append(alerts, model.Alert{
SID: 100033,
Severity: "CRITICAL",
Signature: "credential_access",
Classtype: "credential-theft",
Key: fmt.Sprintf("cred:%d:%s", process.PID, target),
Detail: fmt.Sprintf(
"pid=%d comm=%s fd=%s has %s open: %s",
process.PID, comm, fd, kind, target),
PIDs: []int{process.PID},
})
break
}
}
return alerts
}
func sensitiveCredentialKind(path string, extraPaths []string) string {
if !strings.HasPrefix(path, "/") {
return ""
}
if exactCredentialFiles[path] {
return "system credential database"
}
if matchesExtraPath(path, extraPaths) {
return "configured credential path"
}
if strings.Contains(path, "/.ssh/") {
name := filepath.Base(path)
if strings.HasPrefix(name, "id_") || strings.HasSuffix(name, ".pem") || strings.HasSuffix(name, ".key") {
return "private SSH key"
}
}
if strings.HasPrefix(path, "/etc/NetworkManager/system-connections/") {
return "NetworkManager secret profile"
}
if browserSecretNames[filepath.Base(path)] {
lowered := strings.ToLower(path)
for _, marker := range browserPathMarkers {
if strings.Contains(lowered, marker) {
return "browser credential store"
}
}
}
return ""
}
func matchesExtraPath(path string, entries []string) bool {
for _, entry := range entries {
if entry == "" {
continue
}
if strings.HasSuffix(entry, "/") && strings.HasPrefix(path, entry) {
return true
}
if path == entry || strings.HasPrefix(path, strings.TrimRight(entry, "/")+"/") {
return true
}
}
return false
}

View file

@ -0,0 +1,32 @@
// SPDX-License-Identifier: GPL-3.0-or-later
package detectors
import (
"strings"
"testing"
"codeberg.org/anassaeneroi/enodia-sentinal/go-agent/internal/config"
"codeberg.org/anassaeneroi/enodia-sentinal/go-agent/internal/model"
)
func TestCredentialAccessMatchesKindsAndAllowlist(t *testing.T) {
cfg := config.Default()
cfg.CredentialAccessExtraPaths = []string{"/srv/secrets/"}
state := model.State{Processes: []model.Process{
{PID: 330, Comm: "hoxha", FDTargets: map[string]string{"4": "/etc/shadow"}},
{PID: 331, Comm: "collector", FDTargets: map[string]string{"5": "/home/luna/.ssh/id_ed25519"}},
{PID: 332, Comm: "firefox", FDTargets: map[string]string{"8": "/home/luna/.mozilla/firefox/a/key4.db"}},
{PID: 333, Comm: "backup", FDTargets: map[string]string{"9": "/srv/secrets/token (deleted)"}},
}}
alerts := CredentialAccess(state, cfg)
if len(alerts) != 3 {
t.Fatalf("expected three alerts, got %#v", alerts)
}
if alerts[0].Key != "cred:330:/etc/shadow" || !strings.Contains(alerts[1].Detail, "private SSH key") {
t.Fatalf("unexpected alerts: %#v", alerts)
}
if !strings.Contains(alerts[2].Detail, "configured credential path") || strings.Contains(alerts[2].Key, "(deleted)") {
t.Fatalf("deleted suffix or extra path mismatch: %#v", alerts[2])
}
}

View file

@ -0,0 +1,24 @@
// SPDX-License-Identifier: GPL-3.0-or-later
package detectors
import (
"sort"
"strconv"
)
func sortedFDs(targets map[string]string) []string {
fds := make([]string, 0, len(targets))
for fd := range targets {
fds = append(fds, fd)
}
sort.Slice(fds, func(i, j int) bool {
left, leftErr := strconv.Atoi(fds[i])
right, rightErr := strconv.Atoi(fds[j])
if leftErr == nil && rightErr == nil {
return left < right
}
return fds[i] < fds[j]
})
return fds
}

View file

@ -0,0 +1,47 @@
// SPDX-License-Identifier: GPL-3.0-or-later
package detectors
import (
"fmt"
"codeberg.org/anassaeneroi/enodia-sentinal/go-agent/internal/config"
"codeberg.org/anassaeneroi/enodia-sentinal/go-agent/internal/model"
)
var inputDevicePrefixes = []string{
"/dev/input/event", "/dev/uinput", "/dev/hidraw",
}
// InputSnooper ports the Python input_snooper detector (SID 100032).
func InputSnooper(state model.State, cfg config.Config) []model.Alert {
alerts := make([]model.Alert, 0)
for _, process := range state.Processes {
comm := process.Comm
if comm == "" {
comm = "?"
}
if cfg.InputSnooperAllowComms[comm] {
continue
}
for _, fd := range sortedFDs(process.FDTargets) {
target := process.FDTargets[fd]
if !hasAnyPrefix(target, inputDevicePrefixes) {
continue
}
alerts = append(alerts, model.Alert{
SID: 100032,
Severity: "HIGH",
Signature: "input_snooper",
Classtype: "credential-keylogging",
Key: fmt.Sprintf("input:%d:%s", process.PID, target),
Detail: fmt.Sprintf(
"pid=%d comm=%s fd=%s has input device open: %s",
process.PID, comm, fd, target),
PIDs: []int{process.PID},
})
break
}
}
return alerts
}

View file

@ -0,0 +1,21 @@
// SPDX-License-Identifier: GPL-3.0-or-later
package detectors
import (
"testing"
"codeberg.org/anassaeneroi/enodia-sentinal/go-agent/internal/config"
"codeberg.org/anassaeneroi/enodia-sentinal/go-agent/internal/model"
)
func TestInputSnooperAlertsAndHonorsAllowlist(t *testing.T) {
state := model.State{Processes: []model.Process{
{PID: 320, Comm: "hoxha", FDTargets: map[string]string{"7": "/dev/input/event3"}},
{PID: 321, Comm: "Xorg", FDTargets: map[string]string{"8": "/dev/hidraw0"}},
}}
alerts := InputSnooper(state, config.Default())
if len(alerts) != 1 || alerts[0].SID != 100032 || alerts[0].Key != "input:320:/dev/input/event3" {
t.Fatalf("unexpected alerts: %#v", alerts)
}
}

View file

@ -0,0 +1,57 @@
// SPDX-License-Identifier: GPL-3.0-or-later
package detectors
import (
"fmt"
"strings"
"codeberg.org/anassaeneroi/enodia-sentinal/go-agent/internal/model"
)
var suspiciousPreloadPrefixes = []string{
"/tmp/", "/dev/shm/", "/var/tmp/", "/run/user/", "./",
}
// LDPreload ports the global and per-process Python ld_preload detector.
func LDPreload(state model.State) []model.Alert {
alerts := make([]model.Alert, 0)
if state.LDPreload != "" {
alerts = append(alerts, model.Alert{
SID: 100011,
Severity: "CRITICAL",
Signature: "ld_preload",
Classtype: "rootkit-preload",
Key: "ldp:global",
Detail: fmt.Sprintf("/etc/ld.so.preload is non-empty: [%s]",
strings.ReplaceAll(state.LDPreload, "\n", " ")),
PIDs: []int{},
})
}
for _, process := range state.Processes {
preload := process.Environ["LD_PRELOAD"]
if preload == "" || !hasAnyPrefix(preload, suspiciousPreloadPrefixes) {
continue
}
alerts = append(alerts, model.Alert{
SID: 100011,
Severity: "CRITICAL",
Signature: "ld_preload",
Classtype: "rootkit-preload",
Key: fmt.Sprintf("ldp:%d", process.PID),
Detail: fmt.Sprintf(
"pid=%d comm=%s LD_PRELOAD=[%s]", process.PID, process.Comm, preload),
PIDs: []int{process.PID},
})
}
return alerts
}
func hasAnyPrefix(value string, prefixes []string) bool {
for _, prefix := range prefixes {
if strings.HasPrefix(value, prefix) {
return true
}
}
return false
}

View file

@ -0,0 +1,29 @@
// SPDX-License-Identifier: GPL-3.0-or-later
package detectors
import (
"testing"
"codeberg.org/anassaeneroi/enodia-sentinal/go-agent/internal/model"
)
func TestLDPreloadMatchesGlobalAndWritableProcess(t *testing.T) {
state := model.State{
LDPreload: "/tmp/global.so\n/opt/second.so",
Processes: []model.Process{
{PID: 200, Comm: "sleep", Environ: map[string]string{"LD_PRELOAD": "/tmp/evil.so"}},
{PID: 201, Comm: "safe", Environ: map[string]string{"LD_PRELOAD": "/usr/lib/libfoo.so"}},
},
}
alerts := LDPreload(state)
if len(alerts) != 2 {
t.Fatalf("expected two alerts, got %#v", alerts)
}
if alerts[0].Key != "ldp:global" || alerts[0].Detail != "/etc/ld.so.preload is non-empty: [/tmp/global.so /opt/second.so]" {
t.Fatalf("unexpected global alert: %#v", alerts[0])
}
if alerts[1].Key != "ldp:200" || alerts[1].PIDs[0] != 200 {
t.Fatalf("unexpected process alert: %#v", alerts[1])
}
}

View file

@ -7,16 +7,19 @@ package model
// Process is the subset of /proc process state needed by the first ported
// poll detectors. Fields are added as more Python detectors move across.
type Process struct {
PID int `json:"pid"`
Comm string `json:"comm"`
Cmdline string `json:"cmdline"`
Exe string `json:"exe"`
PID int `json:"pid"`
Comm string `json:"comm"`
Cmdline string `json:"cmdline"`
Exe string `json:"exe"`
Environ map[string]string `json:"environ"`
FDTargets map[string]string `json:"fd_targets"`
}
// State is one injectable detector sweep, equivalent to the Python
// SystemState boundary.
type State struct {
Processes []Process `json:"processes"`
LDPreload string `json:"ld_preload"`
}
// Alert matches enodia.alert.v1.

View file

@ -13,9 +13,24 @@ import (
"codeberg.org/anassaeneroi/enodia-sentinal/go-agent/internal/model"
)
// Paths makes host filesystem inputs injectable for parity and unit tests.
type Paths struct {
ProcRoot string
LDPreloadPath string
}
// Capture reads process state once from procRoot. Transient per-process read
// failures degrade to empty fields, matching Python's fail-open Process view.
func Capture(procRoot string) (model.State, error) {
return CaptureWithPaths(Paths{
ProcRoot: procRoot,
LDPreloadPath: "/etc/ld.so.preload",
})
}
// CaptureWithPaths reads one process view and the global preload file.
func CaptureWithPaths(paths Paths) (model.State, error) {
procRoot := paths.ProcRoot
if procRoot == "" {
procRoot = "/proc"
}
@ -31,14 +46,52 @@ func Capture(procRoot string) (model.State, error) {
}
base := filepath.Join(procRoot, entry.Name())
processes = append(processes, model.Process{
PID: pid,
Comm: strings.TrimSpace(readText(filepath.Join(base, "comm"))),
Cmdline: strings.TrimSpace(strings.ReplaceAll(readText(filepath.Join(base, "cmdline")), "\x00", " ")),
Exe: readLink(filepath.Join(base, "exe")),
PID: pid,
Comm: strings.TrimSpace(readText(filepath.Join(base, "comm"))),
Cmdline: strings.TrimSpace(strings.ReplaceAll(readText(filepath.Join(base, "cmdline")), "\x00", " ")),
Exe: readLink(filepath.Join(base, "exe")),
Environ: parseEnviron(readText(filepath.Join(base, "environ"))),
FDTargets: readFDTargets(filepath.Join(base, "fd")),
})
}
sort.Slice(processes, func(i, j int) bool { return processes[i].PID < processes[j].PID })
return model.State{Processes: processes}, nil
return model.State{
Processes: processes,
LDPreload: strings.TrimSpace(readText(paths.LDPreloadPath)),
}, nil
}
func parseEnviron(raw string) map[string]string {
result := make(map[string]string)
for _, item := range strings.Split(raw, "\x00") {
key, value, ok := strings.Cut(item, "=")
if ok {
result[key] = value
}
}
return result
}
func readFDTargets(path string) map[string]string {
result := make(map[string]string)
entries, err := os.ReadDir(path)
if err != nil {
return result
}
sort.Slice(entries, func(i, j int) bool {
left, leftErr := strconv.Atoi(entries[i].Name())
right, rightErr := strconv.Atoi(entries[j].Name())
if leftErr == nil && rightErr == nil {
return left < right
}
return entries[i].Name() < entries[j].Name()
})
for _, entry := range entries {
if target := readLink(filepath.Join(path, entry.Name())); target != "" {
result[entry.Name()] = target
}
}
return result
}
func readText(path string) string {

View file

@ -20,10 +20,24 @@ func TestCaptureUsesInjectableProcRoot(t *testing.T) {
if err := os.WriteFile(filepath.Join(proc, "cmdline"), []byte("bash\x00-i\x00"), 0o600); err != nil {
t.Fatal(err)
}
if err := os.WriteFile(filepath.Join(proc, "environ"), []byte("LD_PRELOAD=/tmp/x.so\x00A=B\x00"), 0o600); err != nil {
t.Fatal(err)
}
if err := os.Symlink("/tmp/x (deleted)", filepath.Join(proc, "exe")); err != nil {
t.Fatal(err)
}
state, err := Capture(root)
fdDir := filepath.Join(proc, "fd")
if err := os.Mkdir(fdDir, 0o700); err != nil {
t.Fatal(err)
}
if err := os.Symlink("/dev/input/event3", filepath.Join(fdDir, "7")); err != nil {
t.Fatal(err)
}
preload := filepath.Join(root, "ld.so.preload")
if err := os.WriteFile(preload, []byte("/tmp/global.so\n"), 0o600); err != nil {
t.Fatal(err)
}
state, err := CaptureWithPaths(Paths{ProcRoot: root, LDPreloadPath: preload})
if err != nil {
t.Fatal(err)
}
@ -34,4 +48,10 @@ func TestCaptureUsesInjectableProcRoot(t *testing.T) {
if got.PID != 42 || got.Comm != "bash" || got.Cmdline != "bash -i" || got.Exe != "/tmp/x (deleted)" {
t.Fatalf("unexpected process: %#v", got)
}
if got.Environ["LD_PRELOAD"] != "/tmp/x.so" || got.FDTargets["7"] != "/dev/input/event3" {
t.Fatalf("missing environment or fd state: %#v", got)
}
if state.LDPreload != "/tmp/global.so" {
t.Fatalf("unexpected global preload: %q", state.LDPreload)
}
}