Agartha, specializes in advance payload generation and access control assessment. It adeptly identifies vulnerabilities related to injection attacks, and authentication/authorization issues. The dynamic payload generator crafts extensive wordlists for various injection vectors, including SQL Injection, Local File Inclusion (LFI), and Remote Code Execution(RCE). Furthermore, the extension constructs a comprehensive user access matrix, revealing potential access violations and privilege escalation paths. It also assists in performing HTTP 403 bypass checks, shedding light on auth misconfigurations. Additionally, it can convert HTTP requests to JavaScript code to help digging up XSS issues more.
In summary:
- Payload Generator: It dynamically constructs comprehensive wordlists for injection attacks, incorporating various encoding and escaping characters to enhance the effectiveness of security testing. These wordlists cover critical vulnerabilities such as SQL Injection, Local File Inclusion (LFI), and Remote Code Execution, making them indispensable for robust security testing.
- Local File Inclusion, Path Traversal: It helps identifying vulnerabilities that allow attackers to access files on the server's filesystem.
- Remote Code Execution, Command Injection: It aims to detects potential command injection points, enabling robust testing for code execution vulnerabilities.
- SQL Injection: It assists to uncover SQL Injection vulnerabilities, including Stacked Queries, Boolean-Based, Union-Based, and Time-Based.
- Auth Matrix: By constructing a comprehensive access matrix, the tool reveals potential access violations and privilege escalation paths. This feature enhances security posture by addressing authentication and authorization issues.
- You can use the web 'Spider' feature to generate a sitemap/URL list, and it will crawl visible links from the user's session automatically.
- 403 Bypass: It aims to tackle common access restrictions, such as HTTP 403 Forbidden responses. It utilizes techniques like URL manipulation and request header modification to bypass implemented limitations.
- Copy as JavaScript: It converts Http requests to JavaScript code for further XSS exploitation and more.
Here is a small tutorial how to use.
You should download 'Jython' file and set your environment first:
- Burp Menu > Extender > Options > Python Environment > Locate Jython standalone jar file.
You can install Agartha through official store:
- Burp Menu > Extender > BApp Store > Agartha
Or for manual installation:
- Burp Menu > Extender > Extensions > Add > Extension Type: Python > Extension file(.py): Select 'Agartha.py' file
After all, you will see 'Agartha' tab in the main window and it will be also registered the right click, under:
- 'Extensions > Agartha - LFI, RCE, SQLi, Auth, HTTP to JS', with three sub-menus:
- 'Auth Matrix'
- '403 Bypass'
- 'Copy as JavaScript'
It supports both Unix and Windows file syntaxes, enabling dynamic wordlist generation for any desired path. Additionally, it can attempt to bypass Web Application Firewall (WAF) implementations, with various encodings and other techniques.
- 'Depth' specifies the extent of directory traversal for wordlist generation. You can create wordlists that reach up to or equal to this specified level. The default value is 5.
- 'Waf Bypass' inquires whether you want to enable all bypass features, such as the use of null bytes, various encoding techniques, and other methods to circumvent web application firewalls.
It generates dynamic wordlists for command execution based on the supplied command. It combines various separators and terminators for both Unix and Windows environments.
- 'URL Encoding' encodes the output.
It generates payloads for various types of SQL injection attacks, including Stacked Queries, Boolean-Based, Union-Based, and Time-Based. It doesn’t require any user inputs; you simply select the desired SQL attack types and databases, and it generates a wordlist with different combinations.
- 'URL Encoding' encodes the output.
- 'Waf Bypass' inquires whether you want to enable all bypass features, such as the use of null bytes, various encoding techniques, and other methods to circumvent web application firewalls.
- 'Union-Based' requires the specified depth for payload generation. You can create wordlists that reach up to the given value. The default value is 5.
- The remaining aspects pertain to database types and various attack vectors.
This part focuses on analyzing user session and URL relationships to identify access violations. The tool systematically visits all URLs associated with pre-defined user sessions and populates a table with HTTP responses. Essentially, it creates an access matrix, which aids in identifying authentication and authorization issues. Ultimately, this process reveals which users can access specific page contents.
- You can right-click on any request and navigate to 'Extensions > Agartha > Auth Matrix' to define user sessions.
- Next, you need to provide the URL addresses that the user (HTTP header/session owner) can access. You can utilize the web 'Spider' feature for automated crawling or supply a manually curated list of URLs.
- Afterward, you can use the 'Add User' button to include the user sessions.
- Now, it's ready for execution. Simply click the 'Run' button, and the table will be populated accordingly.
![Authorization Matrix](https://private-user-images.githubusercontent.com/50321735/341823515-6f89e22c-e29c-413d-96d8-c2a8d7ac39d4.gif?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjM3MDk1MzksIm5iZiI6MTcyMzcwOTIzOSwicGF0aCI6Ii81MDMyMTczNS8zNDE4MjM1MTUtNmY4OWUyMmMtZTI5Yy00MTNkLTk2ZDgtYzJhOGQ3YWMzOWQ0LmdpZj9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA4MTUlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwODE1VDA4MDcxOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWE0NDQ4NzU0ZjliM2FmNjRkOTBhMzZkZjAzNzQ2ZjExMTI5YjhhMWYyNjFlZmVjNDIxNWZhOGFlNTFkNDU2ZDkmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.OKFh3V_r5vOj-jAXsyz6ayy-AOYJG7c8vtVmibOs2BE)
A little bit more details:
- This is the field where you enter the username for the session you provide. You can add up to four different users, with each user being assigned a unique color to enhance readability.
- The 'Add User' button allows you to include user sessions in the matrix.
- You can change the HTTP request method to 'GET', 'POST', or 'Dynamic', the latter of which is based on proxy history.
- The 'Reset' button clears all contents.
- The 'Run' button executes the task, displaying the results in the user access matrix.
- The 'Warnings' section highlights potential issues using different colors for easy identification.
- The 'Spider (SiteMap)' button automatically generates a URL list based on the user's header/session. The visible URLs will be populated in the next textbox, where you can still make modifications as needed.
- 'Crawl Depth' defines the maximum number of sub-links that the 'Spider' should crawl to detect links.
- The field is for specifying request headers, and all URLs will be accessed using the session defined here.
- Specify the URL addresses that users can visit. You can create this list manually or utilize the 'Spider' crawler feature. Make sure to provide a visitable URL list for each user.
- All provided URLs will be listed here and attempted to access using the corresponding user sessions.
- The first column represents a scenario with no authentication attempt. All cookies, tokens, and potential session parameters will be removed from the HTTP calls.
- The remaining columns correspond to the users previously generated, each marked with a unique color to indicate the respective URL owners.
- The cell titles display the HTTP response 'codes:lengths' for each user session, providing a clear overview of the response details for each access attempt.
- Just click on the cell you want to examine, and the HTTP details will be displayed at the bottom.
Please note that potential session terminators (such as logoff, sign-out, etc.) and specific file types (such as CSS, images, JavaScript, etc.) will be filtered out from both the 'Spider' and the user's URL list.
![User Access Table Details](https://private-user-images.githubusercontent.com/50321735/344160985-e7ce918e-d40e-44c5-ada7-ee1c0cfa487b.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjM3MDk1MzksIm5iZiI6MTcyMzcwOTIzOSwicGF0aCI6Ii81MDMyMTczNS8zNDQxNjA5ODUtZTdjZTkxOGUtZDQwZS00NGM1LWFkYTctZWUxYzBjZmE0ODdiLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA4MTUlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwODE1VDA4MDcxOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWRkMjljZTM2MTRhYWZmZjIxZDlkMjliZWU3ZTljN2QzYjE4YmU3OTRlYzVhNDNhZjUzNTU2ODhkZmY1YTA4YzEmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.SKMzuLIeu9cRW5o3N8up6IuAapk59wLAsYhSIPBcnlM)
After clicking 'RUN', the tool will populate the user and URL matrix with different colors. In addition to user-specific colors, you will see red, orange, and yellow cells indicating possible access issues.
- Red highlights a critical access violation, indicated by the response returning 'HTTP 200' with the same content length.
- Orange signifies a moderate issue that needs attention, marked by the response returning 'HTTP 200' but with a different content length.
- Yellow indicates that the response returns an 'HTTP 302' status, signifying a redirection.
The task at hand involves a bulk process, and it is worth to mention which HTTP request methods will be used. The tool provides three different options for performing HTTP calls:
- GET, All requests are sent using the GET method.
- POST, All requests are sent using the POST method.
- Dynamic, The request method is determined by the proxy history. If no information is available, the base header method will be used by default.
HTTP 403 Forbidden status code indicates that the server understands the request but refuses to authorize it. Essentially, it means, ‘I recognize who you are, but you lack permission to access this resource.’ This status often points to issues like ‘insufficient permissions’, ‘authentication required’, ‘IP restrictions’, etc.
The tool addresses the common access forbidden error by employing various techniques, such as URL manipulation and request header modification. These strategies aim to bypass access restrictions and retrieve the desired content.
It is worth to mention two different usage cases:
- In scenarios related to Authentication Issues, it is essential to consider removing all session identifiers. After doing so, test whether any sources become publicly accessible. This approach helps identify unauthenticated accesses and ensures that sensitive information remains protected.
- For Privilege Escalation and Authorization testing, retain session identifiers but limit their use to specific user roles. For instance, you can utilize a regular user’s session while substituting an administrative URL. This focused approach allows for more precise and efficient testing, ensuring that privileged sources are not accessible without the appropriate roles.
There are 2 ways you can send HTTP requests to the tool.
- You can load requests from proxy history by clicking the ‘Load Requests’ button. Doing so will automatically remove all session identifiers, making it suitable for attack Case 1. Any potential session terminators (such as logoff, sign-out, etc.) and specific file types (such as CSS, images, JavaScript, etc.) will be also filtered out. Please note that this will be a bulk process and may take longer as it involves revisiting each HTTP request from the history. However, this comprehensive verification of all endpoints is essential for ensuring the security of the authentication mechanisms
- You can send individual requests by right-clicking. Session identifiers will be retained/untouched, making this approach suitable for attack Case 2. This controlled approach allows you to assess whether privileged sources are accessible without proper roles. It will be more specific and faster, as users will select which URLs to test rather than copying everything from history.
![Sending individual requests](https://private-user-images.githubusercontent.com/50321735/341832278-54b567a0-6b69-43f4-b727-f01709f4cc79.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjM3MDk1MzksIm5iZiI6MTcyMzcwOTIzOSwicGF0aCI6Ii81MDMyMTczNS8zNDE4MzIyNzgtNTRiNTY3YTAtNmI2OS00M2Y0LWI3MjctZjAxNzA5ZjRjYzc5LnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA4MTUlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwODE1VDA4MDcxOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWFkYjFiYWUwMjJhNGZlODYxODhmNmJhMzQ4ZDA5OTk5MGM1YWIwZDk2MDY1NTZjNjc5NTBlNmJkYTFhYmVjYTAmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.6rQyb7V5WUO89fRmsR1qwpB5I1dXGdm4_jxuURUUuAQ)
The page we aim to access belongs to a privileged user group, and we retain our session identifiers to verify if Privilege Escalation is feasible.
Simply clicking the 'RUN' button will execute the task.
The figure below illustrates that a URL may have an access issue, with the ‘Red’ color indicating a warning.
![Attempt details](https://private-user-images.githubusercontent.com/50321735/341828333-b7c81258-aa11-42dc-87c6-c25b1047056c.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjM3MDk1MzksIm5iZiI6MTcyMzcwOTIzOSwicGF0aCI6Ii81MDMyMTczNS8zNDE4MjgzMzMtYjdjODEyNTgtYWExMS00MmRjLTg3YzYtYzI1YjEwNDcwNTZjLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA4MTUlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwODE1VDA4MDcxOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTMyOGUzNjc5YTlhNjY2NmIwNjcxZDg0YjRjZmI5MDkxZjNjNmMwNzM3OGRhM2QwOTFjNjdhZjBiNGM4YmJjNDImWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.ZdHmQ8aapERqb8iYoEu44ykL8AwEQE3O_M0xPHRKiTU)
- Load requests from the proxy history by selecting the target hostname and clicking the ‘Load Requests’ button.
- URL and Header details
- Request attempts and results
- HTTP requests and responses
Please note that the number of attempts is contingent upon the specific target URL.
The feature enables the conversion of HTTP requests into JavaScript code, which can be particularly useful for going beyond XSS vulnerabilities and bypassing header restrictions.
To use this feature, simply right-click on any HTTP request and select 'Extensions > Agartha > Copy as JavaScript'.
![Copy as JavaScript](https://private-user-images.githubusercontent.com/50321735/344734290-c0149adb-d0ab-4aa3-98a1-34b86bd68d3f.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjM3MDk1MzksIm5iZiI6MTcyMzcwOTIzOSwicGF0aCI6Ii81MDMyMTczNS8zNDQ3MzQyOTAtYzAxNDlhZGItZDBhYi00YWEzLTk4YTEtMzRiODZiZDY4ZDNmLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNDA4MTUlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjQwODE1VDA4MDcxOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTVjNzgwNzQ3OTg3ZDA1ZGEwYjVjMWM2OTJkM2Q4N2JkMDc4YWFmOWU1OTA1ZGExYWEwMmUzZGJlZWUxYTU4MDImWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JmFjdG9yX2lkPTAma2V5X2lkPTAmcmVwb19pZD0wIn0.uehLZ5LNGaCecN9OSTv8-icdfxFAvIxLbpUH8c5PHcU)
It will automatically save to your clipboard, including some additional remarks for your reference. For example:
Http request with minimum header paramaters in JavaScript:
<script>
var xhr=new XMLHttpRequest();
xhr.open('GET','http://dvwa.local/vulnerabilities/xss_r/?name=XSS');
xhr.withCredentials=true;
xhr.send();
</script>
Http request with all header paramaters (except cookies, tokens, etc) in JavaScript, you may need to remove unnecessary fields:
<script>
var xhr=new XMLHttpRequest();
xhr.open('GET','http://dvwa.local/vulnerabilities/xss_r/?name=XSS');
xhr.withCredentials=true;
xhr.setRequestHeader('Host',' dvwa.local');
xhr.setRequestHeader('User-Agent',' Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:127.0) Gecko/20100101 Firefox/127.0');
xhr.setRequestHeader('Accept',' text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8');
xhr.setRequestHeader('Accept-Language',' en-US,en;q=0.5');
xhr.setRequestHeader('Accept-Encoding',' gzip, deflate, br');
xhr.setRequestHeader('DNT',' 1');
xhr.setRequestHeader('Sec-GPC',' 1');
xhr.setRequestHeader('Connection',' keep-alive');
xhr.setRequestHeader('Referer',' http://dvwa.local/vulnerabilities/xss_r/');
xhr.setRequestHeader('Upgrade-Insecure-Requests',' 1');
xhr.setRequestHeader('Priority',' u=1');
xhr.send();
</script>
For redirection, please also add this code before '</script>' tag:
xhr.onreadystatechange=function(){if (this.status===302){var location=this.getResponseHeader('Location');return ajax.call(this,location);}};
Please note that the JavaScript code will execute within the original user session, with many header fields automatically populated by the browser. However, in some cases, the server may require specific mandatory header fields. For example, certain requests might fail if the 'Content-Type' is incorrect. Therefore, you may need to adjust the code to ensure compatibility with the server's requirements.
Another tutorial link