From b98ef5fe66c046b4a12afb7e16fe7d8d3988ed3c Mon Sep 17 00:00:00 2001 From: Eshan Roy Date: Thu, 5 Dec 2024 12:58:23 +0530 Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20docs(new):=20about=20aircrack=20?= =?UTF-8?q?ng?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../default/site-docs-tools-dns-md-ce8.json | 4 + .../version-current-metadata-prop-751.json | 13 ++ .../docusaurus-debug-all-content-673.json | 30 ++++ .docusaurus/globalData.json | 5 + .docusaurus/registry.js | 1 + .docusaurus/routes.js | 12 +- .docusaurus/routesChunkNames.json | 10 +- docs/tools/aircrack-ng.md | 154 ++++++++++++++++++ 8 files changed, 223 insertions(+), 6 deletions(-) create mode 100644 docs/tools/aircrack-ng.md diff --git a/.docusaurus/docusaurus-plugin-content-docs/default/site-docs-tools-dns-md-ce8.json b/.docusaurus/docusaurus-plugin-content-docs/default/site-docs-tools-dns-md-ce8.json index 6b88923e..88942ca4 100644 --- a/.docusaurus/docusaurus-plugin-content-docs/default/site-docs-tools-dns-md-ce8.json +++ b/.docusaurus/docusaurus-plugin-content-docs/default/site-docs-tools-dns-md-ce8.json @@ -19,5 +19,9 @@ "previous": { "title": "Tools", "permalink": "/documentation/category/tools" + }, + "next": { + "title": "Aircrack-NG", + "permalink": "/documentation/tools/aircrack-ng" } } \ No newline at end of file diff --git a/.docusaurus/docusaurus-plugin-content-docs/default/version-current-metadata-prop-751.json b/.docusaurus/docusaurus-plugin-content-docs/default/version-current-metadata-prop-751.json index 8c9eb821..db3b0108 100644 --- a/.docusaurus/docusaurus-plugin-content-docs/default/version-current-metadata-prop-751.json +++ b/.docusaurus/docusaurus-plugin-content-docs/default/version-current-metadata-prop-751.json @@ -359,6 +359,13 @@ "href": "/documentation/tools/dns", "docId": "tools/dns", "unlisted": false + }, + { + "type": "link", + "label": "Aircrack-NG", + "href": "/documentation/tools/aircrack-ng", + "docId": "tools/aircrack-ng", + "unlisted": false } ], "href": "/documentation/category/tools" @@ -558,6 +565,12 @@ "description": "", "sidebar": "tutorialSidebar" }, + "tools/aircrack-ng": { + "id": "tools/aircrack-ng", + "title": "Aircrack-NG", + "description": "πŸ” Aircrack-ng: A Complete Guide with Installation on Snigdha OS", + "sidebar": "tutorialSidebar" + }, "tools/dns": { "id": "tools/dns", "title": "Tool: DNS Enum", diff --git a/.docusaurus/docusaurus-plugin-debug/default/docusaurus-debug-all-content-673.json b/.docusaurus/docusaurus-plugin-debug/default/docusaurus-debug-all-content-673.json index 3eb8e0ef..80a6b732 100644 --- a/.docusaurus/docusaurus-plugin-debug/default/docusaurus-debug-all-content-673.json +++ b/.docusaurus/docusaurus-plugin-debug/default/docusaurus-debug-all-content-673.json @@ -884,6 +884,28 @@ "permalink": "/documentation/post_installation/customization" } }, + { + "id": "tools/aircrack-ng", + "title": "Aircrack-NG", + "description": "πŸ” Aircrack-ng: A Complete Guide with Installation on Snigdha OS", + "source": "@site/docs/tools/aircrack-ng.md", + "sourceDirName": "tools", + "slug": "/tools/aircrack-ng", + "permalink": "/documentation/tools/aircrack-ng", + "draft": false, + "unlisted": false, + "editUrl": "https://github.com/Snigdha-OS/documentation/tree/master/docs/tools/aircrack-ng.md", + "tags": [], + "version": "current", + "frontMatter": { + "sidebarposition": 1 + }, + "sidebar": "tutorialSidebar", + "previous": { + "title": "Tool: DNS Enum", + "permalink": "/documentation/tools/dns" + } + }, { "id": "tools/dns", "title": "Tool: DNS Enum", @@ -905,6 +927,10 @@ "previous": { "title": "Tools", "permalink": "/documentation/category/tools" + }, + "next": { + "title": "Aircrack-NG", + "permalink": "/documentation/tools/aircrack-ng" } }, { @@ -1346,6 +1372,10 @@ { "type": "doc", "id": "tools/dns" + }, + { + "type": "doc", + "id": "tools/aircrack-ng" } ], "link": { diff --git a/.docusaurus/globalData.json b/.docusaurus/globalData.json index cdc27aae..d3d89652 100644 --- a/.docusaurus/globalData.json +++ b/.docusaurus/globalData.json @@ -170,6 +170,11 @@ "path": "/documentation/post_installation/update", "sidebar": "tutorialSidebar" }, + { + "id": "tools/aircrack-ng", + "path": "/documentation/tools/aircrack-ng", + "sidebar": "tutorialSidebar" + }, { "id": "tools/dns", "path": "/documentation/tools/dns", diff --git a/.docusaurus/registry.js b/.docusaurus/registry.js index 41ec4b17..026a0aea 100644 --- a/.docusaurus/registry.js +++ b/.docusaurus/registry.js @@ -64,6 +64,7 @@ export default { "content---documentation-post-installation-languagead-7-478": [() => import(/* webpackChunkName: "content---documentation-post-installation-languagead-7-478" */ "@site/docs/post_installation/language.md"), "@site/docs/post_installation/language.md", require.resolveWeak("@site/docs/post_installation/language.md")], "content---documentation-post-installation-updateffa-74d": [() => import(/* webpackChunkName: "content---documentation-post-installation-updateffa-74d" */ "@site/docs/post_installation/update.md"), "@site/docs/post_installation/update.md", require.resolveWeak("@site/docs/post_installation/update.md")], "content---documentation-privacy-policyfbb-0dc": [() => import(/* webpackChunkName: "content---documentation-privacy-policyfbb-0dc" */ "@site/src/pages/privacy_policy.md"), "@site/src/pages/privacy_policy.md", require.resolveWeak("@site/src/pages/privacy_policy.md")], + "content---documentation-tools-aircrack-ng-71-e-f14": [() => import(/* webpackChunkName: "content---documentation-tools-aircrack-ng-71-e-f14" */ "@site/docs/tools/aircrack-ng.md"), "@site/docs/tools/aircrack-ng.md", require.resolveWeak("@site/docs/tools/aircrack-ng.md")], "content---documentation-tools-dnsce-8-3f9": [() => import(/* webpackChunkName: "content---documentation-tools-dnsce-8-3f9" */ "@site/docs/tools/dns.md"), "@site/docs/tools/dns.md", require.resolveWeak("@site/docs/tools/dns.md")], "content---documentation-troubleshoot-bluetooth-0-b-7-15c": [() => import(/* webpackChunkName: "content---documentation-troubleshoot-bluetooth-0-b-7-15c" */ "@site/docs/troubleshoot/bluetooth.md"), "@site/docs/troubleshoot/bluetooth.md", require.resolveWeak("@site/docs/troubleshoot/bluetooth.md")], "content---documentation-troubleshoot-displaye-2-e-7de": [() => import(/* webpackChunkName: "content---documentation-troubleshoot-displaye-2-e-7de" */ "@site/docs/troubleshoot/display.md"), "@site/docs/troubleshoot/display.md", require.resolveWeak("@site/docs/troubleshoot/display.md")], diff --git a/.docusaurus/routes.js b/.docusaurus/routes.js index 716a75a3..03498ca2 100644 --- a/.docusaurus/routes.js +++ b/.docusaurus/routes.js @@ -79,15 +79,15 @@ export default [ }, { path: '/documentation/', - component: ComponentCreator('/documentation/', '3af'), + component: ComponentCreator('/documentation/', '20b'), routes: [ { path: '/documentation/', - component: ComponentCreator('/documentation/', '6df'), + component: ComponentCreator('/documentation/', '175'), routes: [ { path: '/documentation/', - component: ComponentCreator('/documentation/', '82d'), + component: ComponentCreator('/documentation/', '5ea'), routes: [ { path: '/documentation/before_installation/imporatnt_notes', @@ -329,6 +329,12 @@ export default [ exact: true, sidebar: "tutorialSidebar" }, + { + path: '/documentation/tools/aircrack-ng', + component: ComponentCreator('/documentation/tools/aircrack-ng', 'd77'), + exact: true, + sidebar: "tutorialSidebar" + }, { path: '/documentation/tools/dns', component: ComponentCreator('/documentation/tools/dns', '2cf'), diff --git a/.docusaurus/routesChunkNames.json b/.docusaurus/routesChunkNames.json index 03a63d9a..b9fa1bed 100644 --- a/.docusaurus/routesChunkNames.json +++ b/.docusaurus/routesChunkNames.json @@ -113,17 +113,17 @@ }, "content": "content---documentation-privacy-policyfbb-0dc" }, - "/documentation/-3af": { + "/documentation/-20b": { "__comp": "__comp---theme-docs-root-5-e-9-0b6", "__context": { "plugin": "plugin---documentation-ed-9-690" } }, - "/documentation/-6df": { + "/documentation/-175": { "__comp": "__comp---theme-doc-version-roota-7-b-5de", "version": "version---documentation-935-548" }, - "/documentation/-82d": { + "/documentation/-5ea": { "__comp": "__comp---theme-doc-roota-94-67a" }, "/documentation/before_installation/imporatnt_notes-89a": { @@ -286,6 +286,10 @@ "__comp": "__comp---theme-doc-item-178-a40", "content": "content---documentation-post-installation-updateffa-74d" }, + "/documentation/tools/aircrack-ng-d77": { + "__comp": "__comp---theme-doc-item-178-a40", + "content": "content---documentation-tools-aircrack-ng-71-e-f14" + }, "/documentation/tools/dns-2cf": { "__comp": "__comp---theme-doc-item-178-a40", "content": "content---documentation-tools-dnsce-8-3f9" diff --git a/docs/tools/aircrack-ng.md b/docs/tools/aircrack-ng.md new file mode 100644 index 00000000..04fe2693 --- /dev/null +++ b/docs/tools/aircrack-ng.md @@ -0,0 +1,154 @@ +--- +sidebarposition: 1 +--- + +# Aircrack-NG + +### πŸ” **Aircrack-ng: A Complete Guide with Installation on Snigdha OS** + +**Aircrack-ng** is a powerful suite of tools used for monitoring, testing, cracking, and securing Wi-Fi networks. This guide will cover how to install Aircrack-ng on Snigdha OS and explain its key tools. Let’s dive in! πŸš€ + +--- + +### πŸ› οΈ **How to Install Aircrack-ng on Snigdha OS** + +1. **Update Your System**: + Always ensure your system is up-to-date before installing new software: + + ```bash + sudo pacman -Syu + ``` + +2. **Install Aircrack-ng**: + Aircrack-ng is available in the official Snigdha OS repositories: + + ```bash + sudo pacman -S aircrack-ng + ``` + +3. **Verify Installation**: + Check that Aircrack-ng is installed correctly by running: + + ```bash + aircrack-ng --help + ``` + + If installed successfully, you'll see a list of commands and options. βœ… + +--- + +### 🧰 **Aircrack-ng Tools Overview** + +The Aircrack-ng suite includes several tools for various purposes: + +1. **Airmon-ng (Monitor Mode Enabler) πŸ›°οΈ** + Enables monitor mode on your wireless network interface. + + **Usage**: + ```bash + sudo airmon-ng start wlan0 + ``` + This sets your `wlan0` device to monitor mode, allowing you to capture Wi-Fi traffic. + +2. **Airodump-ng (Packet Capture) πŸ“‘** + Captures packets and displays information about nearby wireless networks. + + **Usage**: + ```bash + sudo airodump-ng wlan0mon + ``` + Replace `wlan0mon` with your monitor-enabled interface. It displays SSIDs, BSSIDs, channels, and more. + +3. **Aireplay-ng (Packet Injection) 🎯** + Injects packets to test network security or deauthenticate clients. + + **Usage**: + Deauthenticate a client to capture a handshake: + ```bash + sudo aireplay-ng --deauth 10 -a -c wlan0mon + ``` + - ``: MAC address of the target access point. + - ``: MAC address of the client. + +4. **Aircrack-ng (Password Cracker) πŸ”“** + Cracks WPA/WPA2 passwords using captured handshakes. + + **Usage**: + ```bash + aircrack-ng -w wordlist.txt -b capture_file.cap + ``` + - `wordlist.txt`: File containing potential passwords. + - `capture_file.cap`: Packet capture file with the handshake. + +5. **Airdecap-ng (Decrypt Packets) πŸ”** + Decrypts WEP/WPA-encrypted packets after obtaining keys. + + **Usage**: + ```bash + airdecap-ng -w capture_file.cap + ``` + +--- + +### πŸ” **Example Workflow: Cracking WPA/WPA2** + +1. **Enable Monitor Mode**: + Start monitoring with Airmon-ng: + + ```bash + sudo airmon-ng start wlan0 + ``` + +2. **Capture Packets**: + Use Airodump-ng to scan for networks: + + ```bash + sudo airodump-ng wlan0mon + ``` + + Focus on a target by capturing packets on its channel: + + ```bash + sudo airodump-ng --bssid --channel --write capture wlan0mon + ``` + +3. **Deauthenticate a Client**: + Force a client to reconnect to capture the WPA handshake: + + ```bash + sudo aireplay-ng --deauth 10 -a -c wlan0mon + ``` + +4. **Crack the Handshake**: + Use Aircrack-ng with a wordlist to crack the password: + + ```bash + aircrack-ng -w wordlist.txt -b capture-01.cap + ``` + +--- + +### ⚠️ **Important Notes** + +1. **Ethical Use Only**: + Always obtain explicit permission before testing any network. Unauthorized use is illegal. + +2. **Hardware Compatibility**: + Ensure your wireless card supports monitor mode and packet injection. Popular chipsets include **Atheros** and **Realtek**. + +3. **Wordlist Quality**: + Cracking success depends on your wordlist. Use comprehensive wordlists like `rockyou.txt` or generate custom ones. + +4. **Alternative Tools**: + Combine Aircrack-ng with tools like **hashcat** for advanced cracking. + +--- + +### πŸš€ **Resources and Further Learning** + +- [Official Aircrack-ng Documentation](https://aircrack-ng.org/) +- Tutorials on ethical Wi-Fi testing and network security. + +--- + +By following this guide, you’re equipped to install and use Aircrack-ng effectively. Remember to use these tools responsibly and ethically. Happy testing! πŸŽ‰ \ No newline at end of file