Maxime-Vincent
released this
20 Nov 10:49
·
10 commits
to sPIffer_V1.0
since this release
Note
Some dependencies are needed if you choose not to install it using the requirements.sh
:
- tshark:
sudo apt-get install tshark
- iptables:
sudo apt-get install iptables
- bridge-utils:
sudo apt-get install bridge-utils
- nodejs:
sudo apt-get install nodejs
- npm:
sudo apt-get install npm
- libpam0g-dev:
sudo apt-get install libpam0g-dev
Script Description
This package configures network forwarding on a Raspberry Pi by setting up a bridge (br0) between two added Ethernet interfaces (eth1 and eth2). It also enables traffic capture beyond the bridge (br0) which is in promiscuous mode.
Key Features
- Remove Existing Bridges: The script starts by clearing any pre-existing network bridges to ensure a clean setup.
- Check Network Interfaces: It verifies the availability of the required interfaces (eth0, eth1, and eth2) to ensure they are active and ready for configuration.
- Enable IP Forwarding: The script enables IP forwarding, allowing packets to be routed between the interfaces.
- Create a Bridge: It creates a new bridge named br0 and attaches eth1 and eth2 to it, facilitating the transfer of traffic between these two interfaces.
- It launches a web server that allows the user to start capturing and downloading network traffic.
Use Case
This setup is ideal for scenarios where network traffic analysis is needed, such as monitoring for performance, security, or debugging purposes. By capturing traffic in real-time, users can gain insights into data flow and network behavior.