Giter Club home page Giter Club logo

snorter's Introduction

Snorter

Snorter in action!

Version License: GPL v3

Tricky script which mades Snort installation simply as a script execution is. The script installs:

  • Snort: Open Source IDS.
  • Barnyard2: Interpreter for Snort unified2 binary output files.
  • PulledPork: Snort rule management.
  • WebSnort: Web Interface for PCAP analysis.

Successfully tested in:

  • Raspberry Pi + Raspbian Jessie
  • Kali Linux Rolling Release
  • Debian 8.0+
  • Ubuntu 14.04 using the Snorter_Ubuntu-14.04.sh script.

Installation

Detailed install instructions.

Download

Simply run on your terminal:

git clone https://github.com/joanbono/Snorter.git
cd Snorter/src

Execution

Printing the USAGE:

bash Snorter.sh -h

OR

bash Snorter.sh --help

RECOMMENDED: Executing the script using an OINKCODE

bash Snorter.sh -o <oinkcode> -i <interface>

Docker

Edit the Dockerfile

Dockerfile content. Use your personal OINKCODE.

#Kali docker with SNORT + BARNYARD2 + PULLEDPORK
#Version 0.1.0
From kalilinux/kali-linux-docker:latest
MAINTAINER Joan Bono <@joan_bono>

ENV OINKCODE
ENV INTERFACE

RUN apt-get update && apt-get upgrade -y && apt-get install -y git curl wget
RUN git clone https://github.com/joanbono/Snorter.git /opt/Snorter
RUN /opt/Snorter/src/Snorter.sh -o ${OINKCODE} -i ${INTERFACE}
USER root
WORKDIR /opt/Snorter

Run the dockerfile

Start the docker daemon.

  • With websnort:
cd Snorter/src/
docker build SnorterDock -p 80:80 -e OINKCODE=<oinkcode> -e INTERFACE=<interface>
  • Without websnort:
cd Snorter/src/
docker build SnorterDock -e OINKCODE=<oinkcode> -e INTERFACE=<interface>

WebSnort Usage

  • Submit a pcap using the web browser:

  • Watch the alerts on the web browser:

  • Submit a pcap using the API:
curl -i --form [email protected] http://ADDRESS/api/submit


Install Instructions


Special thanks to

  • @goffinet for the rule enabler and for solving solving the systemctl issue.
  • @rbshadow for the Snorter script adapted to Ubuntu 14.04.

snorter's People

Contributors

joanbono avatar rbshadow avatar goffinet avatar mvording avatar

Watchers

FB avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.