CRAWDAD tools/collect/802.11/Wifi-Scanner

Wi-Fi network scanner/wardriving tool.Wi-Fi network scanner/wardriving tool used in the authors' MobiSys 2009 paper [pang-wifi-reports]. The main difference between Wifi-Scanner and other war driving tools is that it has a more complete Wi-Fi Network Manager that supports logging into WEP/WPA networks, remembering passwords for these networks, supports login through AP portal/splash pages, and performs a battery of measurement tests after you login.Lastmodified :2009-07-08Dataname :tools/collect/802.11/Wifi-ScannerFile :wifiscanner-20090415.tar.gzReleasedate :2009-04-15Change :the initial version.References :pang-wifi-reports Tool WebsiteWebsite :http://www.cs.cmu.edu/~jeffpang/research.shtml#softwareKeyword :802.11 Wi-Fi hotspot location wardrivingLicense :See the indicated files for licensing terms for each of the following packages: gpsd: gpsd-2.37/COPYING kismet: kismet-2007-10-R1/GPL madwifi: madwifi-0.9.4/COPYRIGHT mdns: mdns-scan-0.5/LICENSE mitm-proxy: mitm-proxy-1.0/LICENSE nuttcp: nuttcp/nuttcp-5.5.5.c stund: stund/client.cxx wicrawl: wicrawl-0.4a/doc/LICENSE All other components are licensed under the following terms: (c) 2008-2009 Benjamin Greenstein, Damon McCoy, Jeffrey Pang Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. The names and trademarks of copyright holders may not be used in advertising or publicity pertaining to the software without specific prior permission. Title to copyright in this software and any associated documentation will at all times remain with the copyright holders. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.Build :INSTALLATION The easiest way to install Wifi-Scanner is to (as root) run the following: (1) Create the directory root/tw (2) Move mark-and-sweep (part of this package) to $HOME/tw/mark-and-sweep (3) Move mywifi (part of this package) to $HOME/tw/mywifi (4) Run the prepare.pl script in the mark-and-sweep directory. If you have a bluetooth GPS, edit the line at the top of the script to match your GPS's MAC address. Otherwise, comment out the config_gps() line. In order to perform some of the measurement tests, you need to run a few daemons on a Internet-accessable server that you control. (1) Enter mark-and-sweep/port_checker and run 'make'. (2) Enter mark-and-sweep/udp_test and run 'make'. (2) Enter mark-and-sweep/nuttcp and run 'make'. (3) Copy mark-and-sweep/port_checker/port_checker, mark-and-sweep/simple_web_server/webserver.pl, mark-and-sweep/nuttcp/nuttcp-5.5.5, and mark-and-sweep/udp_test/udp_test to /usr/local/sbin/ on the server machine. (4) Copy mark-and-sweep/init.d/mark-and-sweep-server to the server machine. (5) Copy mark-and-sweep/xinet.d/nuttcp to the server machine at /etc/xinet.d/ (6) Run the mark-and-sweep-server script. (7) Restart xinetd on the server. (8) On the measurement client, you will need to modify a number of files: mark-and-sweep/wicrawl-0.4a/plugins/*/plugin.conf So that the config variables point to the IP address of your server. The plugins that you need to modify the config file for are: bandwidth_up bandwidth_down tcp_bw traceroute port_checkUsage :Before measurements: * Create a list of locations (one location per line) in /root/tw/mark-and-sweep/loc_manager/data/location-list.txt * Enter /root/tw/mark-and-sweep and type 'make install' Go to one of these locations and then (as root with a X-Windows display): 1. Enter /root/tw/install/bin 2. Type './doit' 3. Select your location from the list. 4. Click 'Try'. (DO NOT CLICK MORE THAN ONCE) To abort, click 'Ignore'. 5. Wait for the measurement tool to run. It is done when the output screen says '[] End plugin-engine'. 6. When the tool is done, close the window and return the to location list window. If the run was successful, click 'SUCCESS', if it failed and you don't want to try again, click 'FAIL'. Click 'Ignore' to ignore everything that happened (nothing will be saved). Click 'Try again' to label the previous run a failure and try again. 7. Repeat at another location.Usage :After measurements: 1. Save the directory /root/tw/mark-and-sweep/install/var. (The log directories are called log.*) 2. See mark-and-sweep/scripts/README for how to process this data and a description of its format. 3. Delete the file /root/tw/mark-and-sweep/install/var/loc_manager/location-status.txt. This will reset the location list so that no entries are grayed out (usually they get greyed out after you measure them).Usage :Measurement details: * During the measurement run, the tool will pop up a firefox browser when it detects a portal page. You have to manually login or click through. Then close firefox and it should proceed. If it still can not proceed, it will ask you in a dialog box if you want to try again (either using a measurement proxy or not) or if you want to give up and skip this AP. * For APs that are encrypted, a WEP/WPA dialog box will pop up. You can either enter the password for those APs that you know it or choose to skip it. If you click 'ignore permanently' then it will not ask you about that AP for any future runs. You can undo the 'ignore permanently' status by deleting that AP's file in /root/tw/mark-and-sweep/install/var/keydb. Also, all successful passwords will be saved so you don't have to type them in in the future. * If there are SSIDs that you are sure you never want to measure you can add them (one per line) in /root/tw/mark-and-sweep/install/var/skip_ssidsAlgorithm :Wifi-Scanner is a tool for scanning and measuring properties about visible 802.11 access points (APs). The intended use is as follows: 1) Make a list of locations you intend to measure. 2) Go to each location, run the tool. The tool will prompt you if user input is required (e.g., to add a password or bypass an AP portal page). Measurements will be taken automatically. The main difference between Wifi-Scanner and other war driving tools is that it has a more complete Wi-Fi Network Manager that supports logging into WEP/WPA networks, remembering passwords for these networks, supports login through AP portal/splash pages, and that it performs a battery of measurement tests after you login.本工具为Wi-Fi网络扫描/无线驾驶（wardriving）工具，系作者在MobiSys 2009会议论文[pang-wifi-reports]中使用的Wi-Fi网络扫描/无线驾驶工具。本工具与其他无线驾驶工具的核心差异在于，其搭载了更为完善的Wi-Fi网络管理器：支持接入WEP/WPA加密网络、记忆此类网络的登录密码，支持通过AP门户/跳转页面完成登录，并可在登录后执行一系列测量测试。 最后修改时间：2009-07-08 数据集名称：tools/collect/802.11/Wifi-Scanner 文件：wifiscanner-20090415.tar.gz 发布日期：2009-04-15 更新说明：初始版本。 参考文献：pang-wifi-reports 工具官网：http://www.cs.cmu.edu/~jeffpang/research.shtml#software 关键词：802.11、Wi-Fi热点位置、无线驾驶 许可证：各组件的许可条款详见对应文件： gpsd: gpsd-2.37/COPYING kismet: kismet-2007-10-R1/GPL madwifi: madwifi-0.9.4/COPYRIGHT mdns: mdns-scan-0.5/LICENSE mitm-proxy: mitm-proxy-1.0/LICENSE nuttcp: nuttcp/nuttcp-5.5.5.c stund: stund/client.cxx wicrawl: wicrawl-0.4a/doc/LICENSE 其余组件的许可条款如下： © 2008-2009 Benjamin Greenstein, Damon McCoy, Jeffrey Pang 特此免费授予任何获得本软件及相关文档文件（以下简称"Software"）副本的人无限制地处理本软件的权利，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或出售本软件副本的权利，并允许向其提供本软件的人员在符合以下条件的情况下使用本软件： 上述版权声明和本许可声明应包含在本软件的所有副本或主要部分中。 未经版权所有者事先明确许可，不得在与本软件相关的广告或宣传中使用版权所有者的名称和商标。 本软件的版权及相关文档的所有权始终归版权所有者所有。 本软件按"原样"提供，不附带任何明示或暗示的担保，包括但不限于适销性、特定用途适用性及非侵权的担保。在任何情况下，作者或版权所有者均不对因本软件的使用或其他交易而产生的、合同或侵权等任何形式的索赔、损害或其他责任承担责任。 ### 安装说明（INSTALLATION） 本工具最简便的安装方式为以root权限执行以下步骤： 1. 创建目录root/tw 2. 将mark-and-sweep（本安装包的组成部分）移动至$HOME/tw/mark-and-sweep 3. 将mywifi（本安装包的组成部分）移动至$HOME/tw/mywifi 4. 运行mark-and-sweep目录下的prepare.pl脚本。若您使用蓝牙GPS，请修改脚本顶部的行以匹配您的GPS的MAC地址；否则，请注释掉config_gps()行。 若需执行部分测量测试，您需要在您可管控的可访问互联网的服务器上运行若干守护进程： 1. 进入mark-and-sweep/port_checker目录并执行`make`命令。 2. 进入mark-and-sweep/udp_test目录并执行`make`命令。 3. 进入mark-and-sweep/nuttcp目录并执行`make`命令。 4. 将mark-and-sweep/port_checker/port_checker、mark-and-sweep/simple_web_server/webserver.pl、mark-and-sweep/nuttcp/nuttcp-5.5.5及mark-and-sweep/udp_test/udp_test复制至服务器的/usr/local/sbin/目录。 5. 将mark-and-sweep/init.d/mark-and-sweep-server复制至服务器。 6. 将mark-and-sweep/xinet.d/nuttcp复制至服务器的/etc/xinet.d/目录。 7. 运行mark-and-sweep-server脚本。 8. 重启服务器上的xinetd服务。 在测量客户端上，您需修改以下文件：mark-and-sweep/wicrawl-0.4a/plugins/*/plugin.conf，使其中的配置变量指向您的服务器的IP地址。需修改配置文件的插件包括：bandwidth_up、bandwidth_down、tcp_bw、traceroute、port_checker。 ### 使用说明 #### 测量前操作 1. 在/root/tw/mark-and-sweep/loc_manager/data/location-list.txt中创建位置列表（每行一个位置）。 2. 进入/root/tw/mark-and-sweep目录并执行`make install`命令。 前往任一目标位置，以root权限并开启X-Windows显示环境执行以下步骤： 1. 进入/root/tw/install/bin目录。 2. 执行`./doit`命令。 3. 从列表中选择您所在的位置。 4. 点击"Try"按钮（请勿重复点击）。若需中止操作，请点击"Ignore"。 5. 等待测量工具运行完成，当输出窗口显示"[] End plugin-engine"时即完成。 6. 测量完成后，关闭窗口并返回位置列表窗口： - 若运行成功，点击"SUCCESS"； - 若运行失败且无需重试，点击"FAIL"； - 点击"Ignore"将忽略本次运行结果（不会保存任何数据）； - 点击"Try again"将标记本次运行为失败并重新尝试。 7. 前往下一位置重复上述步骤。 #### 测量后操作 1. 保存/root/tw/mark-and-sweep/install/var目录（日志目录命名为log.*）。 2. 详见mark-and-sweep/scripts/README文件，了解如何处理该数据及数据格式说明。 3. 删除/root/tw/mark-and-sweep/install/var/loc_manager/location-status.txt文件，该操作将重置位置列表，使所有条目不再显示为灰色（通常在完成测量后条目会变为灰色）。 #### 测量细节说明 1. 在测量运行过程中，若工具检测到门户页面，将弹出Firefox浏览器窗口，您需手动完成登录或跳转流程，关闭浏览器后工具将继续运行。若仍无法继续，将弹出对话框询问您是否尝试使用测量代理或放弃并跳过该AP。 2. 对于加密AP，将弹出WEP/WPA密码输入对话框：您可输入已知的AP密码，或选择跳过该AP。若点击"永久忽略"，则后续运行将不会再询问该AP的密码。您可通过删除/root/tw/mark-and-sweep/install/var/keydb目录下对应AP的文件来撤销"永久忽略"状态。同时，所有成功输入的密码将被保存，无需在后续运行中重复输入。 3. 若存在您确定无需测量的服务集标识符（SSIDs），可将其（每行一个）添加至/root/tw/mark-and-sweep/install/var/skip_ssids文件中。 ### 算法说明 Wifi-Scanner是一款用于扫描并测量可见802.11接入点（APs）属性的工具，其预期使用流程如下： 1. 列出您计划测量的所有位置。 2. 前往每个位置并运行本工具，若需用户输入（例如输入密码或绕过AP门户页面），工具将提示您。测量将自动完成。 本工具与其他无线驾驶工具的核心差异在于，其搭载了更为完善的Wi-Fi网络管理器：支持接入WEP/WPA加密网络、记忆此类网络的登录密码，支持通过AP门户/跳转页面完成登录，并可在登录后执行一系列测量测试。