summaryrefslogtreecommitdiffstats
path: root/recon/autowifi/README.md
diff options
context:
space:
mode:
authormakefu <github@syntax-fehler.de>2014-12-20 22:08:23 +0100
committermakefu <github@syntax-fehler.de>2014-12-20 22:08:33 +0100
commitdbaee4aae713410b813f871bb8e8594a9d84f814 (patch)
treed2f5d37c6bad81f3e87c13628933e505c8237315 /recon/autowifi/README.md
parent16e1373ddd9050dd06cd699b2874cf178375574b (diff)
autowifi-merged files to recon/autowifi
Diffstat (limited to 'recon/autowifi/README.md')
-rw-r--r--recon/autowifi/README.md49
1 files changed, 49 insertions, 0 deletions
diff --git a/recon/autowifi/README.md b/recon/autowifi/README.md
new file mode 100644
index 00000000..3e0d8dce
--- /dev/null
+++ b/recon/autowifi/README.md
@@ -0,0 +1,49 @@
+# Autowifi
+Author: makefu,lassulus
+
+Status: Pre-Alpha - it will most likely break if you try to use it
+
+# Contact
+
+twitter: @krebsbob ,@makefoo
+
+IRC: freenode #krebs
+
+# Goals
+Goal of autowifi is to provide a tool which automatically can connect to
+networks in an unknown environment.
+
+This can either be done by connecting to open networks, known networks
+(whitelist) or by calculating weak default wpa keys (for example easybox
+default passwords).
+
+# Audience
+Due to the current status of the project the target audience are
+linux users with technical background .
+
+# Usage
+
+ # all as root
+ # try to find networks to connect to around you
+ usr/bin/autowifi_dryrun quiet
+
+ # start the autowifi daemon which tries to stay in networks all the time
+ usr/bin/autowifi
+
+# Plugins
+All tests to open up networks are implemented in plugins in
+ usr/lib/autowifi/plugins
+
+## Run a single Plugin
+This can be used for testing purposes, e.g. test a single plugin against given networks directly
+
+ # try out the easybox keygen
+ usr/lib/autowifi/plugins/02easybox SSID MAC CHANNEL ENCRYPTION(wpa_cli style)
+
+ #e.g.
+ usr/lib/autowifi/plugins/02easybox Easybox-123456 00:11:22:33:44:55 7 "[wpa]"
+
+# Disclaimer
+- use at own risk
+- only run in lab environment
+- you break it, you buy it