house

             /   |   \  ____  __ __  ______ ____
            /    ~    \/  _ \|  |  \/  ___// __ \
            \    Y    (  <_> )  |  /\___ \  ___/
             \___|_  / \____/|____//____  >\___  >
                   \/      House        \/     \/
            
                Dynamic Mobile Analysis Tool
                Contact: [email protected]

House: Инструментарий для анализа мобильных приложений во время выполнения с веб-интерфейсом, работающий на базе Frida и написанный на Python. Он предназначен для помощи в оценке мобильных приложений путем реализации динамического перехвата и отслеживания функций и призван максимально упростить написание скриптов Frida.

TL;DR

git clone https://github.com/nccgroup/house
cd house
pip3 install -r requirements.txt
pip3 install pipenv
pipenv --python=/usr/bin/python3 install
pipenv --python=/usr/bin/python3 shell
python3 app.py <PORT>

# or:
mkvirtualenv --python=/usr/local/bin/python3 house
workon house
pip install -r requirements.txt
python app.py <PORT>

# or: (only for Mac OS)
git clone https://github.com/nccgroup/house
cd house
pip3 install -r requirements.txt
pip3 install pipenv
pipenv --python=/usr/local/bin/python3 install
pipenv --python=/usr/local/bin/python3 shell
python3 app.py <PORT>

По умолчанию House привязывается к http://127.0.0.1:8000.

Чтобы получить обзор возможностей House, посетите руководство пользователя для получения подробной информации.

Новости

• Добавлен динамический перехват dex/jar, теперь House может перехватывать функции в динамически загружаемых dex/jar файлах
• Добавлена опция мини-скрипта для перехватчиков
• Перечисление ClassLoader

Примечание: Убедитесь, что версия Frida обновлена до >= 12.8.3 для перехвата функций в dex/jar файлах

Пример использования

В этом разделе представлен небольшой пример, иллюстрирующий базовое использование House. Демо-пример выполняется на небольшом тестовом Android-приложении: com.ha0k3.overloads.

Запуск

• Убедитесь, что Android-устройство подключено через USB и на нем запущен Frida server. Проверьте, что Frida server успешно запущен, с помощью следующей команды: frida-ps -U.

• Запустите приложение House, выполнив app.py: python app.py <PORT>.

• Откройте браузер и перейдите по адресу http://127.0.0.1:PORT.

• Обратите внимание, что информация об устройстве отображается на странице. Если нет, нажмите кнопку Обновить или перезапустите приложение и Frida server.

Мониторинг

• Динамическая генерация скриптов перехвата из шаблонов на основе конфигурационного файла, мониторинг ключевых операций, включая FILEIO, IPC и т.д.

• На данный момент это экспериментальная функция. Если вы найдете больше функций, которые нужно перехватывать, сообщите мне или отправьте PR.

Предзагрузка и боковая загрузка

• House теперь поддерживает sideload. На данный момент поддерживается боковая загрузка stetho, что упрощает проверку пользовательского интерфейса, хранилища и т.д.
• Это экспериментальная функция, но в будущем на этой вкладке будут добавлены дополнительные функции, такие как SSLStrip.

Перечисление

• Перечислить все загруженные классы:
• Перечислить все классы в Dex-файле:
• Перечислить все методы в заданном классе
• Управление историей скриптов

Трассировка нескольких функций

• Рендеринг скриптов и трассировка функций

• Перехват функций в динамически загружаемых dex/jar файлах

• Опция мини-скрипта

• Управление историей скриптов

Перехват функций

• С помощью House исследователи могут динамически изменять аргументы, передаваемые целевым функциям, и перенаправлять их.

• Иногда House не может идеально разобрать информацию об аргументах. Например, аргумент может быть специального типа. В примере приложения реализована функция isLit, которая принимает пользовательский объект в качестве аргумента. Для решения таких ситуаций House предоставляет простой "REPL". Исследователи безопасности могут динамически вводить скрипты Frida в REPL и изменять поведение функций.

• House предоставляет несколько функций REPL для упрощения тестирования:

  • inspectObject(obj) использует java.lang.reflect для проверки информации о полях внутри объекта.
  • setRetval(ret) принимает параметр и пытается привести его к правильному типу возвращаемого значения, используя конструктор исходного возвращаемого значения.
  • getStackTrace() выводит стек вызовов.
  • В будущем будет добавлено больше функций REPL.

  

Примечание: Для перехвата/вмешательства в конструктор укажите $init в качестве имени метода.

Часто задаваемые вопросы

Предварительные требования:

Для работы House вам понадобится:

1. Root-устроенное Android-устройство с запущенным frida-server, подключенное к компьютеру. Рекомендуется использовать только одно USB-устройство.
2. Локальная версия frida-python должна совпадать с версией frida-server.

Не удается получить устройство? Не работает?

Пожалуйста, попробуйте перезапустить оба сервера frida и House. Если все еще не работает, создайте issue.

Ошибка тайм-аута?

Часто возникает при подключении нескольких USB-устройств. Попробуйте перезапустить целевое приложение.

Ошибка Frida?

House тестировался с версией Frida 12.8.6; возможны проблемы с другими версиями. Также убедитесь, что версии frida-python и frida-server совпадают. Если все еще не работает, попробуйте запустить сгенерированные скрипты Frida вручную, чтобы проверить, работают ли они.

Благодарности

Особая благодарность следующим проектам с открытым исходным кодом за вдохновение для House:

1. Frida - отличный инструментарий инструментации, который сделал все это возможным.
2. Objection - вдохновение и руководство при создании части шаблонных скриптов Frida для House.
3. Inspeckage - вдохновение для функции Мониторинг в House.
4. 0xdea/frida-scripts - отличный арсенал скриптов Frida.

Контакты

Если у вас есть дополнительные вопросы о House или вы хотите помочь в его расширении, обращайтесь:

@haoOnBeat

Или отправьте электронное письмо: Hao Ke