ABOUT SERGIO PROXY
=========================
Sergio Proxy (a Super Effective Recorder of Gathered Inputs and Outputs) is an
HTTP proxy that was written in Python for the Twisted framework. It's
not anything new (many people have done this before, and better), but I wanted
to learn how it's done and this seemed a good way to go about doing it. As this
started out as a quest to develop a better way of attacking an SMB challenge hash
vulnerability, I have implemented that as one of my included MITM attacks. I also
included the classic Upsidedownternet attack for more fun.

Hopefully I will be adding some more unique features in the near future when
I get time. Until then, this is all GPL, so feel free to modify and distribute
as you see fit.


RELEASE NOTES
=========================
This is alpha software. No, seriously. I'm not talking Google's "oh, this might
break once or twice if you use it for years." No, I mean seriously alpha, as in
the bugs you will encounter will make you start screaming "WTF, is this man the
worst coder to have ever wasted space on the Earth?" Yes, that bad. Hopefully,
with your bug reports and some more of my time, it will get more stable. But
until then, you have been warned.

In a similar vein, there are already some known issues with this software that
I would ask you not to waste my time reporting. I have listed a couple of known
bugs below: PLEASE READ THEM BEFORE YOU SUBMIT REPORTS.

DEPENDENCIES
========================
twisted.web Python library
PIL if you want upsidedownternet to work
arpspoof or ettercap if you want to use ArpSpoof plugin
Python (obviously)


USAGE
========================
Running sergio-proxy with -h will print out all the available options.

Also see the example argument files in the examples folder. These can be
used as follows:
./sergio-proxy --myoption1 --myoption2  @file1.args @file2.args ...

TODO
========================
* HTTP/1.1 Support - this will involve modifying twisted itself, so don't hold
your breath for this any time soon.

* Actual SSL support (rather than just trying to strip). Could be awhile...

* Add more attacks, obviously


KNOWN BUGS
========================
Upsidedownternet
Some versions of  PIL in the Ubuntu repo's have a bug that causes parsing
of PNG files. You have been warned. The patch available below can fix this:
https://bugs.launchpad.net/ubuntu/+source/python-imaging/+bug/383228

FOUND BUGS? GOT PATCHES?
========================
Send them to me at supernothing AT spareclockcycles DOT org.