OWASP Mobile Security Testing Guide

=Main=



{| style="padding: 0;margin:0;margin-top:10px;text-align:left;" |-
 * valign="top" style="border-right: 1px dotted gray;padding-right:25px;" |

Our Vision
Create a comprehensive methodology that covers the processes, techniques, and tools used during a mobile app security test, and define an exhaustive set of test cases that enables testers to deliver consistent and complete results.

At least, that was the initial vision. We soon discovered that we had to ask some deeper questions on what mobile app security is about: Without a reasonable definition a "secure" mobile app, there wasn't really anything to test against. We therefore went back to the drawing board and wrote the Mobile Application Verification Standard (MASVS), a document that defines the baseline security requirements. The overall project now consists of the standard, testing guide, and supplementary checklists.

Main Documents

 * valign="top" style="padding-left:25px;width:200px;border-right: 1px dotted gray;padding-right:25px;" |

Project Leaders
Bernhard Mueller

Sven Schleier

Project Initiator
Milan Singh Thakur

Road Map

 * Q2 2017: Beta release
 * Q3 2017: Version 1.0
 * Q4 2017: Produce A Printable Book

Parent Project
OWASP_Mobile_Security_Project

Licensing
The guide is licensed under the http://creativecommons.org/licenses/by-sa/3.0/ Creative Commons Attribution-ShareAlike 3.0 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.


 * }

=News=

January 28th, 2017: Mobile Crackmes and Reversing Tutorials
One key goal of the OWASP Mobile Testing Project is to build the ultimate learning resource and reference guide for mobile app reversers. As hands-on hacking is by far the best way to learn, we're planning to build the majority of content on practical examples.

Starting now, we'll be adding crackmes for Android and iOS to the GitHub repo that will then be used as examples throughout the guide. The goal is to collect enough resources for demonstrating the most important tools and techniques in our guide, as well as additional crackmes that can be used for practice.

For starters, we've added an Android Crackme (which already has a possible solution in the guide) and two levels of the so-called "Uncrackable App" challenge for iOS.

Structure of the Mobile Reversing Guide
For now we support iOS and Android. The high-level structure of the guide is as follows:


 * Tampering and Reverse Engineering - General Overview
 * Tampering and Reverse Engineering on Android
 * Tampering and Reverse Engineering on iOS

Ultimately, all how-tos in above sections of the guide should refer to the crackmes available for download.

We Need More Authors and Contributors!
Maybe you have noticed that the reversing guides linked above are incomplete. The reason for this is that we're still in the starting stages and don't have a lot of authors and contributors (in fact, 99% of the reversing content was written by a single author). We'd love to welcome *you* as a contributor of crackmes, tutorials, writeups, or simply new ideas for this project.

What You Can Do
The OWASP MSTG is an open project and there's a lot of flexibility - it mostly depends on your skill set and willingness to commit your time. That said, the some areas that need help are:


 * Solving crackmes and contributing a tutorial to the guide (preferable a technique that's not already documented. Check the TOC first).
 * Writing and adding new crackmes along with solutions (should also describe something not already in the guide. Cracking white-boxes, dynamic analysis using an emulator / introspection, etc. etc.).
 * General reversing write-ups to describe specific processes and techniques
 * Help us figure out [resiliency testing processes](https://github.com/OWASP/owasp-mstg/blob/master/Document/0x07b-Assessing_Software_Protections.md) and obfuscation metrics

How To Join
Read the author's guide first, and join the OWASP Mobile Security Project Slack Channel, where you'll find all the other project members. You can sign up for an account here.

January 22th, 2017: Mobile Testing Guide TOC Available
As of now, we'll be auto-generating a table of contents out of the current MSTG master branch. This reflects the current state of the guide, and should make it easier to coordinate work between authors. A short-term goal is to finalize the structure of the guide so we get a clearer picture of what will be included in the final document. Lead authors are encouraged to complete the outline of their respective chapters.

On another note, we still need additional authors to help with all sections of the guide, including mobile operating system overviews, testing processes and techniques, and reverse engineering. Especially iOS authors are in short supply! As usual, ping us on the Slack Channel if you want to contribute.

December 4th, 2016: Call For Authors: The Ultimate Open-Source Mobile App Reverse Engineering Guide
Reverse engineering is an art, and describing every available facet of it would fill a whole library. The sheer range techniques and possible specializations is mind-blowing: One can spend years working on a very specific, isolated sub-problem, such as automating malware analysis or developing novel de-obfuscation methods. For mobile app security testers, it can be challenging to filter through the vast amount of information and build a working methodology. Things become even more problematic when one is tasked to assess apps that are heavily obfuscated and have anti-tampering measures built in.

One of the main goals in the MSTG is to build the ultimate resource for mobile reverse engineers. This includes not only basic static and dynamic analysis, but also advanced de-obfuscation, scripting and automation. Obviously, writing all this content is a lot of work, both in terms of general content and OS-specific how-tos. We're therefore looking for talented authors that want to join the project early on. Topics include the following:


 * Basic Hybrid Static/Dynamic Analysis
 * Code Injection and Dynamic Instrumentation (Substrate, FRIDA)
 * Dynamic Binary Instrumentation (Valgrind, PIE)
 * Analysis Frameworks (Metasm / Miasm)
 * Symbolic Execution
 * DCA and DPA attacks on white-box crypto
 * Dynamic analysis frameworks (PANDA / DroidScope,...)
 * Anything else we might have missed

What is in for me?
All of this is unpaid, volunteer work. However, depending on your contribution, you will be named in the "lead authors" or "contributors" list, and you'll be able to point to the fact that you co-authored the guide. You'll also be contributing to the field, helping others who are just starting out, and in turn becoming a happier person yourself (reaping the full benefits of your altruism).

Where do I sign up?
First of all, have a look at the existing RE chapters outline:


 * Generic / Introduction
 * Android
 * iOS

You'll probably immediately have ideas on how you can contribute. If that's the case, read the author's guide first.

Then contact Bernhard Mueller - ideally directly on the OWASP Mobile Security Project Slack Channel, where you'll find all the other project members. You can sign up for an account here.

=FAQs=

How can I participate in your project?
First of all, read the author's guide and decide in what for you would like to contribute. Then, contact the lead author responsible for the chapter you are interested in. You can find their name and GitHub handle in the project README. Please always check with the responsible person first, or you might end up working on a chapter that's already being done by someone else. In any case, we encourage you to join OWASP Mobile Security Project Slack Channel, where you'll find all the other project members. You can sign up for an account here.

The home of the OWASP Mobile Security Testing Guide is on GitHub. The MASVS is hosted in a separate repository.

Where do you guys need help the most?
There's a lot of areas where you can help out:


 * Writing original content, such as describing testing processes and writing test cases. We're all doing this in our spare time, which unfortunately means that things sometimes slow down to a crawl. If you're knowledgeable in some area and have time available, we'd be incredibly thankful to anyone who contributes, even if it's only one or two test cases.


 * Reviewing content and giving feedback. The proper channel for questions and feedback is the GitHub issues system of the respective repo, contacting us on OWASP Mobile Security Project Slack Channel is another possibility.


 * Developing tools. For example, we still don't have an automated way of generating checklists out of the GitHub repo.


 * Contributing to auxiliary projects: The obfuscation metrics project is an auxiliary project that deals with specific forms of control flow and data obfuscation. This project needs experts in advanced obfuscation / de-obfuscation. Please contact us if you have experience in this area.

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, we are looking for researchers, writers, graphic designers, and a project administrator.

I contributed to the original Google Doc, but I'm not credited in the new version of the MSTG?
As we migrated some of the existing content, we did our best to backtrack the original authors and credit them appropriately. We also added a revision history that lists all the authors from old Google Docs. If you are not on that list but feel you should be, please contact Bernhard or Sven and they'll fix it. Or better yet, re-join the author's team and start contributing to the new guide.

= Acknowledgements =

Contributors
The Mobile Security Testing Guide was initiated by Milan Singh Thakur in 2015. The original document was hosted on Google Drive. Guide development was moved to GitHub in October 2016. Below is the full list of contributors for each revision.

MSTG in its current form
Lead Authors:


 * Stephen Corbiaux
 * Bernhard Mueller
 * Sven Schleier
 * Francesco Stillavato
 * Stefan Streichsbier
 * Abdessamad Temmar
 * Stephanie Vanroelen
 * Gerhard Wagner
 * Jeroen Willemsen

Contributors:


 * Davide Cioccia
 * Bao Le
 * Shiv Patel
 * Prathan Phongthiproek
 * Abhinav Sejpal
 * Anant Shrivastava
 * Pragati Singh
 * Milan Singh Thakur
 * Blessen Thomas
 * Dennis Titze
 * Bernard Wagner

MSTG "Beta 2" on Google Drive
Authors:


 * Mirza Ali
 * Stephen Corbiaux
 * Ryan Dewhurst
 * Mohammad Hamed Dadpour
 * David Fern
 * Bao Lee
 * Anto Joseph
 * Nutan Kumar Panda
 * Rahil Parikh
 * Julian Schütte
 * Abhinav Sejpal
 * Anant Shrivastava
 * Pragati Singh
 * Milan Singh Thakur
 * Stephanie Vanroelen
 * Gerhard Wagner

Reviewers:


 * Andrew Muller
 * Jonathan Carter
 * Stephanie Vanroelen
 * Milan Singh Thakur

MSTG "Beta 1" on Google Drive
Authors:


 * Mirza Ali
 * Mohammad Hamed Dadpour
 * David Fern
 * Rahil Parikh
 * Abhinav Sejpal
 * Pragati Singh
 * Milan Singh Thakur

Reviewers:


 * Andrew Muller
 * Jonathan Carter

Top Contributors:


 * Jim Manico
 * Yair Amit
 * Amin Lalji
 * OWASP Mobile Team