Sickomode Portal

Sickomode is a simple Captive Portal program wich runs on the ESP8266 dev board.

It is a powerful Social Engineering tool wich creates a open WiFi network with custom name/style alluring people to connect to it and enter some credential.

> DISCLAIMER

The source code given in this repo is for educational use only.

Stealing credential IS ILLEGAL and can get you in trouble.

I am not liable for any actions on your behalf. This code is given with no warranties and liabilities.

Just be responsible OK?

> Updates and References

I probably won't release any updates unless there's a bug, you can submit an issue in case you found one.
I used these two documentations as a reference to build my own, go take a look!

• ESP8266 First Web Server by tttapa.
  
• ESPBug by willmendil.
  

Sickomode is just a name, hope Travis isn't mad at me /o/

> Demonstration

Here is an example of what would happen if someone connected to the network.

> Installation

I will make a youtube video about this project, feel free to ask me questions in the comments if you need to.

>> Hardware

You will need these components and a way to connect them.

• FAT32 Micro SD Card
  
• Micro SD Module
  
• ESP8266
  

Connect the module into the board like this:

ESP8266	Micro SD Module
D8	CS
D7	MOSI
D6	MISO
D5	SCK/clock
VIN	VCC
GND	GND

It should look like this:

---

>> Software

Install the Arduino IDE, go to File -> Preferences, look for the Additional Boards Manager URLS field and paste this url:

https://arduino.esp8266.com/stable/package_esp8266com_index.json

Click OK, and restart the Arduino IDE.

Now you need to install the board, go to Tools -> Board:"" -> Boards Manager and in the search bar, type:

esp8266

by ESP8266 Community, install the 2.6.0 version.

Now, go to Tools -> Manage Libraries and in the search bar, type:

Dictionary

by Anatoli Arkhipenko, install the 3.5.0 version.

Restart the Arduino IDE.

Now, select Generic ESP8266 Module on Tools -> Board:"" -> ESP8266 Boards (2.6.0).

Download the files with:

git clone https://github.com/euMts/Sickomode

Format your SD Card to FAT32 and move the entire content of the SD folder to it.

Now, in your SD Card, move your custom html page into the pages folder.
Open config.json and change the ssid and page values.
Safely remove the SD Card from your computer and plug it into the module before turning the board on.

Open captive_portal.ino with the Arduino IDE and upload the code into your board.

Wait until load and then you're good to go! now you should see the WiFi network with the name that you previously set up on config.json.

Obs. The code will ignore the json file in case its corrupted or malformed. The default value for the SSID is 'Captive Portal'.

The captured data will be stored on the SD Card inside the data.txt file.

> Custom Webpages

You can put any html file inside the pages folder and refer to it on the page variable inside config.json.
The requirements for the html file to work are:

• Have a form that send the data by POST request to /login, the request must have an username and password.
  
• All the code must be inside the .html file, including <script> and <style>.
  
• You must replace all the " (double quotes) with ' (single quote).
  

> To Do List

• - Publish the binary file on the releases page.
  
• - Build a portal to control the board with any device.
  
• - Build a function to controll the LED in case we want to see whats goin on.
  
• - Make FTP server.
  

> License

MIT License
My Website

---

Made by Matheus Eduardo👋