Merge c3465e6e85 into c9b0f6e091

payloads/general/USB-DriveBy/README.md

@@ -0,0 +1,23 @@
+# USB-DriveBy
+* Category: General
+* Author: 90N45
+* Version: 1.0
+
+### Description
+Use an USB storage device to deploy payloads on-demand while the Packet Squirrel is already set up and running.
+
+### Setup
+1. Start your Packet Squirrel with the USB-DriveBy payload.
+2. Whenever you want to start any payload on-demand, place the payload file with the name `payload.txt` on any compatible USB storage device.
+3. When the LED lights up solid green, you can insert the USB storage into the Squirrel’s USB-A port whenever a new payload is needed.
+4. You can unplug your USB storage device at the moment your payload starts
+
+### Tip: Add an LED indicator to your payloads to indicate that your payloads have finished.
+When your payload is finished, the USB-DriveBy payload will wait 10 seconds until it executes the script on your USB storage device again (if it is still present). This means that you should know when your payloads have finished and your USB storage device should be unplugged at the latest.
+
+### Status
+| LED | State |
+| --- | --- |
+| Magenta solid (SETUP) | Default network mode will be established |
+| Green 1000ms VERYFAST blink followed by SOLID (FINISH) | Listening for USB storage device. Ready to run scripts. |
+| Red slow symmetric blinking (FAIL) | No payload file found on USB storage device |

payloads/general/USB-DriveBy/payload.txt

@@ -0,0 +1,35 @@
+#!/bin/bash
+
+# Title: USB-DriveBy
+# Description: Use an USB storage device to deploy payloads on-demand
+# Author: 90N45
+# Version: 1.0
+# Category: General
+
+# Choose your preferred default network mode
+NETWORK_MODE="TRANSPARENT"
+
+LED SETUP
+
+NETMODE ${NETWORK_MODE}
+
+LED FINISH
+
+while true; do 
+	# Check for available USB storage
+	USB_STORAGE && {
+		# Check for available payload
+		if [ -f "/usb/payload.txt" ]; then
+    		# Run payload from USB storage
+			bash /usb/payload.txt
+			# Sleep to prevent triggering the payload twice unintended
+			sleep 10
+		else
+			# LED FAIL if file is not on USB storage
+			LED FAIL
+		fi
+	} || {
+		# Make sure to restore LED color if USB storage is detached after LED FAIL
+		LED G
+	}
+done