Latest revision |
Your text |
Line 1: |
Line 1: |
- | ''NOTE: This page is currently being updated to reflect the latest stable version. Some information here might be out of date.
| |
- |
| |
- | --[[User:saturn|saturn]] 19:05, 20 August 2012 (UTC)
| |
- |
| |
- | ----
| |
- |
| |
| The Cleven application is a user interface to the aircrack-ng for the [[Nokia N900|N900]] device. | | The Cleven application is a user interface to the aircrack-ng for the [[Nokia N900|N900]] device. |
| | | |
Line 35: |
Line 29: |
| ====Expected==== | | ====Expected==== |
| | | |
- | In order to load the bleeding edge drivers it expects a kernel that can support it. | + | In order to load the bleading edge drivers it expects an equivalent kernel. |
- | The application on startup checks and reports possible inability of correct function if one of the following power kernels (KP) are not used:
| + | Currently possible power kernels include: |
| | | |
| * 46-wl1 | | * 46-wl1 |
Line 42: |
Line 36: |
| * 48 (unconfirmed; same issues with the drivers have been reported) | | * 48 (unconfirmed; same issues with the drivers have been reported) |
| * 49 | | * 49 |
- | * 50
| |
- |
| |
- | Note: the version in [[extras-devel]] will check and expect KP51 or higher. Due to the large amount of changes in the latest KP series, the support of older versions has been dropped.
| |
- |
| |
- | ====Suggested====
| |
- |
| |
- | The application optionally supports the Reaver and Wash implementations of the WPS attack.
| |
- |
| |
- | Quote: ''Reaver implements a brute force attack against Wifi Protected Setup (WPS) registrar PINs in order to recover WPA/WPA2 passphrases, as described in [http://sviehb.files.wordpress.com/2011/12/viehboeck_wps.pdf viehboeck_wps.pdf].''
| |
- |
| |
- | The following binaries need to be available for relevant options to become visible:
| |
- |
| |
- | * reaver
| |
- | * wash
| |
- |
| |
- | (atm the support is for ''versions 1.4'' as of [http://code.google.com/p/reaver-wps/downloads/detail?name=reaver-1.4.tar.gz&can=2&q= reaver-wps]; read also the release changelog for additional info).
| |
- |
| |
- |
| |
- | '''INSTRUCTIONS''' for adding ''reaver'' and ''wash'' support in the application:
| |
- | Copy <code>reaver</code>, <code>reaven.db</code> and <code>wash</code> binaries in <code>/home/user/.reaver/</code> and re-start Cleven for the links to be created.
| |
| | | |
| ==Key features== | | ==Key features== |
| | | |
| * Includes the injection drivers (courtesy of lxp; see [http://david.gnedt.eu/blog/wl1251/ here] for more info and if you like it consider donating to him.). | | * Includes the injection drivers (courtesy of lxp; see [http://david.gnedt.eu/blog/wl1251/ here] for more info and if you like it consider donating to him.). |
- | * Original MAC is stored and restored on drivers load/unload. | + | * Original MAC is stored and restored on exit. |
| * Handles correctly spaces and special characters in the Network names | | * Handles correctly spaces and special characters in the Network names |
- | * The Network names are sorted by name (note: hidden APs are not supported/shown). | + | * The Network names are sorted and the hidden are not shown. |
| * Decryption can be done for data captured over multiple sessions. | | * Decryption can be done for data captured over multiple sessions. |
| * Successful decrypted keys are stored in a separate folder. | | * Successful decrypted keys are stored in a separate folder. |
- | * Supports Reaver and Walsh WPS attacks.
| |
| | | |
| ==Usage== | | ==Usage== |
Line 87: |
Line 60: |
| [[Image:cleven_startupError.png|280px|Kernel Error]] | | [[Image:cleven_startupError.png|280px|Kernel Error]] |
| | | |
- | After all checks and the loading completes the main window appears that provides all available options.
| |
- |
| |
- | [[Image:cleven_main.png|380px|Application Main Window]]
| |
| | | |
- | ===Drivers Configuration Dialog=== | + | ===System Configuration Dialog=== |
| | | |
| As soon as the application starts the ''System Configuration'' dialog is shown. | | As soon as the application starts the ''System Configuration'' dialog is shown. |
Line 107: |
Line 77: |
| ''Note 2'': The default system MAC address will be restored automatically when the drivers get unloaded. | | ''Note 2'': The default system MAC address will be restored automatically when the drivers get unloaded. |
| | | |
- | ===Scan Window=== | + | ===Main Window=== |
| | | |
| [[Image:cleven_mainWindow.png|280px]] | | [[Image:cleven_mainWindow.png|280px]] |
Line 146: |
Line 116: |
| [[Image:cleven_keysManagement.png|280px]] | | [[Image:cleven_keysManagement.png|280px]] |
| | | |
| + | ===Drop down menu=== |
| + | |
| + | The drop down menu, aka Menubar, will offer the following options: |
| + | * Button: '''Configure Drivers''' |
| + | * Button: '''Decrypt Captured Files''' |
| + | * Button: '''Show Keys''' |
| + | * Button: '''About''' |
| + | * Button: '''Quit''' |
| | | |
| + | All of them (with the exception of the Quit) will open a new window or dialog to perform the action described. |
| + | |
| + | [[Image:cleven_Dropdown.png|280px]] |
| | | |
| ===About=== | | ===About=== |
Line 157: |
Line 138: |
| | | |
| ==Versions== | | ==Versions== |
- | <!--
| |
- | '''([http://maemo.org/packages/package_instance/view/fremantle_extras-devel_free_armel/cleven/2.4-8/ Development])'''===
| |
- |
| |
- | '''([http://maemo.org/packages/package_instance/view/fremantle_extras-testing_free_armel/cleven/2.5-2/ Testing])'''
| |
- | -->
| |
- |
| |
- | ---------------------------------------------
| |
- | ===4.1-1 '''([http://maemo.org/packages/package_instance/view/fremantle_extras-devel_free_armel/cleven/4.1-1/ Development])'''===
| |
- | NEW: Added dependency to the newly distributed reaver package.
| |
- | CHANGE: Removed earlier workaround code to copy and configure reaver binaries.
| |
- | CHANGE: Modified the postintall and postremove scripts to remove workarounds in the setup.
| |
- | CHANGE: Modified calls to execute reaver and wash binaries.
| |
- | NEW: Added Pali in the credits. Thanks.
| |
- |
| |
- | INSTRUCTIONS:
| |
- | * To override the autodiscovery of the drivers location and use the default, create an empty file in /home/user/.cleven/skipKernelCheck
| |
- | * To skip the kernel check in the startup, create an empty file in /home/user/.cleven/skipVersionCheck
| |
- |
| |
- | ===3.3-1===
| |
- | CHANGE: Update of recommended kernel - KP51 is expected.
| |
- | CHANGE: Removed the dependency on the wlan drivers - KP51 comes with them.
| |
- |
| |
- | INSTRUCTIONS:
| |
- | * To override the autodiscovery of the drivers location and use the default, create an empty file in /home/user/.cleven/skipKernelCheck
| |
- | * To skip the kernel check in the startup, create an empty file in /home/user/.cleven/skipVersionCheck
| |
- |
| |
- | ===3.2-1===
| |
- | NEW: Additions in the load.sh script for checking the new driver files existence before unloading the default ones.
| |
- | NEW: Addition of a check to skip the startup kernel check (and thus avoid error message for those with custom working setups).
| |
- | NEW: Addition of a check to skip the autodiscovery of kernel version (and set it manually).
| |
- | NEW: Added freemangordon in the about/thanks section of the application.
| |
- |
| |
- | INSTRUCTIONS:
| |
- | * To override the autodiscovery of the drivers location and use the default, create an empty file in /home/user/.cleven/skipKernelCheck
| |
- | * To skip the kernel check in the startup, create an empty file in /home/user/.cleven/skipVersionCheck
| |
- |
| |
- | ===3.1-1===
| |
- | WARNING: This version will work only with Kernel-Power version 50 and above.
| |
- | CHANGE: Modified reaver to accept the spoofed mac address (contributor: Goran see: http://talk.maemo.org/showpost.php?p=1203232&postcount=592)
| |
- |
| |
- | ===3.0-1===
| |
- | WARNING: This version will work only with Kernel-Power version 50 and above.
| |
- | NEW: Added dependency to linux-backports-modules-power package.
| |
- | NEW: removed all binaries of the bleeding edge wireless drivers.
| |
- | CHANGE: Modified load.sh script for the new drivers selection.
| |
- |
| |
- | ===2.5-2 '''([http://maemo.org/downloads/product/Maemo5/cleven/ Stable])'''===
| |
- |
| |
- | NEW: Added support for KP50.
| |
- | NEW: Include binaries of version 0.2 of the bleeding edge wireless drivers.
| |
- | CHANGE: Moved load.sh and unload.sh scripts to main folder.
| |
- | CHANGE: Modified load.sh to accept options for the driver selection.
| |
- | CHANGE: Updated the sudoers file for the new location of the load/unload scripts.
| |
- |
| |
- | ===2.4-8 ===
| |
- |
| |
- | CHANGE: Support for the latest wash (> r100) output file readout.
| |
- | NEW: Added reaver option "--dh-small"; seems to help not overloading/crashing some AP too fast.
| |
- | CHANGE: Removed reaver option "--essid"; avoid problem with special characters in the name.
| |
- | CHANGE: Replaced reaver option "-vv" with the less verbose "-v".
| |
- | CHANGE: Redone keys window; new logic:
| |
- | - Added "Delete" and "Copy" buttons, i.e. file remove and copy to clipboard.
| |
- | - Removed "Read Keys" button; action is triggered automatically.
| |
- | NEW: Removed menu items; the About is accessible from the main window through a new button.
| |
- | CHANGE: Modification of labels in the main window.
| |
- | CHANGE: Modification of the About window text; added few words on reaver.
| |
- | NEW: Added option and rules for the deletion of the "replay_arp" leftover files.
| |
- |
| |
- | ** INSTRUCTIONS for new features:
| |
- | Add reaver, reaven.db and wash binaries in /home/user/.reaver/ and re-start Cleven for the links to be created.
| |
- | This version of Cleven was designed to work with versions up to release r100 of reaver and wash.
| |
- |
| |
- | ===2.4-7===
| |
- |
| |
- | FIX: Dialog with keys was closing too fast.
| |
- | CHANGE: Removed channel option from the reaver call.
| |
- |
| |
- | ** INSTRUCTIONS for new features:
| |
- | Add reaver, reaven.db and wash binaries in /home/user/.reaver/ and re-start Cleven for the links to be created.
| |
- | This version of Cleven was designed to work with versions up to release r90 of reaver and wash.
| |
- |
| |
- | ===2.4-6===
| |
- |
| |
- | FIX: Authentication command mismatch between the UI and script.
| |
- | FIX: Capture could fail in some cases if initiated from the WPS selection.
| |
- | NEW: Added detection on AP names for the single and double quote characters as well as a few more symbols like brackets etc.
| |
- |
| |
- | ** INSTRUCTIONS for new features:
| |
- | Add reaver, reaven.db and wash binaries in /home/user/.reaver/ and re-start Cleven for the links to be created.
| |
- | This version of Cleven was designed to work with versions up to release r90 of reaver and wash.
| |
- |
| |
- | ===2.4-5===
| |
- |
| |
- | CHANGE: Added logging for the Authentication and Capture command in /tmp/cleven.log
| |
- | CHANGE: Removed the -essid option from the authentication (credits: StefanL, g0r)
| |
- | CHANGE: Update for latest (r90) of reaven and wash; walsh has been deprecated.
| |
- | NEW: Added reaven.db support
| |
| | | |
- | ===2.4-3=== | + | ===2.4-3 '''([http://maemo.org/packages/package_instance/view/fremantle_extras-devel_free_armel/cleven/2.1-1/ Development])'''=== |
| | | |
| FIX: Further correction in the creation of the symbolic links for reaver and walsh. | | FIX: Further correction in the creation of the symbolic links for reaver and walsh. |
| FIX: walsh output file would persist; now it is removed explicitly after each scan. | | FIX: walsh output file would persist; now it is removed explicitly after each scan. |
| CHANGE: Added build number in main and about windows. | | CHANGE: Added build number in main and about windows. |
- |
| + | * INSTRUCTIONS for new features: |
- | ** INSTRUCTIONS for new features:
| + | |
| Add reaver and walsh binaries in /home/user/.reaver/ and re-start Cleven for the links to be created. | | Add reaver and walsh binaries in /home/user/.reaver/ and re-start Cleven for the links to be created. |
- | This version of Cleven was designed to work with up to version 1.3 of reaver and walsh. | + | This version of Cleven was designed to works with up to version 1.3 of reaver and walsh. |
| | | |
| ===2.4-2=== | | ===2.4-2=== |
| | | |
| FIX: Correction for missing symbolic links creation for reaver and walsh. | | FIX: Correction for missing symbolic links creation for reaver and walsh. |
- | | + | * INSTRUCTIONS for new features: |
- | ** INSTRUCTIONS for new features:
| + | |
| Add reaver and walsh binaries in /home/user/.reaver/ and re-start Cleven for the links to be created. | | Add reaver and walsh binaries in /home/user/.reaver/ and re-start Cleven for the links to be created. |
| | | |
| ===2.4-1=== | | ===2.4-1=== |
| | | |
- | ** Merge with EXPERIMENTAL version of Cleven.
| + | * Merge with EXPERIMENTAL version of Cleven. |
| CHANGE: Removed wpscrack.py and related dependencies. | | CHANGE: Removed wpscrack.py and related dependencies. |
| CHANGE: Removed connect_reaver.sh; not needed any more. | | CHANGE: Removed connect_reaver.sh; not needed any more. |
Line 283: |
Line 165: |
| NEW: If walsh is available it will be used to sort WPS compliant APs only; | | NEW: If walsh is available it will be used to sort WPS compliant APs only; |
| NEW: If reaver is available and operational the option to test AP with will become visible. | | NEW: If reaver is available and operational the option to test AP with will become visible. |
- | | + | * INSTRUCTIONS for new features: |
- | ** INSTRUCTIONS for new features:
| + | |
| Add reaver and walsh binaries in /home/user/.reaver/ and re-start Cleven for the links to be created. | | Add reaver and walsh binaries in /home/user/.reaver/ and re-start Cleven for the links to be created. |
| | | |
Line 329: |
Line 210: |
| * Addition to store only IVs when in WEP capture (and save space). | | * Addition to store only IVs when in WEP capture (and save space). |
| | | |
- | ===1.10-1 '''Previous stable version''' === | + | ===1.10-1 '''([http://maemo.org/downloads/product/Maemo5/cleven/ stable])''' === |
| | | |
| * Workarournd for WAP authentication to accept spaces in network names. | | * Workarournd for WAP authentication to accept spaces in network names. |