Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/7Ragnarok7/DEDMAP
A Network Automation framework focused on Cyber-Security
https://github.com/7Ragnarok7/DEDMAP
7ragnarok7 automation cross-platform darkweb framework hacking network network-scanning networking nmap penetration-testing pentest-tool pentesting port-scanner port-scanning python tcp udp wan wan-networks
Last synced: 21 days ago
JSON representation
A Network Automation framework focused on Cyber-Security
- Host: GitHub
- URL: https://github.com/7Ragnarok7/DEDMAP
- Owner: 7Ragnarok7
- License: gpl-3.0
- Created: 2020-07-21T17:03:43.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-07-06T15:51:01.000Z (over 1 year ago)
- Last Synced: 2024-11-18T21:02:46.162Z (23 days ago)
- Topics: 7ragnarok7, automation, cross-platform, darkweb, framework, hacking, network, network-scanning, networking, nmap, penetration-testing, pentest-tool, pentesting, port-scanner, port-scanning, python, tcp, udp, wan, wan-networks
- Language: Python
- Homepage: https://7ragnarok7.github.io/DEDMAP/
- Size: 1.21 MB
- Stars: 47
- Watchers: 4
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-hacking-lists - 7Ragnarok7/DEDMAP - A Network Automation framework focused on Cyber-Security (Python)
README
[][page]
# *DEDMAP*
### Network Automation for Hackers
[](https://www.python.org) [](LICENSE) [](https://www.microsoft.com/en-us/windows) [](https://www.android.com/) [](https://www.linux.org/) [](https://developer.mozilla.org/en-US/docs/Web/API) [](https://developer.cisco.com/codeexchange/github/repo/7Ragnarok7/DEDMAP) [](https://openbase.com/python/dedmap?utm_source=embedded&utm_medium=badge&utm_campaign=rate-badge)
### One of its kind Network Automation as a Service (NaaaS).
##### DEDMAP is a ***Simple*** but ***Powerful***, ***Clever*** and ***Flexible*** Cross-Platform [Port Scanning][ps] tool made with ease to use and convenience in mind.
Both TCP and UDP protocols have 0 to 65535 ports. These 65535 ports can be divided into the following three ranges:-
- System or reserved ports: from 0 to 1023
- User or registered ports: from 1024 to 49151
- Dynamic or private ports: from 49151 to 65535
**DEDMAP** tries to scan a target IP or range of IP's and find services that are running and listening on some ports.
**DEDMAP** can also scan a range of hosts to find live hosts.
### Checkout the official DEDMAP whitepaper here --> [DEDMAP WHITEPAPER](docs/dedmap_whitepaper.pdf)
### [CODE OF CONDUCT](CODE_OF_CONDUCT.md)
### [CONTRIBUTING](CONTRIBUTING.md)
### Requirements :-
- [Python 3][py]
- [Pip][pp]
- [Termux][tm] (if installing on an android device)
- *A bit of love and care* :)
### Installation :-
- Download the latest release from [RELEASES][RELEASES]
- Extract the archive
- Follow the steps below
```sh
$ cd DEDMAP
$ chmod +x install.sh
$ ./install.sh
```
- Follow the above steps using ***termux-install.sh*** if installing for termux
All the additional requirements will be installed automatically.
Just execute the "install.sh" file ;)
The tool can be run without installing as well (./dedmap) but it is recommended to install it.
After installing the tool, the color of the **DEDMAP banner** will change from *WHITE* to *RED*.
Update the tool by downloading the latest release and re-installing it again.
### Using the tool in Windows :-
- Initially, Double-Click or launch the ***dedmap.bat*** once from a command-prompt for installing the requirements.
- Subsequent to the above step, launch the tool using `dedmap` or `python dedmap` command from a command-prompt inside the dedmap root directory.
### Uninstallation :-
- Follow the steps below
```sh
$ cd DEDMAP
$ chmod +x uninstall.sh
$ ./uninstall.sh
```
- Follow the above steps using ***termux-uninstall.sh*** if uninstalling for termux
### Highlights :-
- Full Support for Linux, Windows & Android devices (*via* termux)
- Supports web-api calls (platform-less on-demand interaction)
- World's first one of it's kind Network Automation as a Service (NaaaS)
- Easy to host & deploy as a service on the cloud / your private server.
- Packed with lots of additional features all in one place
- Supports IP-RANGES (1.1.1.1-100)
- Supports Network Scanning (Ping Sweep)
- Has a Dark-Web mode. The dark-web mode can be used to perform all the operations of dedmap seamlessly on dark-web (.onion) sites without any need of the tor browser
- Has a turbo mode (LAN mode) for network scanning. The turbo mode can be used both in LAN and wan but it is recommended to use only in LAN as it may decrease the accuracy of the scan in a wan network.
- The wan mode can also be used in a LAN network for more accurate results. Lan mode = Performance, Wan mode = Accuracy.
- Is flexible. Multiple scanning options can be combined based on requirements.
- Is clever. Scans only the live targets if a network scan is combined with other scans.
- Has a very intuitive and user-friendly Command-Line Interface. Also has a web interface for those who are not comfortable with CLI
- Lists all the probable services/protocols being used by the respective open ports which are discovered.
- Supports Verbose mode
- Supports Saving the Output to a file. (The file generated is a ***dedmap file***. cat/type it to view it's contents properly in a shell environment)
- Supports various port specification options
- Is colorful. Provides colored event-based visual responses
### LEGEND/Color schemes :-
- BLUE --> FOR MARKING THE SUCCESSFUL STARTING AND COMPLETION OF THE PROGRAM
- RED --> FOR MARKING STARTING/ENDING OF AN EVENT OR ERROR
- GREEN --> FOR MARKING A SUCCESSFUL HOST/PORT DISCOVERY AND HELP MENU
- RESET --> FOR RESETTING TO DEFAULT SHELL COLOR
- GRAY --> FOR MARKING AN UNSUCCESSFUL HOST/PORT DISCOVERY IN VERBOSE MODE
- YELLOW --> FOR MARKING DEBUGGING STATEMENTS
### Usage :-
```sh
$ dedmap [--option(s)] [target(s)]
```
- By default, a TCP scan will be performed if no options are provided.
- -t option must be exclusively provided if any other option is used like -p or -v or -n.
- By default, the top 100 commonly used ports will be scanned if no ports are specified.
- Long Options (--) have more priority.
### Options :-
- -h, --help show this help message and exit
- -b, --black turn on dark-web mode
- -s, --silent run in silent mode (remove the dedmap banner)
- -v, --verbose run in verbose mode
- -d, --dns performs a DNS lookup
- -r, --rdns performs a reverse dns lookup
- -p, --port only scan specified port(s)
- Ex: -p 21; -p 21,22,23;
- -p top10; (scan top 10 commonly used ports)
- -p top100; (scan top 100 commonly used ports)
- -p top1000; (scan top 1000 commonly used ports)
- -p system; (scan system ports from 0 to 1023)
- -p user; (scan user ports from 1024 to 49151)
- -p private; (scan private ports from 49152 to 65535)
- -p all; (scan all ports from 0 to 65535)
- -t, --tcp perform a TCP scan (default scan if NO OPTIONS are specified)
- -u, --udp perform a UDP scan (Doesn't seems to work as of now using the socket in python)
- -n, --net perform a network scan
- -m, --mode select the mode for network scan (default = wan)
- Select lan mode(turbo mode) for better scanning speeds (upto 5x)
- It is recommended to use the turbo mode only on a lan network
- as it might result in loss of accuracy in wan networks
- Ex: -nm lan; -nm wan;
- -o, --out saves the results in a file
- Ex: -o report
### Examples :-
Combine the options according to your requirements. DEDMAP is flexible and clever enough :)
```sh
$ dedmap 1.1.1.1
$ dedmap localhost
$ dedmap -d google.com yahoo.com facebook.com localhost
$ dedmap google.com
$ dedmap google.com yahoo.com
$ dedmap 1.1.1.1 2.2.2.2 3.3.3.3
$ dedmap 1.1.1.1-100 google.com (Perform a tcp scan on all the hosts without pinging to bypass firewall icmp block)
$ dedmap -tp 20 1.1.1.1
$ dedmap -tp top10 2.2.2.2
$ dedmap -tp 20,21,22 1.1.1.1
$ dedmap -nm lan -p 21 192.168.1.1-255 (Perform a tcp port scan in lan mode on all the live hosts)
$ dedmap -n 1.1.1.1-255
$ dedmap -nr 1.1.1.1-255 (Perform a reverse dns lookup on all the live targets in the network)
$ dedmap -nt 1.1.1.0-255 (To scan only the hosts which are alive in the network)
$ dedmap -o report 127.0.0.1
```
### Additional Notice :-
- The output file generated is a ***dedmap file***. Cat/Print it to view it's contents properly in a shell environment.
- This tool is expected to have lots of bugs as it is in a very early stage.
- This tool has not been tested in Windows yet and will not work most probably. Feel free to experiment.
### Disclaimer :-
- This tool is made for educational & research purpose only. Use it with/on systems or networks you own or have permission from the owner. I shall not be held responsible for whatsoever you do with this tool.
### Limitations as of now / Known Issues :-
- DEDMAP IS AN INDEPENDENT TOOL MADE FOR ONLY PORT-SCANNING AS IT'S MAIN GOAL. HENCE IT WILL NEVER SUPPORT FEATURES LIKE SERVICE/VERSION SCAN AS THEY DEPEND UPON NETCAT.
- GENERATING A REPORT DOES NOT WORK PROPERLY IN WINDOWS.
- IS SLOW AS NO MULTI-THREADING CONCEPTS USED IN THE PROGRAM YET.
- UDP DOESN'T WORKS PROPERLY AS OF NOW.
- THE USER MUST MAINTAIN A SEQUENCE "dedmap [--option(s)] [target(s)]"
- THE TOOL SUPPORTS IP-RANGE ONLY IN THE LAST OCTET .i.e 1.1.1.(1-200) --> This is also a safety measure to prevent the user from scanning the ENTIRE INTERNET (1-255.1-255.1-255.1-255) and blowing up his/her NIC, RAM, CPU and HARDDISK :p (pun intended)
### To Do :-
- ~~[ ] FIX UDP SCANNING~~
- [x] ADD COLORS TO THE REST OF THE OUTPUT TO PROVIDE EVENT-BASED VISUAL RESPONSES.
- [x] TEST AND ADD SUPPORT FOR TERMUX
- [x] TEST AND ADD SUPPORT FOR WINDOWS
- [ ] USE MULTITHREADING TO DRASTICALLY IMPROVE THE PERFORMANCE OF THE TOOL
### Reporting :-
- Report BUGS at [(https://github.com/7Ragnarok7/DEDMAP/issues)](https://github.com/7Ragnarok7/DEDMAP/issues)
- Reporting guide/template [can be found here.](https://github.com/7Ragnarok7/DEDMAP/tree/main/.github/ISSUE_TEMPLATE)
### Feedback :-
- Share your feedback and discuss about the project at [(https://github.com/7Ragnarok7/DEDMAP/discussions)](https://github.com/7Ragnarok7/DEDMAP/discussions)
[//]: # "References below:-"
[ps]:
[py]:
[pp]:
[page]:
[tm]:
[RELEASES]: