dmap-Ursa 0.0.1

Nmap integration into Discord.

DMap

Nmap integrated in Discord for ease of scanning.
Explore the docs »

Get the code · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Words of Warning
   • Installation & Setup
3. Usage
4. Roadmap
5. Contributing
6. License
7. Contact
8. Acknowledgments

About The Project

Whether I'm working on HackTheBox challenges, or require a convenient way to scan a domain while I'm on the road, I always have access to Discord. The PoC of this project was started a few years ago, and this time a full-fledged environment will be available to all who need it. DMap intends to offer a convenient environment for scanning over a VPN connection, such as HackTheBox, remote enterprise, or CTF connections. Some functionality for creating a VPN connection to the device in order to scan local networks is in the works, but may be a bit delayed.

Why use DMap:

• Hands-on examples are more effective in teaching environments like school clubs, where students can follow along with a presenter in chat
• Simple scans can be handled in a few seconds from a mobile device or in any browser without requiring you to boot up your hacking machine
• Utilize MAC changing, IP rotation, and a sandboxed environment without effort

(back to top)

Built With

Obviously, the two major components this project utilizes are Nmap and Discord's API. A few different modules and frameworks will also be included to handle VPN connections, different kinds of scanning and recon actions, and other security-related functions; this list will grow as the program does.

• Nmap
• Discord's Python API
• OpenVPN
• PwnTools

(back to top)

Getting Started

This is an example of how you may give instructions on setting up your project locally. To get a local copy up and running follow these simple example steps.

Words of Warning

If you plan on only using this solution in another person's server, feel free to skip this bit. If you'd like to host a free-running server for your own use, please heed the following advice. Host this solution in a sandboxed environment, or on a machine/network that you have no personal stake in. I cannot stress operational security enough in an environment where there are built-in security vulnerabilities; please use this software at your own discretion (and don't sue me if someone manages to run os.system("rm -rf /") on your un-hardened machine).

Installation & Setup

When I automate the setup process, I'll add further instruction for installation and setup. For now, you'll just have to work it out on your own or use this on a Discord server.

(back to top)

Usage

This space will be filled with examples of usage as the application is built and tested. For now, I appreciate your patience and look forward to making scanning easier for you in the near future!

(back to top)

Roadmap

• Recreate basic functionality
  • Simple Nmap scans over the public internet
  • Simple scans over VPN
  • Session and scan hosting for later reference
• Automate the setup of the server
• Add various scanning options to the application
• Plan additional features
• Multi-language Support
  • Japanese
  • German
  • French
  • Spanish
  • TBD

See the open issues for any proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the GPLv3 License. See LICENSE.txt for more information.

(back to top)

Contact

Nathan Christensen - HTB Profile - [e-mail]

Project Link: https://github.com/nateac1/DMap

(back to top)

Acknowledgments

Use this space to list resources you find helpful and would like to give credit to. I've included a few of my favorites to kick things off!

• Choose an Open Source License
• GitHub Emoji Cheat Sheet
• Malven's Flexbox Cheatsheet
• Malven's Grid Cheatsheet
• Img Shields
• GitHub Pages
• Font Awesome
• React Icons

(back to top)