Skip to content

AR-234/Tripwire

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Contributors Forks Stargazers Issues MIT License

Create a packet monitor on a server in your network that is normally not touched.
Tripwire will inform you if somebody or something does.
Explore the docs »

Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Contributing
  5. License
  6. Contact

About The Project

Tripwire Screen Shot

Tripwire is a packet sniffing tool, which should be installed on a server that is untouched in the network. It's job is to provide an early response if somebody is scanning the server.
Since the server is not in use, any traffic going towards it is suspicious.
And will trigger the tripwire..
Triggers can be a simple dump or a telegram message.
If you want any more triggers just create a issue with the idea or send it in yourself.

(back to top)

Getting Started

To get a local copy up and running follow these simple example steps.

Prerequisites

This is an example of how to list things you need to use the software and how to install them.

  • git
  • python3

You should also set the SSH Port of the machine to a non standard Port. Ports can be ignored but you wouldn't see if somebody tries to connect to Port 22.

Installation

  1. Clone the repo
git clone https://github.com/AR-234/tripwire.git
  1. Install python modules additional modules required in the trigger_example are not included
pip install -r requirements.txt
  1. Copy triggers you want from trigger_example to trigger (Some trigger do have configs in the files)

  2. Open config.py and change the settings like you need them (more in usage)

  3. Run the script with root privileges

sudo python3 tripwire.py

or set a crontab at restart

sudo crontab -e

and add this line

@reboot python3 /home/root/{installation_dir}/tripwire.py

(back to top)

Usage

Will write a detailed version the next days..

(back to top)

Roadmap

Currently nothing is really planed, but you got an idea? Open an "issue" and submit it :)

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

(back to top)

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

About

Tripwire monitors ports and icmp to send the admin a message if somebody is scanning a machine that shouldn't be touched

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages