Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
@AleksaMCode
AleksaMCode committed Dec 10, 2022
1 parent 3fbf8d0 commit f5b3b11
Showing 1 changed file with 52 additions and 15 deletions.
67 changes: 52 additions & 15 deletions README.md
View file
Original file line number Diff line number Diff line change
@@ -1,21 +1,30 @@
<img width="150" align="right" src="./resources/wifi-stealer_logo.png"></img>
# WiFi password stealer
> **Disclaimer**: All content in this project is intended for security research purpose only.
<p align="justify">Have you ever watched a film where a hacker would plug-in, seemingly ordinary, USB drive into a a victims computer and steal data from it? - A proper wet dream for some. <br><br>
This summer I decided to do exactly that, to build a device that will allow me to steel data from a victims computer. So, how does one deploy malware and exfiltrate data? In the following text I will explain all of the necessary steps, theory and nuances when it comes to building your own keystroke injection tool. While this project/tutorial focuses on stored WiFi passwords, payload and the code could easily be altered to steal absolutely anything. You are only limited by your imagination (and your technical skills).</p>
<p align="justify">Have you ever watched a film where a hacker would plug-in, seemingly ordinary, USB drive into a a victims computer and steal data from it? - A proper wet dream for some.
## Table of contents
- [WiFi password stealer](#wifi-password-stealer)
- [Table of contents](#table-of-contents)
- [Introduction](#introduction)
- [Setup](#setup)
- [Prerequisites](#prerequisites)
- [Requirements - What you'll need](#requirements---what-youll-need)
- [Keystroke injection](#keystroke-injection)
- [USB Mass Storage Device Problem](#usb-mass-storage-device-problem)
- [Exfiltration](#exfiltration)
- [Keystroke injection tool](#keystroke-injection-tool)
- [Keystoke injection](#keystoke-injection)
- [Delays](#delays)
- [USB Mass Storage Device Problem](#usb-mass-storage-device-problem)
- [Sending stolen data over email](#sending-stolen-data-over-email)
- [Setup](#setup)
- [Protection](#protection)
- [Exfiltrated WiFi data](#exfiltrated-wifi-data)
- [Limitations/Drawbacks](#limitationsdrawbacks)
- [To-Do List](#to-do-list)

## Introduction
<p align="justify">This summer I decided to do exactly that, to build a device that will allow me to steel data from a victims computer. So, how does one deploy malware and exfiltrate data? In the following text I will explain all of the necessary steps, theory and nuances when it comes to building your own keystroke injection tool. While this project/tutorial focuses on WiFi passwords, payload code could easily be altered to do something more nefarious than stealing stored WiFi passwords. You are only limited by your imagination (and your technical skills).</p>

## Setup
<p align="justify">After creating pico-ducky, you only need to copy the modified payload (adjusted for your SMTP details) to the RPi Pico.</p>

## Prerequisites
<ul>
Expand All @@ -39,11 +48,24 @@ This summer I decided to do exactly that, to build a device that will allow me t
> <ul><li>It is possible to build this tool using Rubber Ducky, but keep in mind that <a href="https://www.raspberrypi.com/products/raspberry-pi-pico/">RPi Pico</a> costs $4.00 and the <a href="https://shop.hak5.org/products/usb-rubber-ducky">Rubber Ducky</a> costs $80.00.</li>
> <li>In order to use Ducky Script to write the payload on your RPi Pico you first need to convert it to a pico-ducky.
## Keystroke injection
<p align="justify">Keystorke injection tool, once connected to a host machine, executes malicious commands by running code that mimics keystrokes enterned by a user. While it looks like a USB drive, it acts like a keyboard that types in a preprogrammed payload. Tools like Rubber Ducky can type over 1,000 words per minut. Once created, anyone with physical access can deploy these payloads with ease.</p>
## Exfiltration
<p align="justify">Data exfiltration is an unauthorized trasfer of data from a computer/device. Once the data is collected, adversary can package it to avoid detection while sending data over network, using encryption or compression. Two most common way of exfiltration are:
<ul>
<li>Exfiltration over network medium.</li>
<li>Exfiltration over a physical medium.</li>
</ul>

## Keystroke injection tool
<p align="justify">Keystorke injection tool, once connected to a host machine, executes malicious commands by running code that mimics keystrokes enterned by a user. While it looks like a USB drive, it acts like a keyboard that types in a preprogrammed payload. Tools like Rubber Ducky can type over 1,000 words per minut. Once created, anyone with physical access can deploy this payload with ease.</p>

### Keystoke injection
<p align="justify">The payload uses <code>STRING</code> command processes keystroke for injection. It accepts one or more alphanumeric/punctuation characters. <code>STRING</code> will type the remainder of the line exactly as-is into the target machine. The <code>ENTER</code>/<code>SPACE</code> will simulate a press of keyboard keys.</p.>

### USB Mass Storage Device Problem
<p align="justify">One of the advantages of Rubber Ducky over RPi Pico is that it doesn't show up as a USB mass storage device once plugged in. This isn't a default behaviour for RPi. If you want to prevent your RPi Pico from showing up as a USB mass storage device when plugged in, you need to connect jumper wire between pin 18 (<code>GND</code>) and pin 20 (<code>GPIO15</code>).</p>
### Delays
<p align="justify">We use <code>DELAY</code> command to temporarily pause execution of the payload. This is useful when a payload needs to wait for an element such as a Command Line to load. Delay is useful when used at the very beginning when a new USB device is connected to a targeted computer. Initially computer must complete a set of actions before it can begin accepting input commands. In the case of <a href="https://en.wikipedia.org/wiki/Human_interface_device">HIDs</a> setup time is very short. In most cases it takes a fraction of a second, because the drivers are built-in. However, in some instances a slower PC may take longer to recognize the pico-ducky. The general advice is to adjust the delay time according to your target.</p>

## USB Mass Storage Device Problem
<p align="justify">One of the advantages of Rubber Ducky over RPi Pico is that it doesn't show up as a USB mass storage device once plugged in. Once plugged into a computer all the machine sees it as a USB keyboard. This isn't a default behaviour for RPi. If you want to prevent your RPi Pico from showing up as a USB mass storage device when plugged in, you need to connect jumper wire between pin 18 (<code>GND</code>) and pin 20 (<code>GPIO15</code>).</p>

> **Note**:
> <ul>
Expand All @@ -56,16 +78,31 @@ This summer I decided to do exactly that, to build a device that will allow me t

https://github.com/AleksaMCode/WiFi-password-stealer/blob/d99f11cd630e91d7e9a409bfed175ca46e899c14/payload.dd#L28

<p align="justify">After adding SMTP password, receiver and send email you need to copy the payload.dd to a RPi Pico.</a>
<p align="justify">After sending data over email, the <code>.txt</code> file is deleted.</p>

> **Note**: <p align="justify">You can also use some an SMTP from another email provider, but you should be mindful of SMTP server and port number you will write in the payload.</p>
> **Note**:
> <p align="justify">
> <ul>
> <li>You can also use some an SMTP from another email provider, but you should be mindful of SMTP server and port number you will write in the payload.</li>
> <li>Keep in mind that some networks could be blocking usage of an unknown SMTP at the firewall.</li>
> </ul>
> </p>
## Setup
<p align="justify">After creating pico-ducky, you only need to copy the modified payload (adjusted for your SMTP information) to the RPi Pico.</p>
### Exfiltrated WiFi data
<p align="justify">Below is an example of extracted data from a victims machine in a <code>.txt</code> format.<p>

## Protection
## Limitations/Drawbacks
<ul>
<li><p align="justify">This pico-ducky currently works only on Windows OS.</p></li>
<li><p align="justify">This attack requires a physical access to an unlocked device in order to be successfully deployed.</p></li>
<li><p align="justify">Victims machine firewall or networks firewall may prevent you from sending the stolen data to your email.</p></li>
<li><p align="justify">Payload delays could be inadequate due to varying speeds of different computers used to deploy an attack.</p></li>
<li><p align="justify">This device isn't really stealthy, actually it's quite the opposite, it's really bulky.</p></li>
</ul>

## To-Do List
- [ ] Fix `Caps Lock` bug.
- [ ] Fix non-English Environment bug.
- [ ] Obfuscate the command prompt.
- [ ] Implement exfiltration over a physical medium.
- [ ] Create a payload for Linux.

0 comments on commit f5b3b11

Please sign in to comment.