This site is the archived OWASP Foundation Wiki and is no longer accepting Account Requests.
To view the new OWASP Foundation website, please visit https://owasp.org
Difference between revisions of "OWASP Mth3l3m3nt Framework Project"
Munir Njiru (talk | contribs) (→Videos) |
|||
(57 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
− | Main= | + | =Main= |
<!-- DO NOT ALTER OR REMOVE THE TEXT ON NEXT LINE --> | <!-- DO NOT ALTER OR REMOVE THE TEXT ON NEXT LINE --> | ||
<div style="width:100%;height:160px;border:0,margin:0;overflow: hidden;">[[File:OWASP_Project_Header.jpg|link=]]</div> | <div style="width:100%;height:160px;border:0,margin:0;overflow: hidden;">[[File:OWASP_Project_Header.jpg|link=]]</div> | ||
Line 7: | Line 7: | ||
| valign="top" style="border-right: 1px dotted gray;padding-right:25px;" | | | valign="top" style="border-right: 1px dotted gray;padding-right:25px;" | | ||
− | + | ||
− | |||
− | |||
− | |||
==Mth3l3m3nt Framework Project== | ==Mth3l3m3nt Framework Project== | ||
− | + | [[File:Mth3l3m3nt-dashboard.PNG|center|800px]] | |
− | + | OWASP Mth3l3m3nt Framework is a penetration testing aiding tool and exploitation framework. Mth3l3m3nt provides the ability to create or do custom LFI and RFI exploits fast with little or no effort at all. It also enables you to store all your quick wins based on its ability to manage HTTP bots, say no to runaway web shells and yes to centrally managed herds in large penetration testing engagements. | |
− | |||
− | |||
− | |||
− | |||
− | |||
==Description== | ==Description== | ||
− | + | The purpose of this project is to provide a platform to enable more flexible testing especially in aspects regarding to web security and the OWASP top 10 threats to web applications. This will enable free and opensource collaboration, being a web based tool, it is intended to make offensive security on the web easier and more efficient as it leverages on existing technologies with few dependencies. It is built on purely opensource components. It is intended to build up to a fully fledged web penetration testing framework with extensibility for zero day exploits in minutes to users. Currently the features it offers: | |
− | + | * Multi-Database Support (JIG,SQLite,MySQL,MongoDB,PostgreSQL,MSSQL) | |
− | + | * LFI/RFI exploitation Module | |
− | + | * Web Shell Generator (ASP,PHP,JSP,JSPX,CFM) | |
− | + | * Payload Encoder and Decoder | |
+ | * Custom Web Requester (GET/HEAD/TRACE/OPTIONS/POST) | ||
+ | * Web Herd (HTTP Bot tool to manage web shells) | ||
+ | * Client Side Obfuscator | ||
+ | * Cookie Theft Database Module for potency in stored XSS attacks. | ||
+ | * String Tools | ||
+ | * Whois | ||
− | ''' | + | '''[https://github.com/alienwithin/OWASP-mth3l3m3nt-framework Please contribute to this project.] |
''' | ''' | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
==Licensing== | ==Licensing== | ||
− | |||
− | |||
− | |||
− | |||
− | '''The OWASP | + | '''The OWASP Mth3l3m3nt Framework is free to use. |
'' Additionally, I also encourage you to contribute back to the project. I have no monopoly on this knowledge; however, we all have pieces of this knowledge from our experience. Let's begin by putting our individual pieces together to make something great. Great things happen when people work together. | '' Additionally, I also encourage you to contribute back to the project. I have no monopoly on this knowledge; however, we all have pieces of this knowledge from our experience. Let's begin by putting our individual pieces together to make something great. Great things happen when people work together. | ||
− | The OWASP | + | The OWASP Mth3l3m3nt Framework is licensed under the [http://www.gnu.org/licenses/agpl-3.0.en.html GNU AGPL v3 License], so you can copy, distribute and transmit the work, and you can adapt it, and use it commercially, but all provided that you attribute the work and if you alter, transform, or build upon this work, you may distribute the resulting work only under the same or similar license to this one. |
<!-- DO NOT ALTER OR REMOVE THE TEXT ON NEXT LINE --> | <!-- DO NOT ALTER OR REMOVE THE TEXT ON NEXT LINE --> | ||
| valign="top" style="padding-left:25px;width:200px;border-right: 1px dotted gray;padding-right:25px;" | | | valign="top" style="padding-left:25px;width:200px;border-right: 1px dotted gray;padding-right:25px;" | | ||
− | == What is OWASP | + | == What is the OWASP Mth3l3m3nt Framework Project == |
+ | It's a tool to exploit the web using the web when simply put. Imagine testing applications on the go, checking for vulnerabilities and analysing assets with no need for complex environments, just your simple web server and a database server, yes it can run on your tab too. tested with Palapa webserver on android running on Lighttpd and MySQL and it works well there also. This project aims to be that tool on the go and with time it will achieve its full potential. | ||
− | + | == Project Leader == | |
− | |||
− | |||
− | |||
− | + | * [https://www.owasp.org/index.php/Munir_Njiru Munir Njiru] | |
− | + | ==Project Website== | |
+ | * [http://alienwithin.github.io/OWASP-mth3l3m3nt-framework/ Project Website] | ||
− | == | + | == Related Projects == |
− | + | * [[https://www.owasp.org/index.php/ZAP ZAP]] | |
− | |||
− | |||
− | |||
+ | == Openhub == | ||
− | + | * [https://www.openhub.net/p/mth3l3m3nt-framework OWASP Mth3l3m3nt Framework] | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | == | + | ==Videos== |
+ | View the videos tab for an up to date list of videos. | ||
− | + | ==Documentation== | |
− | + | * [https://github.com/alienwithin/OWASP-mth3l3m3nt-framework/wiki User Guide] | |
− | + | * [http://alienwithin.github.io/OWASP-mth3l3m3nt-framework/framework-docs/ Developer Guide] | |
− | |||
− | + | ==Issue Tracker== | |
− | + | [https://github.com/alienwithin/OWASP-mth3l3m3nt-framework/issues Submit Issues/Bugs/Feature Requests] | |
− | == | ||
− | |||
− | |||
<!-- DO NOT ALTER OR REMOVE THE TEXT ON NEXT LINE --> | <!-- DO NOT ALTER OR REMOVE THE TEXT ON NEXT LINE --> | ||
Line 103: | Line 74: | ||
== Quick Download == | == Quick Download == | ||
− | + | The home of the OWASP Mth3l3m3nt Framework is on [https://github.com/alienwithin/mth3l3m3nt-framework GitHub.] You are encouraged to fork, edit and push your changes back to the project through git or edit the project directly on github. | |
− | |||
− | |||
− | |||
− | |||
− | The home of the OWASP | ||
However, if you like you may also download the master repository from the following links: | However, if you like you may also download the master repository from the following links: | ||
− | * [https://github.com/OWASP | + | * [https://github.com/alienwithin/OWASP-mth3l3m3nt-framework/zipball/master .zip file.] |
− | * [https://github.com/OWASP | + | * [https://github.com/alienwithin/OWASP-mth3l3m3nt-framework/tarball/master .tgz file.] |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | == | + | == Mailing List== |
+ | [https://lists.owasp.org/mailman/listinfo/owasp-mth3l3m3nt-framework-project Mailing List] | ||
− | + | ==Updates== | |
− | + | * Apr-04-2016: Added a cookie theft database module to enable XSS attacks become more potent. | |
− | + | * Nov-30-2015: Created and Updated [http://alienwithin.github.io/OWASP-mth3l3m3nt-framework/ Project Website] | |
− | + | * Nov-19-2015: Added [https://github.com/alienwithin/OWASP-mth3l3m3nt-framework/wiki User Guide] to the Git Repository | |
− | + | * Nov-18-2015: Added [https://github.com/alienwithin/OWASP-mth3l3m3nt-framework/commit/55e0a9bb38c5d29eaf6034ba9a8c1c0e07c3d2fc CVE-2015-7254 Exploit] to the framework. | |
− | + | * Aug-13-2015: Added [https://github.com/alienwithin/OWASP-mth3l3m3nt-framework/tree/master/dev-docs Developer Documentation] to the project. | |
==Classifications== | ==Classifications== | ||
− | |||
− | |||
− | |||
− | |||
{| width="200" cellpadding="2" | {| width="200" cellpadding="2" | ||
|- | |- | ||
| align="center" valign="top" width="50%" rowspan="2"| [[File:New projects.png|100px|link=https://www.owasp.org/index.php/OWASP_Project_Stages#tab=Incubator_Projects]] | | align="center" valign="top" width="50%" rowspan="2"| [[File:New projects.png|100px|link=https://www.owasp.org/index.php/OWASP_Project_Stages#tab=Incubator_Projects]] | ||
− | | align="center" valign="top" width="50%"| [[File:Owasp- | + | | align="center" valign="top" width="50%"| [[File:Owasp-breakers-small.png|link=]] |
|- | |- | ||
− | | align="center" valign="top" width="50%"| [[File:Owasp- | + | | align="center" valign="top" width="50%"| [[File:Owasp-builders-small.png|link=]] |
|- | |- | ||
− | | colspan="2" align="center" | [[File: | + | | colspan="2" align="center" | [[File:Agplv3-155x51.png|link=http://www.gnu.org/licenses/agpl-3.0.en.html]] |
|- | |- | ||
− | | colspan="2" align="center" | [[File: | + | | colspan="2" align="center" | [[File:Project_Type_Files_TOOL.jpg|link=]] |
|} | |} | ||
Line 156: | Line 109: | ||
=FAQs= | =FAQs= | ||
− | + | ==How can I participate in your project?== | |
− | + | All you have to do is make the Project Leader(s) aware of your available time to contribute to the project. It is also important to let the Leader(s) know how you would like to contribute and pitch in to help the project meet it's goals and milestones. There are many different ways you can contribute to an OWASP Project, but communication with the leads is key. | |
− | + | ||
− | + | ==If I am not a programmer can I participate in your project?== | |
+ | Yes, you can certainly participate in the project if you are not a programmer or technical. The project needs different skills and expertise and different times during its development. Currently the most important aspects though would be along, graphics and UX design as well as researchers etc. Any Ideas are welcome to participate in the project. | ||
+ | = User Guide = | ||
+ | Welcome to the OWASP Mth3l3m3nt framework User Guide, Here you will find a few tutorials on how to use and configure the system and make it better. | ||
− | == | + | == Table of Contents == |
− | + | ||
+ | *[https://github.com/alienwithin/OWASP-mth3l3m3nt-framework/wiki/WebServer-Configuration Initial WebServer Configuration] | ||
+ | *[https://github.com/alienwithin/OWASP-mth3l3m3nt-framework/wiki/Installation-Linux-(Apache) Installation of OMF on Linux running Apache] | ||
+ | *[https://github.com/alienwithin/OWASP-mth3l3m3nt-framework/wiki/Installation-Linux-(Nginx) Installation of OMF on Linux running Nginx] | ||
+ | *[https://github.com/alienwithin/OWASP-mth3l3m3nt-framework/wiki/Installation-Linux-(Lighttpd) Installation of OMF on Linux running Lighttpd] | ||
+ | *[https://github.com/alienwithin/OWASP-mth3l3m3nt-framework/wiki/Installation-Windows-(Apache) Installation of OMF on Windows running Apache] | ||
+ | *[https://github.com/alienwithin/OWASP-mth3l3m3nt-framework/wiki/Payloads-Module Using the Payloads Module] | ||
+ | *[https://github.com/alienwithin/OWASP-mth3l3m3nt-framework/wiki/Generic-Requests-Module Using the Generic Requests Module] | ||
+ | *[https://github.com/alienwithin/OWASP-mth3l3m3nt-framework/wiki/Shell-Generator-Module Using the Shell Generator Module] | ||
+ | *[https://github.com/alienwithin/OWASP-mth3l3m3nt-framework/wiki/Payload-Encoder-&-Decoder-Modules Using the Payload Encoder & Decoder Modules] | ||
+ | *[https://github.com/alienwithin/OWASP-mth3l3m3nt-framework/wiki/Client-Side-Obfuscator-Module Using the Client Side Obfuscator Module] | ||
+ | *[https://github.com/alienwithin/OWASP-mth3l3m3nt-framework/wiki/String-Tools-Module Using the String Tools Module] | ||
+ | *[https://github.com/alienwithin/OWASP-mth3l3m3nt-framework/wiki/LFI-Exploits-Module Using the LFI Exploit Module] | ||
+ | *[https://github.com/alienwithin/OWASP-mth3l3m3nt-framework/wiki/Web-Herd-Module-(HTTP-Bot) Using the Web Herd Module (HTTP Bot)] | ||
+ | *[https://github.com/alienwithin/OWASP-mth3l3m3nt-framework/wiki/Developing-LFI-Plugins-(Exploits) Developing LFI Exploit Plugins] | ||
+ | *[https://github.com/alienwithin/OWASP-mth3l3m3nt-framework/wiki/Using-The-Cookie-Theft-Module Using the Cookie Theft Module] | ||
− | == | + | = Videos = |
− | + | * [https://www.youtube.com/watch?v=ETnAmV3dxRE OWASP Mth3l3m3nt Framework vs bWAPP (Stored XSS Case)] | |
+ | * [https://www.youtube.com/watch?v=ZFWOKg9c_vA OWASP Mth3l3m3nt Framework in Africahackon 2015 CTF] | ||
+ | * [https://www.youtube.com/watch?v=QjBbrNtCx3A OWASP Mth3l3m3nt Framework Windows Installation] | ||
+ | * [https://www.youtube.com/watch?v=_Nw05Q3fc2A OWASP Mth3l3m3nt Framework Linux Installation] | ||
= Acknowledgements = | = Acknowledgements = | ||
Line 172: | Line 146: | ||
==Contributors== | ==Contributors== | ||
− | + | The OWASP Mth3l3m3nt Framework project is developed by a worldwide team of volunteers. A live update of project [https://github.com/alienwithin/mth3l3m3nt-framework/graphs/contributors contributors is found here]. We can't forget the great support of the [http://www.africahackon.com Africahackon] team as this began to take flight and for testing some of its aspects. A special thanks should be in order for the Pentest-tools team that inspired the Cookie theft module. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
The first contributors to the project were: | The first contributors to the project were: | ||
− | * [https://www.owasp.org/index.php/ | + | * [https://www.owasp.org/index.php/Munir_Njiru Munir Njiru] |
− | * [https://github.com/ | + | * [https://github.com/ikkez Christian Knuth] |
− | |||
− | |||
= Road Map and Getting Involved = | = Road Map and Getting Involved = | ||
− | + | Currently already available is the source code ready for download and use. Working on sample videos for it and a PDF document on usage. | |
− | |||
− | |||
− | |||
− | + | The project is envisioned to become a fully fledged security tool to test the OWASP top 10. Currently milestones achieved are: | |
− | + | * A web bot commander over HTTP to enable post-exploitation more easily | |
− | + | * A minimal web shell generator to use in commanding vulnerable hosts especially those with File Upload Vulnerabilities and some input injection ones. | |
+ | * A payload store to keep new and old payloads that you frequently use and lose. | ||
+ | * An LFI/RFI exploiter to perform File inclusion attacks and create new exploits on the same. | ||
+ | * A web request module similar to hurl.it currently supporting GET/HEAD/TRACE/OPTIONS/POST requests and data very useful when in need of fingerprinting based on server headers and response codes. | ||
+ | * A payload encoder and decoder to convert payload strings e.g. Hex with 0x prefix for SQL Injection payloads. | ||
+ | * Client Side Obfuscator | ||
+ | * String Tools | ||
+ | * Whois | ||
− | + | It is envisioned to be enabled to test and exploit all the OWASP top 10 vulnerabilities with ease and scalability. For instance currently developing an LFI exploit takes around 6 lines of code in the framework making it quite efficient even for zero day's along the same lines. This principle of ease is intended to be maintained through the project's lifecycle if not made easier. | |
− | |||
− | |||
− | |||
− | |||
− | Involvement in the development and promotion of the OWASP | + | Involvement in the development and promotion of the OWASP Mth3l3m3nt Framework Project is actively encouraged! |
You do not have to be a security expert in order to contribute. | You do not have to be a security expert in order to contribute. | ||
Some of the ways you can help: | Some of the ways you can help: | ||
− | * Helping find references to some | + | * Helping find references to some new exploits. |
* Project administration support. | * Project administration support. | ||
* Wiki editing support. | * Wiki editing support. | ||
− | * Writing | + | * Writing documentation for its use. |
+ | * Bringing in fresh design principles from a UX perspective | ||
+ | |||
Line 219: | Line 186: | ||
__NOTOC__ <headertabs /> | __NOTOC__ <headertabs /> | ||
− | [[Category:OWASP Project]] [[Category: | + | [[Category:OWASP Project]] [[Category:OWASP_Breakers]] [[Category:OWASP_Builders]] [[Category:OWASP_Tool]] |
Latest revision as of 12:30, 8 April 2016
Mth3l3m3nt Framework ProjectOWASP Mth3l3m3nt Framework is a penetration testing aiding tool and exploitation framework. Mth3l3m3nt provides the ability to create or do custom LFI and RFI exploits fast with little or no effort at all. It also enables you to store all your quick wins based on its ability to manage HTTP bots, say no to runaway web shells and yes to centrally managed herds in large penetration testing engagements. DescriptionThe purpose of this project is to provide a platform to enable more flexible testing especially in aspects regarding to web security and the OWASP top 10 threats to web applications. This will enable free and opensource collaboration, being a web based tool, it is intended to make offensive security on the web easier and more efficient as it leverages on existing technologies with few dependencies. It is built on purely opensource components. It is intended to build up to a fully fledged web penetration testing framework with extensibility for zero day exploits in minutes to users. Currently the features it offers:
Please contribute to this project. LicensingThe OWASP Mth3l3m3nt Framework is free to use. Additionally, I also encourage you to contribute back to the project. I have no monopoly on this knowledge; however, we all have pieces of this knowledge from our experience. Let's begin by putting our individual pieces together to make something great. Great things happen when people work together. The OWASP Mth3l3m3nt Framework is licensed under the GNU AGPL v3 License, so you can copy, distribute and transmit the work, and you can adapt it, and use it commercially, but all provided that you attribute the work and if you alter, transform, or build upon this work, you may distribute the resulting work only under the same or similar license to this one. |
What is the OWASP Mth3l3m3nt Framework ProjectIt's a tool to exploit the web using the web when simply put. Imagine testing applications on the go, checking for vulnerabilities and analysing assets with no need for complex environments, just your simple web server and a database server, yes it can run on your tab too. tested with Palapa webserver on android running on Lighttpd and MySQL and it works well there also. This project aims to be that tool on the go and with time it will achieve its full potential. Project LeaderProject WebsiteRelated Projects
OpenhubVideosView the videos tab for an up to date list of videos. DocumentationIssue Tracker |
Quick DownloadThe home of the OWASP Mth3l3m3nt Framework is on GitHub. You are encouraged to fork, edit and push your changes back to the project through git or edit the project directly on github. However, if you like you may also download the master repository from the following links: Mailing ListUpdates
Classifications |
How can I participate in your project?
All you have to do is make the Project Leader(s) aware of your available time to contribute to the project. It is also important to let the Leader(s) know how you would like to contribute and pitch in to help the project meet it's goals and milestones. There are many different ways you can contribute to an OWASP Project, but communication with the leads is key.
If I am not a programmer can I participate in your project?
Yes, you can certainly participate in the project if you are not a programmer or technical. The project needs different skills and expertise and different times during its development. Currently the most important aspects though would be along, graphics and UX design as well as researchers etc. Any Ideas are welcome to participate in the project.
Welcome to the OWASP Mth3l3m3nt framework User Guide, Here you will find a few tutorials on how to use and configure the system and make it better.
Table of Contents
- Initial WebServer Configuration
- Installation of OMF on Linux running Apache
- Installation of OMF on Linux running Nginx
- Installation of OMF on Linux running Lighttpd
- Installation of OMF on Windows running Apache
- Using the Payloads Module
- Using the Generic Requests Module
- Using the Shell Generator Module
- Using the Payload Encoder & Decoder Modules
- Using the Client Side Obfuscator Module
- Using the String Tools Module
- Using the LFI Exploit Module
- Using the Web Herd Module (HTTP Bot)
- Developing LFI Exploit Plugins
- Using the Cookie Theft Module
Contributors
The OWASP Mth3l3m3nt Framework project is developed by a worldwide team of volunteers. A live update of project contributors is found here. We can't forget the great support of the Africahackon team as this began to take flight and for testing some of its aspects. A special thanks should be in order for the Pentest-tools team that inspired the Cookie theft module.
The first contributors to the project were:
Currently already available is the source code ready for download and use. Working on sample videos for it and a PDF document on usage.
The project is envisioned to become a fully fledged security tool to test the OWASP top 10. Currently milestones achieved are:
- A web bot commander over HTTP to enable post-exploitation more easily
- A minimal web shell generator to use in commanding vulnerable hosts especially those with File Upload Vulnerabilities and some input injection ones.
- A payload store to keep new and old payloads that you frequently use and lose.
- An LFI/RFI exploiter to perform File inclusion attacks and create new exploits on the same.
- A web request module similar to hurl.it currently supporting GET/HEAD/TRACE/OPTIONS/POST requests and data very useful when in need of fingerprinting based on server headers and response codes.
- A payload encoder and decoder to convert payload strings e.g. Hex with 0x prefix for SQL Injection payloads.
- Client Side Obfuscator
- String Tools
- Whois
It is envisioned to be enabled to test and exploit all the OWASP top 10 vulnerabilities with ease and scalability. For instance currently developing an LFI exploit takes around 6 lines of code in the framework making it quite efficient even for zero day's along the same lines. This principle of ease is intended to be maintained through the project's lifecycle if not made easier.
Involvement in the development and promotion of the OWASP Mth3l3m3nt Framework Project is actively encouraged! You do not have to be a security expert in order to contribute. Some of the ways you can help:
- Helping find references to some new exploits.
- Project administration support.
- Wiki editing support.
- Writing documentation for its use.
- Bringing in fresh design principles from a UX perspective