Welcome to crouching_tiger 👋

A lofty attempt towards automating attacks on wireless targets only periodically available.

Goals

There are several of goals/ideal the project would like to achieve. They are:

• Maintain a low footprint and system load
• The ability to spawn attack vectors when an AP or client is available.
• Run in the background for an indefinite period of need be.

IMPORTANT NOTE

YOU MUST HAVE ROOT PERMISSION TO USE

Install

To install the script you have several options at your disposal. The only "frivolous" dependency is the lovely art package for python. If you are interested in this script at all, then you more than likely already have scapy installed on your system. Since all of these were already available on my system, no installation was necessary. But for inquiring minds, the installation process is as follows:

Install with poetry

A simple poetry install should install all the required packages and create the venirtual env for you. From there all that is needed is to run the script with:

sudo $(which poetry) run python3 ctiger.py -h

Install with pipenv

Similarly to poetry, pipenv install should install all the required packages and create the venirtual env for you. From there all that is needed is to run the script with:

sudo $(which pipenv) run python3 ctiger.py -h

Install with pip

This will be more tricky because you will need to install the required packages in the root user's local python library, and not the system python library. This is done by running the following commands:

sudo su
pip3 install --user -r requirements.txt
exit

From here on you will need to become the root user before running the script.

Config

The program is designed to take either flags from the command line of configuration variables from the configu file. Flags on the command line will override variables set in the configuration file. The configuration file for the program will be generated for you automatically upon first run. Once generated, can be found in /etc/ctiger/config.ini. A copy of the configuration spec is provided below:

cfg = """# Crouching Tiger Config File
# PLEASE, DO NOT LEAVE THIS FILE UNTOUCHED!
# TARGETS WILL HAVE TO BE MODIFIED IN ORDER TO WORK!
# ------------------------------------------------------------

# General Settings
# ----------------
interface = string(default='wlan0')
sniff_count = integer(min=10, max=10, default=10)
logging_level = option('INFO', 'DEBUG', default='DEBUG')
log_file = string(default='/var/log/ctiger.log')

# ------------------------------------------------------------

# Attack Settings
# ----------------
[ATTACK]
scan_file = string(default='ct_aps.csv')
mon_type = option('create', 'switch', default='switch')
use_daemon = boolean(default=False)

# -----------------------------------------------------------

# Mac Purge Setings
# -----------------
[MAC_PURGE]
if_type = option('create', 'switch', default='switch')
valid_results = string(default='ct_valid.csv')
channel_list = list(default=list(1, 6, 11))

# -----------------------------------------------------------

# Scan Settings
# ----------------
[SCAN]
save_results = boolean(default=false)
results_file = string(default='share/ct_aps.csv')
"""

The only configuration option that possibly could use some explanation is the option that defines what type of monitor interface your particular wifi card allows. Not all wireless devices allow the creation of a secondary wlanXmon interface. Some only allow for the mode of the device to be changed. This variable is where you designate this type.

Usage

All runtime flags and commands should be described in length by incuding the -h flag.

sudo $(which poetry) run python3 ctiger.py -h

Author

👤 Anoduck

• Website: http://anoduck.github.io
• Github: @anoduck

Show your support

Give a ⭐️ if this project helped you!

---

This README was generated with ❤️ by readme-md-generator