-
Notifications
You must be signed in to change notification settings - Fork 15
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
arrase
committed
Apr 1, 2017
1 parent
c009374
commit f6a47e4
Showing
1 changed file
with
13 additions
and
39 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,51 +1,25 @@ | ||
| # Raspiducky | ||
|
|
||
| Credits to Original Authors: | ||
| A Keyboard emulator like Rubber Ducky build over Raspberry Pi Zero | ||
|
|
||
| * Duckberry Pi: Jeff L. (Renegade_R - [email protected]) | ||
| * DroidDucky by Andrej Budincevic (https://github.com/anbud/DroidDucky) | ||
| * hardpass by girst (https://github.com/girst/hardpass) | ||
|
|
||
| ### Install: | ||
|
|
||
| 1) Flash the latest Raspbian Jessie image to an SD card | ||
|
|
||
| 2) Copy all the files (hid-gadget-test.c, duckpi.sh, usleep.c, run_payload.sh, hid.sh) to /home/pi | ||
|
|
||
| 3) Compile the hid-gadget-test program, this handles moving the text to the Human Interface Device driver: | ||
|
|
||
| gcc hid-gadget-test.c -o hid-gadget-test | ||
|
|
||
| 4) Compile usleep, this is a basic function which is not natively supported in Raspbian and is used to account for delays in the program: | ||
|
|
||
| make usleep | ||
|
|
||
| 5) Ensure all files and scripts are executable (chmod 755 <file>) | ||
| ### Configuration | ||
|
|
||
| 6) Activate the dwc2 drivers which allows the device to function in host mode when not connected to a PC: | ||
| * Run install script | ||
|
|
||
| echo "dtoverlay=dwc2" | sudo tee -a /boot/config.txt | ||
| chmod 777 install.sh | ||
| ./install.sh | ||
|
|
||
| 9) Place dwc2 and libcomposite in the modules file to boot with the OS: | ||
| * Install a payload | ||
|
|
||
| echo "dwc2" | sudo tee /etc/modules | ||
| echo "libcomposite" | sudo tee /etc/modules | ||
|
|
||
| 10) Copy the following into your /etc/rc.local file. This allows you to place a "payload.dd" script in the "boot" drive that appears when you plug the SD card into a computer, it will then copy the file and format it for Unix (because Windows machines format the text differently): | ||
|
|
||
| /home/pi/hid.sh | ||
| sleep 3 | ||
| /home/pi/run_payload.sh | ||
|
|
||
| 11) Copy the actual payload into /boot, this directory can also be accessed in Windows by simply placing your micro SD card into a card reader and copying it to the drive that appears. | ||
|
|
||
| cat payloads/open_terminal/open_mint_terminal.dd payloads/backdoor/bind_shell.dd > /boot/payload.dd | ||
|
|
||
| 12) Place SD card into the Raspberry Pi Zero, plug it into the target host machine via USB cable in the peripheral micro USB port, NOT THE POWER PORT. A power cord is not required as the Pi Zero will take power directly from the host machine. | ||
|
|
||
| 13) Watch the script execute on the host machine | ||
| cat payloads/open_terminal/open_mint_terminal.dd payloads/backdoor/bind_shell.dd > /boot/payload.dd | ||
|
|
||
| ### Resources: | ||
|
|
||
| * Premade Ducky Scripts: https://github.com/hak5darren/USB-Rubber-Ducky/wiki | ||
| * Original USB Rubber Ducky: http://usbrubberducky.com/#!index.md | ||
|
|
||
| ### Credits: | ||
|
|
||
| * Duckberry Pi: Jeff L. (Renegade_R - [email protected]) | ||
| * DroidDucky by Andrej Budincevic (https://github.com/anbud/DroidDucky) | ||
| * hardpass by girst (https://github.com/girst/hardpass) |