README.md

DuckHunter

Prevent RubberDucky (or other keystroke injection) attacks

Try Out the new setup GUI it helps you to setup the software and we have just released a new feature that allows you to run the script every time your computer starts automatically

Read this program's postmortem at my blog

Intro

[Rubberduckies](https://hakshop.myshopify.com/products/usb-rubber-ducky-deluxe) are small usb devices that pretend to be usb keyboards and can type on their own at very high speeds. Because most -if not all- OS trust keyboards automatically, it is hard to protect oneself from these attacks.

DuckHunt is a small efficient script that acts as a daemon consistently monitoring your keyboard usage (right now, speed and selected window) that can catch and prevent a rubber ducky attack. (Technically it helps prevent any type of automated keystroke injection attack, so things like Mousejack injections are also covered.)

Features

Protection Policy

• Paranoid: When an attack is detected, keyboard input is disallowed until a password is input. Attack will also be logged.
• Normal: When an attack is detected, keyboard input will temporarily be disallowed. (After it is deemed that the treat is over, keyboard input will be allowed again). Attack will also be logged.
• Sneaky: When an attacks is detected, a few keys will be dropped (enough to break any attack, make it look as if the attacker messed up.) Attack will also be logged.
• LogOnly: When an attack is detected, simply log the attack and in no way stop it.

Extras

• Program Blacklist: If there are specific programs you neve use (cmd, powershell). Consider interactions with them as highly suspecious and take action based on the protection policy.
• Support for AutoType software (eg. KeePass, LastPass, Breevy)

Setup

Regular users:

• Choose and download one of the two options that best suits you:
  • Opt #1: Normal Protection w/ Program Blacklisting for Commandline and Powershell
  • Opt #2: Normal Protection (w/o any blacklisting)
• Now, copy the .exe above to the startup menu.
  • In Windows XP,Vista,7 : This folder should be accessible from your Start Menu
  • In Windows 10: Open a directory explorer an go to "%appdata%\Microsoft\Windows\Start Menu\Programs\Startup" (copy paste it in without the quotation marks).

Advanced Users

• Keep Reading...
• Feel Free to contact me, add issues, fork, and get involved with this project :). Together we can make a stronger tool!

Requirements

• PyWin32
• PyHook
• Py2Exe
• webbrowser

Advanced Setup

• Step 1. Customize duckhunt.conf variables to your desire
  • You can customize the password, speed threshold, privacy, etc.
• Step 2. Turn the duckhunt-configurable**.py** to a duckhunt-configurable**.pyw** so that the console doesn't show up when you run the program
• Step 3. (opt) Use Py2Exe to create an executable.
• Step 4. Run the program. You are now protected from RubberDuckies!

TODO

• More monitoring features:
• Add OSX & Linux support!
• Look for certain patterns (eg. "GUI D, GUI R, cmd, ENTER")

Happy Hunting!