From dd9abde0a189b42e6ef7dc1e185a20f6bbfe8f6b Mon Sep 17 00:00:00 2001 From: o7-machinehum Date: Sun, 7 Dec 2025 20:44:32 +0100 Subject: [PATCH 1/2] Moved config around, edited init script. --- .gitmodules | 3 + BLACKHAT_REFERENCE.md | 255 -- README.md | 8 +- armbian | 1 + .../config/boards/flipper-blackhat.csc | 29 + .../config/kernel/linux-sunxi-current.config | 2967 +++++++++++++++++ armbian_config/userpatches/customize-image.sh | 51 + .../arm-dts-sun8i-a33-flipper-blackhat.patch | 219 ++ .../kernel/archive/sunxi-6.12/st7701.patch | 171 + .../etc/systemd/system/bh-boot.service | 13 + .../0001-add-flipper-blackhat-support.patch | 153 + build_armbian.sh | 43 + rootfs_overlay/etc/init.d/S51bh_init | 29 +- 13 files changed, 3677 insertions(+), 265 deletions(-) delete mode 100644 BLACKHAT_REFERENCE.md create mode 160000 armbian create mode 100644 armbian_config/config/boards/flipper-blackhat.csc create mode 100644 armbian_config/config/kernel/linux-sunxi-current.config create mode 100644 armbian_config/userpatches/customize-image.sh create mode 100644 armbian_config/userpatches/kernel/archive/sunxi-6.12/arm-dts-sun8i-a33-flipper-blackhat.patch create mode 100644 armbian_config/userpatches/kernel/archive/sunxi-6.12/st7701.patch create mode 100644 armbian_config/userpatches/overlay/etc/systemd/system/bh-boot.service create mode 100644 armbian_config/userpatches/u-boot/u-boot-sunxi/board_flipper-blackhat/0001-add-flipper-blackhat-support.patch create mode 100755 build_armbian.sh diff --git a/.gitmodules b/.gitmodules index 7786707..8a6dc53 100644 --- a/.gitmodules +++ b/.gitmodules @@ -6,3 +6,6 @@ [submodule "Bjorn-blackhat"] path = package/bjorn/bjorn url = git@github.com:o7-machinehum/Bjorn-blackhat.git +[submodule "armbian"] + path = armbian + url = https://github.com/armbian/build diff --git a/BLACKHAT_REFERENCE.md b/BLACKHAT_REFERENCE.md deleted file mode 100644 index 3b6c4e0..0000000 --- a/BLACKHAT_REFERENCE.md +++ /dev/null @@ -1,255 +0,0 @@ -# BlackHat Board - Complete Functionality Reference - -The BlackHat Board provides a comprehensive suite of WiFi security testing and network analysis tools through the `bh` command-line interface. - -## WiFi Core Operations - -### Network Scanning -```bash -bh wifi list # Scan and list available WiFi networks -``` -Lists all visible WiFi access points using the specified wireless interface. - -### Interface Management -```bash -bh wifi dev # Enumerate wireless interfaces and capabilities -``` -Shows available wireless interfaces with their frequency bands (2.4GHz, 5GHz support). - -### Network Connection -```bash -bh wifi con # Connect to configured network -bh wifi con stop # Disconnect from network -``` -Connect to or disconnect from WiFi networks using stored credentials. - -### Access Point Creation -```bash -bh wifi ap # Create access point -bh wifi ap stop # Stop access point -``` -Create a fake access point for testing or attack scenarios. - -### IP Address Information -```bash -bh wifi ip # Display IP addresses of wireless interfaces -``` - -## Attack Vectors - -### Evil Twin Attack -```bash -bh evil_twin # Enable internet passthrough for MITM positioning -``` -Creates a malicious access point that mirrors a legitimate network, allowing man-in-the-middle attacks while providing internet connectivity to maintain victim connections. - -### Evil Portal (Captive Portal) -```bash -bh evil_portal # Start captive portal for credential harvesting -bh evil_portal stop # Stop captive portal -``` -Deploys a captive portal that intercepts and captures user credentials. The portal can use custom HTML pages: -- `index.html` - Primary portal page - -### Deauthentication Attacks - -**Professional-grade deauth functionality with explicit targeting:** - -#### **Target Discovery** -```bash -bh deauth_scan [interface] # Scan for targets and show available APs/clients -``` - -#### **Specific Client Attack** -```bash -bh deauth [interface] [count] -# Example: bh deauth aa:bb:cc:dd:ee:ff 11:22:33:44:55:66 wlan1 -``` - -#### **All Clients from AP** -```bash -bh deauth_all [interface] [count] -# Example: bh deauth_all 11:22:33:44:55:66 wlan1 -``` - -#### **Nuclear Option (All Networks)** -```bash -bh deauth_broadcast [interface] [count] # WARNING: Attacks all visible networks -``` - -**Interface Usage:** -- **wlan0** (2.4GHz onboard): Use for 2.4GHz targets or when wlan1 unavailable -- **wlan1** (5GHz USB): Default for attacks, allows maintaining SSH connection on wlan0 -- **Automatic fallback**: Commands default to wlan1, specify wlan0 if needed - -**Technical Details:** -- **Explicit targeting**: No guesswork - specify exact client and AP MACs -- **Dual-radio advantage**: Stay connected on wlan0 while attacking with wlan1 -- **Configurable count**: Default 10 deauth frames, customizable -- **Monitor mode management**: Automatically handles interface setup/teardown -- **Professional workflow**: Scan → Identify → Attack - -**Interface Caveats:** -- **Cannot use same interface** for connection and monitor mode simultaneously -- **wlan0 connection preserved** when using wlan1 for attacks -- **Monitor mode conflicts**: Reset interface if "Failed to set monitor mode" - ```bash - # Interface reset if needed: - iw dev wlan1 set type managed - ip link set wlan1 down && ip link set wlan1 up - ``` - -## Monitoring & Intelligence - -### Packet Capture -```bash -bh kismet # Start Kismet packet capture and analysis -bh kismet stop # Stop Kismet -``` -Launches Kismet for comprehensive wireless packet capture, analysis, and monitoring. Accessible via web interface on port 2501. - -### Network Connectivity Testing -```bash -bh test_inet # Test internet connectivity (ping google.com) -``` - -## Configuration Management - -### Network Credentials -```bash -bh set SSID "network_name" # Set target network SSID -bh set PASS "password" # Set network password -bh set AP_SSID "fake_ap_name" # Set your fake access point name -``` - -### View Configuration -```bash -bh get # Display all current configuration settings -``` - -## System Management - -### SSH Access -```bash -bh ssh # Start SSH daemon for remote access -bh ssh stop # Stop SSH daemon -``` -Enables remote access to the BlackHat Board via SSH. - -## Automation Framework - -### Script Management -```bash -bh script scan # List available automation scripts -bh script run