Skip to content

A Hardware Hacking Tool with Web-Based CLI That Speaks Every Protocol

add http analyze and lookup cmd to network controller

Geoe3ed7c934d93
diff --git a/src/Abstracts/ANetworkController.cpp b/src/Abstracts/ANetworkController.cpp
index 0ebb8f7a..49962324 100644
--- a/src/Abstracts/ANetworkController.cpp
+++ b/src/Abstracts/ANetworkController.cpp
@@ -14,6 +14,7 @@ ANetworkController::ANetworkController(
NvsService& nvsService,
HttpService& httpService,
ArgTransformer& argTransformer,
+ JsonTransformer& jsonTransformer,
UserInputManager& userInputManager
)
: terminalView(terminalView),
@@ -29,6 +30,7 @@ ANetworkController::ANetworkController(
nvsService(nvsService),
httpService(httpService),
argTransformer(argTransformer),
+ jsonTransformer(jsonTransformer),
userInputManager(userInputManager)
{
}
@@ -418,6 +420,10 @@ void ANetworkController::handleHttp(const TerminalCommand &cmd)
} else if (sub == "post" || sub == "put" || sub == "delete") {
terminalView.println("HTTP: Only GET implemented for now.");
return;
+ // http analyze <url>
+ } else if (sub == "analyze") {
+ handleHttpAnalyze(cmd);
+ return;
// http <url>
} else if (!sub.empty() && cmd.getArgs().empty()) {
handleHttpGet(cmd);
@@ -469,4 +475,198 @@ void ANetworkController::handleHttpGet(const TerminalCommand &cmd)
}
httpService.reset();
+}
+
+/*
+HTTP Analayze
+*/
+void ANetworkController::handleHttpAnalyze(const TerminalCommand& cmd)
+{
+ if (!wifiService.isConnected() && !ethernetService.isConnected()) {
+ terminalView.println("Analyze: You must be connected to Wi-Fi or Ethernet. Use 'connect' first.");
+ return;
+ }
+
+ if (cmd.getArgs().empty()) {
+ terminalView.println("Usage: http analyze <url>");
+ return;
+ }
+
+ // Ensure URL has HTTP scheme and then extract host
+ const std::string url = argTransformer.ensureHttpScheme(cmd.getArgs());
+ const std::string host = argTransformer.extractHostFromUrl(url);
+
+ // Http Tasks params
+ auto timeout = 10000;
+ auto stackBytes = 20000;
+ auto bodyMaxBytes = 1024 * 16;
+ auto core = 1;
+ auto onlyJson = true;
+ auto insecure = true;
+
+ // urlscan.io (last public scan)
+ const std::string urlscanUrl =
+ "https://urlscan.io/api/v1/search?datasource=scans&q=page.domain:" + host + "&size=1";
+
+ terminalView.println("HTTP Analyze: " + urlscanUrl + " (latest public scan)...");
+ httpService.startGetTask(urlscanUrl, timeout, bodyMaxBytes,
+ insecure, stackBytes, core, onlyJson);
+
+ unsigned long startUrlScan = millis();
+ while (!httpService.isResponseReady() && millis() - startUrlScan < timeout) { delay(100); }
+
+ const std::string urlscanJson = httpService.lastResponse();
+ terminalView.println("\n===== URLSCAN LATEST =====");
+ auto urlScanStrings = jsonTransformer.toLines(jsonTransformer.dechunk(urlscanJson));
+ for (auto& l : urlScanStrings) terminalView.println(l);
+ terminalView.println("==========================\n");
+
+ httpService.reset();
+
+ // W3C HTML Validator
+ auto confirm = userInputManager.readYesNo("\nAnalyze with the W3C Validator?", false);
+ if (confirm) {
+ const std::string w3cUrl =
+ "https://validator.w3.org/nu/?out=json&doc=" + url;
+
+ terminalView.println("Analyze: " + w3cUrl + " (W3C validator)...");
+ httpService.startGetTask(w3cUrl, timeout, bodyMaxBytes, insecure,
+ stackBytes, core, onlyJson);
+
+ unsigned long startWc3 = millis();
+ while (!httpService.isResponseReady() && millis() - startWc3 < timeout) {
+ delay(100);
+ }
+
+ const std::string w3cJson = httpService.lastResponse();
+ terminalView.println("\n===== W3C RESULT =====");
+ auto wc3Strings = jsonTransformer.toLines(jsonTransformer.dechunk(w3cJson));
+ for (auto& l : wc3Strings) {
+ terminalView.println(l);
+ }
+ terminalView.println("======================\n");
+ httpService.reset();
+ }
+
+ terminalView.println("\nHTTP Analyze: Finished.");
+}
+
+/*
+Lookup
+*/
+void ANetworkController::handleLookup(const TerminalCommand& cmd)
+{
+ # ifndef DEVICE_M5STICK
+
+ if (!wifiService.isConnected() && !ethernetService.isConnected()) {
+ terminalView.println("Lookup: You must be connected to Wi-Fi or Ethernet. Use 'connect' first.");
+ return;
+ }
+
+ const std::string sub = cmd.getSubcommand();
+ if (sub == "mac") {
+ handleLookupMac(cmd);
+ } else if (sub == "ip") {
+ handleLookupIp(cmd);
+ } else {
+ terminalView.println("Usage: lookup mac <addr>");
+ terminalView.println(" lookup ip <addr or host>");
+ }
+
+ #else
+
+ terminalView.println("Lookup: M5Stick is not supported.");
+
+ #endif
+}
+
+/*
+Lookup MAC
+*/
+void ANetworkController::handleLookupMac(const TerminalCommand& cmd)
+{
+ if (cmd.getArgs().empty()) {
+ terminalView.println("Usage: lookup mac <mac addr>");
+ return;
+ }
+
+ const std::string mac = cmd.getArgs();
+ const std::string url = "https://api.maclookup.app/v2/macs/" + mac;
+
+ // Http task params
+ auto timeout = 10000;
+ auto stackBytes = 20000;
+ auto bodyMaxBytes = 1024 * 4;
+ auto core = 1;
+ auto onlyJson = true;
+ auto insecure = true;
+
+ terminalView.println("Lookup MAC: " + url + " ...");
+ httpService.startGetTask(url, timeout, bodyMaxBytes,
+ insecure, stackBytes, core, onlyJson);
+
+ unsigned long start = millis();
+ while (!httpService.isResponseReady() && millis() - start < timeout) {
+ delay(100);
+ }
+
+ const std::string resp = httpService.lastResponse();
+ terminalView.println("\n===== MAC LOOKUP =====");
+ auto lines = jsonTransformer.toLines(resp);
+ for (auto& l : lines) terminalView.println(l);
+ terminalView.println("======================\n");
+
+ httpService.reset();
+}
+
+/*
+Lookup IP info
+*/
+void ANetworkController::handleLookupIp(const TerminalCommand& cmd)
+{
+ if (cmd.getArgs().empty()) {
+ terminalView.println("Usage: lookup ip <addr or url>");
+ return;
+ }
+
+ const std::string target = cmd.getArgs();
+ const std::string url = "http://ip-api.com/json/" + target;
+
+ // Http task params
+ auto timeout = 10000;
+ auto stackBytes = 20000;
+ auto bodyMaxBytes = 1024 * 4;
+ auto core = 1;
+ auto onlyJson = true;
+ auto insecure = true;
+
+ terminalView.println("Lookup IP: " + url + " ...");
+ httpService.startGetTask(url, timeout, bodyMaxBytes,
+ insecure, stackBytes, core, onlyJson);
+
+ unsigned long start = millis();
+ while (!httpService.isResponseReady() && millis() - start < timeout) {
+ delay(100);
+ }
+
+ const std::string resp = httpService.lastResponse();
+ terminalView.println("\n===== IP LOOKUP =====");
+ auto lines = jsonTransformer.toLines(resp);
+ for (auto& l : lines) terminalView.println(l);
+ terminalView.println("=====================\n");
+
+ httpService.reset();
+}
+
+void ANetworkController::handleHelp()
+{
+ terminalView.println(" ping <host>");
+ terminalView.println(" discovery");
+ terminalView.println(" ssh <host> <user> <password> [port]");
+ terminalView.println(" nc <host> <port>");
+ terminalView.println(" nmap <host> [-p ports]");
+ terminalView.println(" http get <url>");
+ terminalView.println(" http analyze <url>");
+ terminalView.println(" lookup mac <addr>");
+ terminalView.println(" lookup ip <addr or url>");
}
\ No newline at end of file
diff --git a/src/Abstracts/ANetworkController.h b/src/Abstracts/ANetworkController.h
index 15f44339..df0e8f36 100644
--- a/src/Abstracts/ANetworkController.h
+++ b/src/Abstracts/ANetworkController.h
@@ -14,6 +14,7 @@
#include "Services/ICMPService.h"
#include "Services/NvsService.h"
#include "Transformers/ArgTransformer.h"
+#include "Transformers/JsonTransformer.h"
#include "Managers/UserInputManager.h"
#include "States/GlobalState.h"
#include "Models/TerminalCommand.h"
@@ -36,6 +37,7 @@ public:
NvsService& nvsService,
HttpService& httpService,
ArgTransformer& argTransformer,
+ JsonTransformer& jsonTransformer,
UserInputManager& userInputManager
);
@@ -44,9 +46,19 @@ protected:
void handleNmap(const TerminalCommand& cmd);
void handleSsh(const TerminalCommand& cmd);
void handlePing(const TerminalCommand& cmd);
- void handleDiscovery(const TerminalCommand &cmd);
+ void handleDiscovery(const TerminalCommand& cmd);
+ void handleHelp();
+
+ // HTTP
void handleHttp(const TerminalCommand &cmd);
void handleHttpGet(const TerminalCommand &cmd);
+ void handleHttpAnalyze(const TerminalCommand &cmd);
+
+ // Lookup
+ void handleLookup(const TerminalCommand& cmd);
+ void handleLookupMac(const TerminalCommand& cmd);
+ void handleLookupIp(const TerminalCommand& cmd);
+
protected:
ITerminalView& terminalView;
@@ -66,6 +78,7 @@ protected:
HttpService& httpService;
ArgTransformer& argTransformer;
+ JsonTransformer& jsonTransformer;
UserInputManager& userInputManager;
GlobalState& globalState = GlobalState::getInstance();
};
diff --git a/src/Controllers/EthernetController.cpp b/src/Controllers/EthernetController.cpp
index de095665..152bf141 100644
--- a/src/Controllers/EthernetController.cpp
+++ b/src/Controllers/EthernetController.cpp
@@ -176,12 +176,7 @@ void EthernetController::handleHelp() {
terminalView.println("Ethernet commands:");
terminalView.println(" status");
terminalView.println(" connect");
- terminalView.println(" ping <host>");
- terminalView.println(" discovery [wifi|eth]");
- terminalView.println(" ssh <host> <user> <password> [port]");
- terminalView.println(" nc <host> <port>");
- terminalView.println(" nmap <host> [port]");
- terminalView.println(" http get <url>");
+ ANetworkController::handleHelp();
terminalView.println(" reset");
terminalView.println(" config");
}
diff --git a/src/Controllers/UtilityController.cpp b/src/Controllers/UtilityController.cpp
index 90ad9dcc..afa802d6 100644
--- a/src/Controllers/UtilityController.cpp
+++ b/src/Controllers/UtilityController.cpp
@@ -437,6 +437,8 @@ void UtilityController::handleHelp() {
terminalView.println(" nc <host> <port> - Open netcat session");
terminalView.println(" nmap <h> [-p ports] - Scan host ports");
terminalView.println(" http get <url> - HTTP(s) GET request");
+ terminalView.println(" http analyze <url> - Get analysis report");
+ terminalView.println(" lookup mac|ip <addr> - Lookup MAC or IP address");
terminalView.println(" deauth <ssid> - Deauthenticate hosts");
terminalView.println(" webui - Show the web UI IP");
terminalView.println(" reset - Reset interface");
@@ -473,6 +475,8 @@ void UtilityController::handleHelp() {
terminalView.println(" nc <host> <port> - Open netcat session");
terminalView.println(" nmap <h> [-p ports] - Scan host ports");
terminalView.println(" http get <url> - HTTP(s) GET request");
+ terminalView.println(" http analyze <url> - Get analysis report");
+ terminalView.println(" lookup mac|ip <addr> - Lookup MAC or IP address");
terminalView.println(" reset - Reset interface");
terminalView.println(" config - Configure settings");
diff --git a/src/Controllers/WifiController.cpp b/src/Controllers/WifiController.cpp
index bb4fb7c9..304d253e 100644
--- a/src/Controllers/WifiController.cpp
+++ b/src/Controllers/WifiController.cpp
@@ -22,6 +22,7 @@ void WifiController::handleCommand(const TerminalCommand &cmd)
else if (root == "nc") handleNetcat(cmd);
else if (root == "nmap") handleNmap(cmd);
else if (root == "http") handleHttp(cmd);
+ else if (root == "lookup") handleLookup(cmd);
else if (root == "discovery") handleDiscovery(cmd);
else if (root == "reset") handleReset();
else if (root == "deauth") handleDeauth(cmd);
@@ -472,9 +473,7 @@ void WifiController::handleHelp()
{
terminalView.println("WiFi commands:");
terminalView.println(" scan");
- terminalView.println(" connect");
- terminalView.println(" ping <host>");
- terminalView.println(" discovery [wifi|eth]");
+ terminalView.println(" connect");;
terminalView.println(" sniff");
terminalView.println(" probe");
terminalView.println(" spoof sta <mac>");
@@ -483,10 +482,7 @@ void WifiController::handleHelp()
terminalView.println(" disconnect");
terminalView.println(" ap <ssid> <password>");
terminalView.println(" ap spam");
- terminalView.println(" ssh <host> <username> <password> [port]");
- terminalView.println(" nc <host> <port>");
- terminalView.println(" nmap <host> [port]");
- terminalView.println(" http <get|post|put|delete> <url>");
+ ANetworkController::handleHelp();
terminalView.println(" webui");
terminalView.println(" reset");
terminalView.println(" deauth <ssid>");