Eduardo45MP.dev logo Eduardo45MP.dev
Network security

NSA | Network Security Assistant

A modular toolkit that tests, analyses, and strengthens Wi-Fi networks with clear flows for scanning, assessment, and report generation.

View on GitHub Usage checklist
Scope
Educational audits on owned networks, focused on common vulnerability detection.
Access
Python scripts executed locally, with administrative privileges when required.
Overview

Practical auditing for home and corporate Wi-Fi networks

NSA was created to professionalise home security tests, offering clear, documented scripts that any cybersecurity enthusiast can extend.

  • Maps available networks with relevant metadata (BSSID, RSSI, channel, declared security).
  • Evaluates encryption settings, signal strength, and common risks.
  • Generates readable reports with checklists of recommendations and next steps.
  • Allows saving Wi-Fi profiles to repeat tests in regular cycles.
Technical stack

Python as the base for security automation

Networking libraries and report generation form the core of the toolkit, keeping the setup lean and portable.

Scanning and capture

Uses scapy, socket, and subprocess to gather interface information.

Monitor mode iwlist

Analysis

Customisable rules to verify encryption types, default passwords, and protection best practices.

Python ruleset config YAML (future)

Reports

Generates friendly reports with pandas, jinja2, or reportlab depending on the flow.

Export PDF/HTML Custom templates
Architecture

Modular scripts for each step of the process

Clear separation between collection, analysis, reporting, and profile management avoids tight coupling and enables isolated tests. 

NSA/
├── scan_wifi_networks.py   # Available network scanning
├── sec_analysis.py         # Security evaluation rules
├── sec_report.py           # Detailed report generation
└── wifi_profile.py         # Wi-Fi profile CRUD
Installation

Preparing the audit environment

Run the scripts on machines that support monitor mode and have the required privileges. Tests were validated on Debian-based Linux distributions.

  1. Clone the repository and create a virtual environment: 
git clone https://github.com/eduardo45MP/NSA.git
cd NSA
python3 -m venv venv
source venv/bin/activate
  1. Install suggested dependencies:
pip install -r requirements.txt  # when available
sudo apt install aircrack-ng net-tools wireless-tools
  1. Run modules as needed:
sudo python scan_wifi_networks.py
python sec_analysis.py
python sec_report.py

Adjust commands for your environment and ensure write permissions on output directories when generating reports.

Open Source

Best practices for collaboration

Contributors can expand security rules, report formats, and support for new platforms.

New heuristics

Add advanced checks to detect frequent insecure configurations.

WPA3 IoT

Report templates

Create customisable layouts with charts, checklists, and audience-specific guidance.

Markdown PDF

Automated tests

Implement unit tests and mocks to simulate results without real hardware access.

pytest tox

Before contributing, read the legal notice in the README and keep the visual identity aligned with the guides in portfolio/docs/.

Notice

Responsible use

This toolkit is intended exclusively for authorised environments. Never use it without consent; responsibility lies fully with the user.