<h1 align="center">
<br>
<a href="https://github.com/s0md3v/Arjun"><img src="https://image.ibb.co/c618nq/arjun.png" alt="Arjun"></a>
<br>
Arjun
<br>
</h1>
<h4 align="center">HTTP Parameter Discovery Suite</h4>
<p align="center">
<a href="https://github.com/s0md3v/Arjun/releases">
<img src="https://img.shields.io/github/release/s0md3v/Arjun.svg">
</a>
<a href="https://pypi.python.org/pypi/arjun/">
<img src="https://img.shields.io/pypi/v/arjun.svg">
</a>
<a href="https://github.com/s0md3v/Arjun/issues?q=is%3Aissue+is%3Aclosed">
<img src="https://img.shields.io/github/issues-closed-raw/s0md3v/Arjun?color=dark-green&label=issues%20fixed">
</a>
<a href="https://travis-ci.com/s0md3v/Arjun">
<img src="https://img.shields.io/travis/com/s0md3v/Arjun.svg?color=dark-green&label=tests">
</a>
</p>
### What's Arjun?
Arjun can find query parameters for URL endpoints. If you don't get what that means, it's okay, read along.
Web applications use parameters (or queries) to accept user input, take the following example into consideration
`http://api.example.com/v1/userinfo?id=751634589`
This URL seems to load user information for a specific user id, but what if there exists a parameter named `admin` which when set to `True` makes the endpoint provide more information about the user?\
This is what Arjun does, it finds valid HTTP parameters with a huge default dictionary of 25,890 parameter names.
The best part? It takes less than 10 seconds to go through this huge list while making just 50-60 requests to the target. [Here's how](https://github.com/s0md3v/Arjun/wiki/How-Arjun-works%3F).
### Why Arjun?
- Supports `GET/POST/POST-JSON/POST-XML` requests
- Automatically handles rate limits and timeouts
- Export results to: BurpSuite, text or JSON file
- Import targets from: BurpSuite, text file or a raw request file
- Can passively extract parameters from JS or 3 external sources
### Installing Arjun
You can install `arjun` with pip as following:
```
pip3 install arjun
```
or, by downloading this repository and running
```
python3 setup.py install
```
### How to use Arjun?
A detailed usage guide is available on [Usage](https://github.com/s0md3v/Arjun/wiki/Usage) section of the Wiki.
Direct links to some basic options are given below:
- [Scan a single URL](https://github.com/s0md3v/Arjun/wiki/Usage#scan-a-single-url)
- [Import targets](https://github.com/s0md3v/Arjun/wiki/Usage#import-multiple-targets)
- [Export results](https://github.com/s0md3v/Arjun/wiki/Usage#save-output-to-a-file)
- [Use custom HTTP headers](https://github.com/s0md3v/Arjun/wiki/Usage#use-custom-http-headers)
Optionally, you can use the `--help` argument to explore Arjun on your own.
##### Credits
The parameter names wordlist is created by extracting top parameter names from [CommonCrawl](http://commoncrawl.org) dataset and merging best words from [SecLists](https://github.com/danielmiessler/SecLists) and [param-miner](https://github.com/PortSwigger/param-miner) wordlists into that.\
`db/special.json` wordlist is taken from [data-payloads](https://github.com/yehgdotnet/data-payloads).
Raw data
{
"_id": null,
"home_page": "https://github.com/s0md3v/Arjun",
"name": "arjun",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "arjun, bug bounty, http, pentesting, security",
"author": "Somdev Sangwan",
"author_email": "s0md3v@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/bb/97/ed0189286d98aaf92322a06e23b10fc6c298e0ee9a43cd69ab614a1f76cf/arjun-2.2.6.tar.gz",
"platform": null,
"description": "\n<h1 align=\"center\">\n <br>\n <a href=\"https://github.com/s0md3v/Arjun\"><img src=\"https://image.ibb.co/c618nq/arjun.png\" alt=\"Arjun\"></a>\n <br>\n Arjun\n <br>\n</h1>\n\n<h4 align=\"center\">HTTP Parameter Discovery Suite</h4>\n\n<p align=\"center\">\n <a href=\"https://github.com/s0md3v/Arjun/releases\">\n <img src=\"https://img.shields.io/github/release/s0md3v/Arjun.svg\">\n </a>\n <a href=\"https://pypi.python.org/pypi/arjun/\">\n <img src=\"https://img.shields.io/pypi/v/arjun.svg\">\n </a>\n <a href=\"https://github.com/s0md3v/Arjun/issues?q=is%3Aissue+is%3Aclosed\">\n <img src=\"https://img.shields.io/github/issues-closed-raw/s0md3v/Arjun?color=dark-green&label=issues%20fixed\">\n </a>\n <a href=\"https://travis-ci.com/s0md3v/Arjun\">\n <img src=\"https://img.shields.io/travis/com/s0md3v/Arjun.svg?color=dark-green&label=tests\">\n </a>\n</p>\n\n\n\n### What's Arjun?\n\nArjun can find query parameters for URL endpoints. If you don't get what that means, it's okay, read along.\n\nWeb applications use parameters (or queries) to accept user input, take the following example into consideration\n\n`http://api.example.com/v1/userinfo?id=751634589`\n\nThis URL seems to load user information for a specific user id, but what if there exists a parameter named `admin` which when set to `True` makes the endpoint provide more information about the user?\\\nThis is what Arjun does, it finds valid HTTP parameters with a huge default dictionary of 25,890 parameter names.\n\nThe best part? It takes less than 10 seconds to go through this huge list while making just 50-60 requests to the target. [Here's how](https://github.com/s0md3v/Arjun/wiki/How-Arjun-works%3F).\n\n### Why Arjun?\n\n- Supports `GET/POST/POST-JSON/POST-XML` requests\n- Automatically handles rate limits and timeouts\n- Export results to: BurpSuite, text or JSON file\n- Import targets from: BurpSuite, text file or a raw request file\n- Can passively extract parameters from JS or 3 external sources\n\n### Installing Arjun\n\n\nYou can install `arjun` with pip as following:\n```\npip3 install arjun\n```\n\nor, by downloading this repository and running\n```\npython3 setup.py install\n```\n\n### How to use Arjun?\n\nA detailed usage guide is available on [Usage](https://github.com/s0md3v/Arjun/wiki/Usage) section of the Wiki.\n\nDirect links to some basic options are given below:\n\n- [Scan a single URL](https://github.com/s0md3v/Arjun/wiki/Usage#scan-a-single-url)\n- [Import targets](https://github.com/s0md3v/Arjun/wiki/Usage#import-multiple-targets)\n- [Export results](https://github.com/s0md3v/Arjun/wiki/Usage#save-output-to-a-file)\n- [Use custom HTTP headers](https://github.com/s0md3v/Arjun/wiki/Usage#use-custom-http-headers)\n\nOptionally, you can use the `--help` argument to explore Arjun on your own.\n\n##### Credits\nThe parameter names wordlist is created by extracting top parameter names from [CommonCrawl](http://commoncrawl.org) dataset and merging best words from [SecLists](https://github.com/danielmiessler/SecLists) and [param-miner](https://github.com/PortSwigger/param-miner) wordlists into that.\\\n`db/special.json` wordlist is taken from [data-payloads](https://github.com/yehgdotnet/data-payloads).\n",
"bugtrack_url": null,
"license": "GNU General Public License v3 (GPLv3)",
"summary": "HTTP parameter discovery suite",
"version": "2.2.6",
"project_urls": {
"Download": "https://github.com/s0md3v/Arjun/archive/v2.2.6.zip",
"Homepage": "https://github.com/s0md3v/Arjun"
},
"split_keywords": [
"arjun",
" bug bounty",
" http",
" pentesting",
" security"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "bb97ed0189286d98aaf92322a06e23b10fc6c298e0ee9a43cd69ab614a1f76cf",
"md5": "b6749e19db729b3ee5b7c02b7124215c",
"sha256": "15dbc0abf5efcbbe4ba1892ad8edb08fa5efc41bb2ebaadd0be01e47e70240fc"
},
"downloads": -1,
"filename": "arjun-2.2.6.tar.gz",
"has_sig": false,
"md5_digest": "b6749e19db729b3ee5b7c02b7124215c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 140898,
"upload_time": "2024-04-13T04:58:49",
"upload_time_iso_8601": "2024-04-13T04:58:49.796146Z",
"url": "https://files.pythonhosted.org/packages/bb/97/ed0189286d98aaf92322a06e23b10fc6c298e0ee9a43cd69ab614a1f76cf/arjun-2.2.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-13 04:58:49",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "s0md3v",
"github_project": "Arjun",
"travis_ci": true,
"coveralls": false,
"github_actions": false,
"lcname": "arjun"
}
JSON
