An Obfuscation-Neglect Android Malware Scoring System
Project description
An Obfuscation-Neglect Android Malware Scoring System
Quark-Engine is also bundled with Kali Linux, BlackArch. :shipit: A trust-worthy, practical tool that's ready to boost up your malware reverse engineering. https://twitter.com/quarkengine
Quark Script - Ecosystem for Mobile Security Tools
Innovative & Interactive
The goal of Quark Script aims to provide an innovative way for mobile security researchers to analyze or pentest the targets.
Based on Quark, we integrate decent tools as Quark Script APIs and make them exchange valuable intelligence to each other. This enables security researchers to interact with staged results and perform creative analysis with Quark Script.
Dynamic & Static Analysis
In Quark script, we integrate not only static analysis tools (e.g. Quark itself) but also dynamic analysis tools (e.g. objection).
Re-Usable & Sharable
Once the user creates a Quark script for specific analysis scenario. The script can be used in another targets. Also, the script can be shared to other security researchers. This enables the exchange of knowledges.
More APIs to come
Quark Script is now in a beta version. We'll keep releasing practical APIs and analysis scenarios.
See API document here.
2022 CWE Top 25 Showcases
Other CWE Showcases
Quark Web Report
With the following command, you can easily analyze the Android sample and output the web report.
See our demo here.
quark -a sample.apk -s -w quark_report.html
Navigate the Rules
To navigate the latest rules for Quark, please visit the Detection Rules Viewer! In this viewer, you can use labels and keywords to search for the rules you need.
Illustration
Why Quark?
Android malware analysis engine is not a new story. Every antivirus company has their own secrets to build it. With curiosity, we develop a malware scoring system from the perspective of Taiwan Criminal Law in an easy but solid way.
We have an order theory of criminal which explains stages of committing a crime. For example, crime of murder consists of five stages, they are determined, conspiracy, preparation, start and practice. The latter the stage the more we’re sure that the crime is practiced.
According to the above principle, we developed our order theory of android malware
. We developed five stages to see if the malicious activity is being practiced. They are 1. Permission requested. 2. Native API call. 3. Certain combination of native API. 4. Calling sequence of native API. 5. APIs that handle the same register. We not only define malicious activities and their stages but also develop weights and thresholds for calculating the threat level of a malware.
Malware evolved with new techniques to gain difficulties for reverse engineering. Obfuscation is one of the most commonly used techniques. In this talk, we present a Dalvik bytecode loader with the order theory of android malware to neglect certain cases of obfuscation.
Our Dalvik bytecode loader consists of functionalities such as 1. Finding cross reference and calling sequence of the native API. 2. Tracing the bytecode register. The combination of these functionalities (yes, the order theory) not only can neglect obfuscation but also match perfectly to the design of our malware scoring system.
Easy to Use and Reading Friendly Report
Quark provides 7 flexible report formats and 2 powerful features to boost your analysis.
7 Types of Report Formats:
- Summary Report
- Detail Report
- Web Report
- Label-based Report
- Behaviors Comparison Radar Chart
- Call Graph
- Rule Classification
2 Features to Boost Your Analysis:
Please see below for more details.
Quick Start
Requirements
- Python 3.8+
- git
- graphviz
- click >= 8.0.1 (For CLI supports)
Installation
$ pip3 install -U quark-engine
Get the Latest Rules
Now you can download the Quark official ruleset to your home directory with a simple command.
$ freshquark
Check --help
to see the detailed usage description.
$ quark --help
Test It Out
You may refer to the Quark Engine Document for more details of testing and development information.
Available Report or Features
Summary Report
Examine with rules.
quark -a 14d9f1a92dd984d6040cc41ed06e273e.apk -s
There is the possibility to select only one label to filter the rules:
quark -a 14d9f1a92dd984d6040cc41ed06e273e.apk -s network
There is also the possibility to select only one rule:
quark -a 14d9f1a92dd984d6040cc41ed06e273e.apk -s <path_to_the_rule>
Result
Note that if you want to select the default rules of Quark, the path to the ruleset is $HOME/.quark-engine/quark-rules/rules/
.
Detail Report
This is how we examine a real android malware (candy corn) with one single rule (crime).
quark -a 14d9f1a92dd984d6040cc41ed06e273e.apk -d
There is the possibility to select only one label to filter the rules:
quark -a 14d9f1a92dd984d6040cc41ed06e273e.apk -d network
There is also the possibility to select only one rule:
quark -a 14d9f1a92dd984d6040cc41ed06e273e.apk -d <path_to_the_rule>
Result
Note that if you want to select the default rules of Quark, the path to the ruleset is $HOME/.quark-engine/quark-rules/rules/
.
Label-based Report
Check which topic (indicated by labels) of the malware is more aggressive.
quark -a Ahmyth.apk -l detailed
Result
Behaviors Comparison Radar Chart
With the following command, you can compare different APK actions based on the max confidence of rule labels and generate a radar chart.
quark -a first.apk -a second.apk -C
Result
Call Graph for Every Potential Malicious Activity
You can add the -g
option to the quark command, and you can
get the call graph (only those rules match with 100% confidence)
quark -a Ahmyth.apk -s -g
Result
Rules Classification
You can add the -c
option to the quark command, and you can
output the rules classification with the mutual parent function (only those rules match with 100% confidence).
quark -a Ahmyth.apk -s -c
Result
Radiocontrast
Radiocontrast is a Quark API that quickly generates Quark rules from a specified method. It builds up 100% matched rules by using native APIs in that method. The feature lets you easily expose the behavior of a method, just like radiocontrast.
For example, we want to know the behavior of a method called Lahmyth/mine/king/ahmyth/CameraManager;->startUp(I)V,
in Ahmyth.apk.
Here is the simplest way for Radiocontrast usage:
from quark.radiocontrast import RadioContrast
# The target APK.
APK_PATH = "~/apk-malware-sample/Ahmyth.apk"
# The method that you want to generate rules.
TARGET_METHOD = "Lahmyth/mine/king/ahmyth/CameraManager;->startUp(I)V"
# The output directory for generated rules.
GENERATED_RULE_DIR = "~/generated_rules"
radiocontrast = RadioContrast(
APK_PATH,
TARGET_METHOD,
GENERATED_RULE_DIR
)
# param: web_editor: the file path for generated rules web editor.
# param: percentile_rank: the percentile number of api filter rank.
# For example, percentile_rank=0.2 use 20% least usage count APIs to generate rules
radiocontrast.generate_rule(percentile_rank=0.2, web_editor="ahmyth.html")
Parallelizing Quark
Now Quark supports multiprocessing for analyzing APKs parallelly. By adding the option --multi-process
, you can set the number of processes.
Note that Quark-Engine automatically limits this value to be less than or equal to the number of CPUs - 1. This restriction is done to avoid the CPU from running out of memory.
quark -a Ahmyth.apk -s --multi-process 4
Upcoming Unstable Feature
Now Quark also supports Rizin as one of our Android analysis frameworks. You can use option --core-library
with rizin
to enable the Rizin-based analysis library.
quark -a Ahmyth.apk -s --core-library rizin
Acknowledgments
The Honeynet Project
Google Summer Of Code
Quark-Engine has been participating in the GSoC under the Honeynet Project!
- 2021:
Stay tuned for the upcoming GSoC! Join the Honeynet Slack chat for more info.
Quark MIT Program
Quark MIT aims to create a WIN-WIN for both new comers and the community.
For new comers, the community helps you to build a stronger resume by creating specific works that fit the job description of your DREAM JOB.
For the community, Quark-Engine gets new energy by the work the new comers contribute. And the most important of all, the Quark community gets to GROW.
- Find more details here
Core Values of Quark Engine Team
- We love battle fields. We embrace uncertainties. We challenge impossibles. We rethink everything. We change the way people think. And the most important of all, we benefit ourselves by benefit others first.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for quark_engine-22.10.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7290e4a36da310994f2fad596eb2cd5c698620162a5dd094496389688d726751 |
|
MD5 | 31b22c77e1957443c554f29f97b151e3 |
|
BLAKE2b-256 | c5c017baf8a12a6a301855742a6ff65ad45c86f44d0ab68fac660623c6101ee7 |