summaryrefslogtreecommitdiffstats
path: root/recon/inspector_wifi/README.md
diff options
context:
space:
mode:
authormakefu <github@syntax-fehler.de>2014-12-25 21:15:01 +0100
committermakefu <github@syntax-fehler.de>2014-12-25 21:15:01 +0100
commitabd5b2c8f074ae26c2680048640c47e10566bd39 (patch)
tree9dbdc63edbababec6412992dabba84089117b472 /recon/inspector_wifi/README.md
parentc0f39b57888603595aa37d5abbdad0f52a525184 (diff)
parent8db6cecf6f088ebac98a6be15d920ab412a1c510 (diff)
Merge branch 'master' of ssh://github.com/krebscode/painload
everything stays the same in inspector_wifi Conflicts: recon/inspect_wifi/.gitignore recon/inspect_wifi/README.md recon/inspect_wifi/TODO recon/inspect_wifi/inspector_wifi recon/inspect_wifi/plugins/01open recon/inspect_wifi/plugins/02alice recon/inspect_wifi/plugins/02easybox recon/inspect_wifi/plugins/02tplink recon/inspect_wifi/plugins/plugin_core recon/inspector_wifi/.gitignore recon/inspector_wifi/README.md recon/inspector_wifi/TODO recon/inspector_wifi/inspector_wifi recon/inspector_wifi/plugins/01open recon/inspector_wifi/plugins/02alice recon/inspector_wifi/plugins/02easybox recon/inspector_wifi/plugins/02tplink recon/inspector_wifi/plugins/plugin_core recon/wifi_inspector/.gitignore recon/wifi_inspector/README.md recon/wifi_inspector/TODO recon/wifi_inspector/inspector_wifi recon/wifi_inspector/plugins/01open recon/wifi_inspector/plugins/02alice recon/wifi_inspector/plugins/02easybox recon/wifi_inspector/plugins/02tplink recon/wifi_inspector/plugins/plugin_core
Diffstat (limited to 'recon/inspector_wifi/README.md')
-rw-r--r--recon/inspector_wifi/README.md49
1 files changed, 49 insertions, 0 deletions
diff --git a/recon/inspector_wifi/README.md b/recon/inspector_wifi/README.md
new file mode 100644
index 00000000..3e0d8dce
--- /dev/null
+++ b/recon/inspector_wifi/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