Skip to content

varppi/syscanary

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

This is basically tripwire, but for your server. The idea is that you set up Syscanary to monitor changes in things that would indicate a system compromise or a malfunction so you can detect and mitigate the problem(s) early on.

Features

Syscanary can currently monitor changes in:

  • File system
  • USB devices
  • Internet connectivity
  • Open ports (currently only Linux support)

Installation

sudo apt update && sudo apt install golang  
go install github.com/Varppi/syscanary/cmd/syscanary
export PATH=$PATH:~/go/bin

Usage

syscanary

Configuration

Open syscanary.json and make your configurations:

{
    "loglevel": 1, <-- 0=debug 1=info 2=error
    "logfile": "alerts.log", <-- remove if you want to have console output 
    "detections": ["usb", "integrity", "ports", "internet"], <-- remove or add modules to enable or disable them
    "modules": { <-- DO NOT REMOVE ANY MODULES FROM HERE AND DON'T LEAVE SETTINGS EMPTY!!!
        "integrity": {
            "interval": 1, <-- how many seconds it will wait before checking again
            "paths": ["/var/log"]
        },
        "usb": {
            "interval": 1
        },
        "ports": {
            "interval": 1,
            "ignorelocal": true <-- doesn't alert when local binds change
        },
        "internet": {
            "interval": 1,
            "domain": "example.com" <-- domain to test the connectivity on
        }
    }
}

Config without comments:

{
    "loglevel": 1,
    "detections": ["usb", "integrity", "ports", "internet"],
    "modules": {
        "integrity": {
            "interval": 1,
            "paths": ["/var/log"]
        },
        "usb": {
            "interval": 1
        },
        "ports": {
            "interval": 1,
            "ignorelocal": true
        },
        "internet": {
            "interval": 1,
            "domain": "example.com"
        }
    }
}

About

Alerts you when things in your system change

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages