Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/matheusphalves/scapy4dummy
Network Operations using Scapy Framework
https://github.com/matheusphalves/scapy4dummy
cybersecurity network-analysis scapy
Last synced: 8 days ago
JSON representation
Network Operations using Scapy Framework
- Host: GitHub
- URL: https://github.com/matheusphalves/scapy4dummy
- Owner: matheusphalves
- License: mit
- Created: 2022-07-21T02:31:00.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2022-08-31T00:21:58.000Z (over 2 years ago)
- Last Synced: 2024-11-08T16:16:20.059Z (2 months ago)
- Topics: cybersecurity, network-analysis, scapy
- Language: Python
- Homepage:
- Size: 21.5 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# scapy4dummy
It's never been so simple to use Scapy in cybersecurity purposes.
# **Operations Available**
- Arp scan
- Port scan
# **Dependency requirements**
```
scapy
```
# **Installing dependencies**
Please run the following commands
```
pip install -r requirements.txt
```
# **Getting started**
## Instaling scapy4dummy locally
After clone this repository, check the following examples
> Running a ARP scan
```
from scapy4dummy.operations.ArpScanner import ArpScanner
scan_result = ArpScanner.send_arp_packet(target_ip='192.168.5.1/24', timeout=10)
clients = ArpScanner.get_clients(arp_result=scan_result)
print(clients)
```
Output example:
```
{
"192.168.1.1/24": {
"clients": [
{
"ip_address": "192.168.1.1",
"mac_address": "ff:ff:ff:ff:ff:ff"
},
{
"ip_address": "192.168.1.102",
"mac_address": "ff:ff:ff:ff:ff:ff"
}
]
}
}
```
> Running a PORT scan
```
from scapy4dummy.operations.PortScanner import PortScanner
ip_target_list = ['192.168.5.1', 'www.google.com']
port_list = [25, 80, 443, 8080]
scan_result = PortScanner.start_full_scan(ip_target_list, port_list, timeout=10, verbose=False)
print(scan_result)
```
Output example:
```
{
"192.168.5.1": {
"tcp_scan": [
{
"dst_port": 25,
"status": "Closed"
},
{
"dst_port": 80,
"status": "Open"
},
{
"dst_port": 443,
"status": "Closed"
},
{
"dst_port": 8080,
"status": "Closed"
}
],
"udp_scan": [
{
"dst_port": 25,
"status": "Closed"
},
{
"dst_port": 80,
"status": "Closed"
},
{
"dst_port": 443,
"status": "Closed"
},
{
"dst_port": 8080,
"status": "Closed"
}
]
},
"www.google.com": {
"tcp_scan": [
{
"dst_port": 25,
"status": "Filtered"
},
{
"dst_port": 80,
"status": "Open"
},
{
"dst_port": 443,
"status": "Open"
},
{
"dst_port": 8080,
"status": "Filtered"
}
],
"udp_scan": [
{
"dst_port": 25,
"status": "Open|Filtered"
},
{
"dst_port": 80,
"status": "Open|Filtered"
},
{
"dst_port": 443,
"status": "Open|Filtered"
},
{
"dst_port": 8080,
"status": "Open|Filtered"
}
]
}
}
```
# **Project structure**
```
project/
scapy4dummy/
exceptions/
OperationErrorException.py
operations/
ArpScanner.py
PorScanner.py
requirements.txt
.gitignore
setup.py
LICENSE
README.md
```
# **Modules description**
## **Operations**
### **ArpScanner**
```send_arp_packet```: Send a ARP request and returns all hosts responses.
```get_clients```: Handle the host responses, getting their IP and MAC addresses.
```start_scan```: Run a combined ARP request and retrives all clients.
### **PortScanner**
```tcp_scan```: Performs a TCP scan. Basically, send a SYN flag.
```udp_scan```: Performs an UDP scan.
```start_full_scan```: Run a combined TCP + UDP scan.
## **Utils**
### **FileHandler**
Class is responsable for store all data obtained from scans.