Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/scapy-unroot/scapy_unroot
Daemon and tooling to enable using scapy without root permissions.
https://github.com/scapy-unroot/scapy_unroot
pypi scapy scapywithoutroot
Last synced: about 2 months ago
JSON representation
Daemon and tooling to enable using scapy without root permissions.
- Host: GitHub
- URL: https://github.com/scapy-unroot/scapy_unroot
- Owner: scapy-unroot
- License: gpl-3.0
- Created: 2020-05-04T10:27:24.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2020-05-04T10:50:21.000Z (over 4 years ago)
- Last Synced: 2024-10-11T09:19:00.141Z (3 months ago)
- Topics: pypi, scapy, scapywithoutroot
- Language: Python
- Homepage: https://pypi.org/project/scapy-unroot/
- Size: 207 KB
- Stars: 7
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-scapy - scapy\_unroot - Tooling to use Scapy without root permissions. (Tools)
README
[![Supported Python versions]](https://pypi.org/project/scapy-unroot)
[![PyPI version]](https://badge.fury.io/py/scapy-unroot)
[![Build Status]](https://travis-ci.com/scapy-unroot/scapy_unroot)
[![codecov]](https://codecov.io/gh/scapy-unroot/scapy_unroot)
[PyPI version]: https://badge.fury.io/py/scapy-unroot.svg
[Supported Python versions]: https://img.shields.io/pypi/pyversions/scapy-unroot.svg
[Build Status]: https://travis-ci.com/scapy-unroot/scapy_unroot.svg?branch=master
[codecov]: https://codecov.io/gh/scapy-unroot/scapy_unroot/branch/master/graph/badge.svg
# scapy-unroot
Daemon and tooling to enable using [scapy] without root permissions.
## Installation
`scapy_unroot` can be installed by just running
```sh
pip install scapy_unroot
```
The requirements also installed by this are listed in
[`requirements.txt`](./requirements.txt).
## Usage
### The `scapy-unroot` daemon
The daemon to allow usage of scapy without root permissions requires root
itself. You can start it with the following command:
```sh
sudo scapy-unroot scapy
```
The provided argument `scapy` should be a permission group, users who are
allowed to use scapy without root permissions should be in.
By default, all files related to `scapy_unroot` are managed in the directory
`/var/run/scapy-unroot`. You can change that directory using the `-r` /
`--run-dir` argument:
```sh
sudo scapy-unroot --run-dir /tmp scapy
```
The UNIX domain socket to communicate with the daemon will be created under the
name `server-socket` in that directory.
Network interfaces that users of `scapy_unroot` should not be able to send over
or sniff on can be blacklisted using the `-b` / `--interface-blacklist`
argument. Multiple interfaces can be provided:
```sh
sudo scapy-unroot scapy --interface-blacklist wlan0 eth0 lo
```
To run the daemon in background, use the `-d` / `--daemonize` parameter:
```sh
sudo scapy-unroot -d scapy
```
To get more information on the arguments of the `scapy-unroot` daemon, run
```sh
sudo scapy-unroot -h
```
All arguments described above can be combined.
### Configuring scapy to communicate with the daemon
Before sending or sniffing with scapy, just do
```py
from scapy_unroot import configure_sockets
configure_sockets()
```
You can provide a different server address by the _server_addr_ argument. The
default is `/var/run/scapy_unroot/server-socket`.
You can also configure the timeout for waiting for a reply from the server using
the _connection_timeout_ argument.
[scapy]: https://scapy.net/