Skip to content

Latest commit

 

History

9 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages