frida-fusion 0.1.0__tar.gz

frida-fusion-0.1.0/PKG-INFO

@@ -0,0 +1,74 @@
+Metadata-Version: 2.1
+Name: frida-fusion
+Version: 0.1.0
+Summary: Hook your mobile tests with Frida
+Author-email: "Helvio Junior (M4v3r1ck)" <helvio_junior@hotmail.com>
+Maintainer-email: "Helvio Junior (M4v3r1ck)" <helvio_junior@hotmail.com>
+Project-URL: Documentation, https://github.com/helviojunior/frida-fusion
+Project-URL: Source, https://github.com/helviojunior/frida-fusion
+Project-URL: Tracker, https://github.com/helviojunior/frida-fusion
+Project-URL: Author, https://github.com/helviojunior
+Keywords: Frida Fusion,Frida,Frida Scripts,development,red team
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Security
+Classifier: Topic :: Utilities
+Requires-Python: <4,>=3.9
+Description-Content-Type: text/markdown
+
+# Frida Fusion 
+
+Hook your mobile tests with Frida.
+
+```bash
+ [ FRIDA ]—o—( FUSION )—o—[ MOBILE TESTS ] // v0.1.0
+     > hook your mobile tests with Frida
+
+
+optional arguments:
+  -h, --help                                    show this help message and exit
+
+Device selector:
+  -D [ID], --device [ID]                        Connect to device with the given ID
+  -U, --usb                                     Connect to USB device
+  -R, --remote                                  Connect to remote frida-server
+  -H [HOST], --host [HOST]                      Connect to remote frida-server on HOS
+
+Application selector:
+  -f [APP ID], --package [APP ID]               Spawn application ID
+  -p [PID], --attach-pid [PID]                  Spawn application ID
+
+General Setting:
+  -s [path], --script-path [path]               JS File path or directory with Frida script
+  --delay-injection                             Delay script injection
+  --show-time                                   Display time
+  -o [output file]                              Save output to disk (default: none)
+  -l [level], --min-level [level]               Minimum log level to be displayed (V,D,I,W,E,F) (default: I)
+
+Modules:
+  --list-modules                                List available modules
+  -m ENABLED_MODULES, --module ENABLED_MODULES  Enabled module by name. You can specify multiple values repeating the flag.
+```
+
+## Install
+
+> :information_source: We recommend using `pipx` rather than `pip` for system-wide installation.
+
+```
+python3 -m pipx install frida-fusion
+```
+
+> :information_source: Check whether you also need to run the `python3 -m pipx ensurepath` command.
+

frida-fusion-0.1.0/README.md

@@ -0,0 +1,44 @@
+# Frida Fusion 
+
+Hook your mobile tests with Frida.
+
+```bash
+ [ FRIDA ]—o—( FUSION )—o—[ MOBILE TESTS ] // v0.1.0
+     > hook your mobile tests with Frida
+
+
+optional arguments:
+  -h, --help                                    show this help message and exit
+
+Device selector:
+  -D [ID], --device [ID]                        Connect to device with the given ID
+  -U, --usb                                     Connect to USB device
+  -R, --remote                                  Connect to remote frida-server
+  -H [HOST], --host [HOST]                      Connect to remote frida-server on HOS
+
+Application selector:
+  -f [APP ID], --package [APP ID]               Spawn application ID
+  -p [PID], --attach-pid [PID]                  Spawn application ID
+
+General Setting:
+  -s [path], --script-path [path]               JS File path or directory with Frida script
+  --delay-injection                             Delay script injection
+  --show-time                                   Display time
+  -o [output file]                              Save output to disk (default: none)
+  -l [level], --min-level [level]               Minimum log level to be displayed (V,D,I,W,E,F) (default: I)
+
+Modules:
+  --list-modules                                List available modules
+  -m ENABLED_MODULES, --module ENABLED_MODULES  Enabled module by name. You can specify multiple values repeating the flag.
+```
+
+## Install
+
+> :information_source: We recommend using `pipx` rather than `pip` for system-wide installation.
+
+```
+python3 -m pipx install frida-fusion
+```
+
+> :information_source: Check whether you also need to run the `python3 -m pipx ensurepath` command.
+

frida-fusion-0.1.0/frida_fusion/__main__.py

@@ -0,0 +1,7 @@
+#!/usr/bin/python3
+# -*- coding: UTF-8 -*-
+
+from . import fusion
+
+if __name__ == "__main__":
+    fusion.run()

frida-fusion-0.1.0/frida_fusion/__meta__.py

@@ -0,0 +1,9 @@
+__version__ = '0.1.0'
+__title__ = "Frida Fusion"
+__description__ = "📱 frida-fusion - runtime mobile exploration"
+__url__ = "https://github.com/helviojunior/frida-fusion"
+__build__ = 0x63c974a8
+__author__ = "Helvio Junior (M4v3r1ck)"
+__author_email__ = "helvio_junior@hotmail.com"
+__license__ = "GPL-3.0"
+__copyright__ = "Copyright Helvio Junior"

frida-fusion-0.1.0/frida_fusion/args.py

@@ -0,0 +1,151 @@
+#!/usr/bin/python3
+# -*- coding: UTF-8 -*-
+
+import argparse
+import sys
+
+from .libs.color import Color
+from .__meta__ import __description__
+
+class Arguments(object):
+    ''' Holds arguments used by the Frida Fusion '''
+    restore = False
+
+    def __init__(self, custom_args=''):
+        self.verbose = any(['-v' in word for word in sys.argv])
+        self.restore = any(['-R' in word for word in sys.argv])
+        self.args = self.get_arguments(custom_args)
+
+    def _verbose(self, msg):
+        if self.verbose:
+            return Color.s(msg)
+        else:
+            return argparse.SUPPRESS
+
+    def get_arguments(self, custom_args=''):
+        ''' Returns parser.args() containing all program arguments '''
+
+        parser = argparse.ArgumentParser(
+            usage=argparse.SUPPRESS,
+            formatter_class=lambda prog: argparse.HelpFormatter(prog, max_help_position=80,
+                                                                width=130)
+        )
+
+        device_group = parser.add_argument_group('Device selector')
+        self._add_device_args(device_group)
+
+        app_group = parser.add_argument_group('Application selector')
+        self._add_app_args(app_group)
+
+        glob = parser.add_argument_group('General Setting')
+        self._add_global_args(glob)
+
+        modules_group = parser.add_argument_group('Modules')
+        self._add_modules_args(modules_group)
+
+        return parser.parse_args()
+
+    def _add_app_args(self, app):
+        app.add_argument('-f',
+                         '--package',
+                         dest='app_id',
+                         metavar='[APP ID]',
+                         required=False,
+                         default=None,
+                         help='Spawn application ID')
+
+        app.add_argument('-p',
+                         '--attach-pid',
+                         dest='pid',
+                         metavar='[PID]',
+                         default=0,
+                         required=False,
+                         type=int,
+                         help='Spawn application ID')
+
+    def _add_device_args(self, device):
+        device.add_argument('-D',
+                            '--device',
+                            dest='device_id',
+                            metavar='[ID]',
+                            type=str,
+                            required=False,
+                            default=None,
+                            help='Connect to device with the given ID')
+
+        device.add_argument('-U',
+                            '--usb',
+                            action='store_true',
+                            dest='use_usb',
+                            default=False,
+                            required=False,
+                            help='Connect to USB device')
+
+        device.add_argument('-R',
+                            '--remote',
+                            action='store_true',
+                            dest='use_remote',
+                            default=False,
+                            required=False,
+                            help='Connect to remote frida-server')
+
+        device.add_argument('-H',
+                            '--host',
+                            dest='remote_host',
+                            metavar='[HOST]',
+                            type=str,
+                            required=False,
+                            default=None,
+                            help='Connect to remote frida-server on HOS')
+
+    def _add_global_args(self, glob):
+        glob.add_argument('-s',
+                          '--script-path',
+                          dest='frida_scripts',
+                          default=None,
+                          metavar='[path]',
+                          type=str,
+                          help='JS File path or directory with Frida script')
+
+        glob.add_argument('--delay-injection',
+                          action='store_true',
+                          dest='delay',
+                          default=False,
+                          help='Delay script injection')
+
+        glob.add_argument('--show-time',
+                          action='store_true',
+                          dest='show_time',
+                          default=False,
+                          help='Display time')
+
+        glob.add_argument('-o',
+                          action='store',
+                          dest='out_file',
+                          metavar='[output file]',
+                          type=str,
+                          help=Color.s('Save output to disk (default: {G}none{W})'))
+
+        glob.add_argument('-l',
+                          '--min-level',
+                          action='store',
+                          dest='debug_level',
+                          metavar='[level]',
+                          type=str,
+                          default='I',
+                          help=Color.s('Minimum log level to be displayed (V,D,I,W,E,F) (default: {G}I{W})'))
+
+    def _add_modules_args(self, modules):
+        modules.add_argument('--list-modules',
+                             action='store_true',
+                             default=False,
+                             dest='list_modules',
+                             help=Color.s('List available modules'))
+
+        modules.add_argument('-m',
+                             '--module',
+                             action='append',
+                             dest='enabled_modules',
+                             help='Enabled module by name. You can specify multiple values repeating the flag.')
+
+

frida-fusion-0.1.0/frida_fusion/config.py

@@ -0,0 +1,218 @@
+#!/usr/bin/python3
+# -*- coding: UTF-8 -*-
+import os
+import errno
+import sys
+import signal
+from pathlib import Path
+
+from .module import Module
+from .libs.color import Color
+from .libs.logger import Logger
+from .__meta__ import __version__
+
+
+class Configuration(object):
+    ''' Stores configuration variables and functions for Frida Fusion. '''
+    version = '0.0.0'
+
+    initialized = False  # Flag indicating config has been initialized
+    debug_level = 0
+    cmd_line = ''
+    base_path = str(Path(__file__).resolve().parent)
+    db_path = os.path.join(str(Path(".").resolve()), "fusion.db")
+    enabled_modules = {}
+
+    # Device vars
+    device_id = None
+    use_usb = False
+    remote_host = None
+
+    # App vars
+    package = ''
+    pid = 0
+
+    # Scripts
+    frida_scripts = None
+
+    # General
+    out_file = None
+    print_timestamp = False
+    use_delay = False
+
+    @staticmethod
+    def initialize():
+        '''
+            Sets up default initial configuration values.
+            Also sets config values based on command-line arguments.
+        '''
+
+        # Only initialize this class once
+        if Configuration.initialized:
+            return
+
+        Configuration.debug_level = 0  # Verbosity level.
+
+        # Overwrite config values with arguments (if defined)
+        Configuration.load_from_arguments()
+
+        Configuration.initialized = True
+
+    @staticmethod
+    def load_from_arguments():
+        ''' Sets configuration values based on Argument.args object '''
+        from .args import Arguments
+
+        config_check = 0
+
+        sys.argv[0] = 'frida-fusion'
+
+        list_modules = any(['--list-modules' == word for word in sys.argv])
+        #show_help = any(['-h' == word for word in sys.argv])
+
+        if list_modules:
+            mods = Module.list_modules()
+            max_name = max(iter([
+                len(m.name) + 3
+                for _, m in mods.items()
+            ] + [15]))
+            Color.pl(f"Available modules")
+            Color.pl(f"  {'Module Name'.ljust(max_name)} : Description")
+            for _, m in mods.items():
+                Color.pl(f"  {m.name.ljust(max_name)} : {m.description}")
+
+            print("")
+            sys.exit(0)
+
+        args = Arguments().args
+
+        Color.pl('{+} {W}Startup parameters')
+
+        if args.out_file is not None and args.out_file != '':
+            Configuration.out_file = args.out_file
+            try:
+                with open(Configuration.out_file, 'a') as f:
+                    # file opened for writing. write to it here
+                    Logger.out_file = Configuration.out_file
+                    f.write(Color.sc(Configuration.get_banner()) + '\n')
+                    f.write(Color.sc('{+} {W}Startup parameters') + '\n')
+                    pass
+            except IOError as x:
+                if x.errno == errno.EACCES:
+                    Color.pl('{!} {R}error: could not open output file to write {O}permission denied{R}{W}\r\n')
+                    sys.exit(1)
+                elif x.errno == errno.EISDIR:
+                    Color.pl('{!} {R}error: could not open output file to write {O}it is an directory{R}{W}\r\n')
+                    sys.exit(1)
+                else:
+                    Color.pl('{!} {R}error: could not open output file to write{W}\r\n')
+                    sys.exit(1)
+
+        if args.app_id is None and args.pid == 0:
+            Color.pl('{!} {R}error: you must specify either {O}--package{R} or {O}--attach-pid{R}{W}\r\n')
+            Configuration.mandatory()
+
+        if args.app_id is not None and args.pid > 0:
+            Color.pl('{!} {R}error: you must specify just one parameter {O}--package{R} or {O}--attach-pid{R}{W}\r\n')
+            Configuration.mandatory()
+
+        if args.app_id is not None:
+            Configuration.package = args.app_id
+            Logger.pl('     {C}package:{O} %s{W}' % Configuration.package)
+        elif args.pid > 0:
+            Configuration.pid = args.pid
+            Logger.pl('     {C}process id:{O} %s{W}' % Configuration.pid)
+
+        if args.use_usb is True:
+            Configuration.use_usb = True
+            Logger.pl('     {C}device:{O} USB{W}')
+        elif args.device_id is not None:
+            Configuration.device_id = args.device_id
+            Logger.pl('     {C}device:{O} %s{W}' % Configuration.device_id)
+        elif args.use_remote and args.remote_host is not None:
+            Configuration.remote_host = args.remote_host
+            Logger.pl('     {C}device:{O} remote %s{W}' % Configuration.remote_host)
+
+        if Configuration.use_usb is False and Configuration.device_id is None and Configuration.remote_host is None:
+            Color.pl('{!} {R}error: you must specify just one parameter {O}--usb{R}, {O}--device{R} or {O}--remote{R}{W}\r\n')
+            Configuration.mandatory()
+
+        if args.frida_scripts is not None and args.frida_scripts.strip() != "":
+            if not os.path.exists(args.frida_scripts):
+                Color.pl(
+                    '{!} {R}error: scripts path not found{R}{W}\r\n')
+                Configuration.mandatory()
+            Configuration.frida_scripts = args.frida_scripts
+
+        if Configuration.frida_scripts is None:
+            Color.pl(
+                '{!} {R}error: you must specify scripts path {O}--script-path{R}{W}\r\n')
+            Configuration.mandatory()
+
+        Logger.pl('     {C}scripts path:{O} %s{W}' % Configuration.frida_scripts)
+
+        if args.delay:
+            Configuration.use_delay = True
+
+        if args.show_time:
+            Configuration.print_timestamp = True
+
+        if str(args.debug_level).upper() not in Color.level_map.keys():
+            Color.pl(
+                '{!} {R}error: invalid debug level{R}{W}\r\n')
+            Configuration.mandatory()
+
+        Configuration.debug_level = Color.level_map.get(str(args.debug_level).upper(), 0)
+
+        Logger.pl('     {C}min debug level:{O} %s{W}' % str(args.debug_level).upper())
+
+        if args.enabled_modules is not None and isinstance(args.enabled_modules, list):
+            mods = Module.list_modules()
+            for mod in args.enabled_modules:
+                fm = next(iter([
+                    m
+                    for _, m in mods.items()
+                    if m.name.lower() == mod.lower()
+                ]), None)
+                if fm is None:
+                    Color.pl(
+                        '{!} {R}error: module {O}%s{R} not found{W}\r\n' % mod)
+                    sys.exit(1)
+
+                name = fm.name.lower()
+                if name not in Configuration.enabled_modules.keys():
+                    Configuration.enabled_modules[name] = fm
+
+        if len(Configuration.enabled_modules) > 0:
+            Logger.pl('     {C}modules:{O} %s{W}' % ', '.join([
+                m.name
+                for _, m in Configuration.enabled_modules.items()
+            ]))
+
+        Logger.pl("")
+
+    @staticmethod
+    def get_banner():
+        Configuration.version = str(__version__)
+
+        return '''
+ {P}[ {R}FRIDA {P}]{G}—o—( {O}FUSION {G})—o—{P}[ {C}MOBILE TESTS {P}] {W}{D}// v%s{W}
+     {O}> {W}{D}{O}hook your mobile tests with Frida{W}
+    
+    ''' % Configuration.version
+
+    @staticmethod
+    def mandatory():
+        Color.pl(
+            '{!} {R}error: missing a mandatory option, use {O}-h{R} help{W}\r\n')
+        sys.exit(1)
+
+    @staticmethod
+    def exit_gracefully(code=0):
+        ''' Deletes temp and exist with the given code '''
+        exit(code)
+
+    @staticmethod
+    def kill(code=0):
+        ''' Deletes temp and exist with the given code '''
+        os.kill(os.getpid(), signal.SIGTERM)