BFScan

BFScan

Инструмент для первичной обработки APK / XAPK / APKM / DEX / JAR / WAR приложений.

• Поиск строк в исходном коде и ресурсах, похожих на URI, пути или секреты
• Генерация сырых HTTP-запросов и спецификаций OpenAPI на основе файлов конфигурации, аннотаций классов и методов
  • Поддерживаемые клиентские библиотеки
    • Square Retrofit
    • Ktorfit
    • Feign
  • Поддерживаемые серверные библиотеки
    • Spring Web Annotations
    • Spring SimpleUrlHandlerMapping
    • Spring BeanNameUrlHandlerMapping
    • JAX-RS, Jakarta RESTful Web Services
    • JAX, Jakarta Servlet Annotations
    • Micronaut
    • web.xml Servlets
    • jetty.xml Servlets
    • Struts 1 & Struts 2 Actions
    • Swagger & OpenApi Annotations
    • Ktor Type-safe routing
    • Play Framework routing

Использование

java -jar bfscan.jar <jar_war_apk> <...> [-m <mode>] [-ma <minifiedAnnotationsSupport>] [-r <mappingFile>] [-s <searchString>] [-u <url>] [-v <verbose>]

 -m <mode>                          Mode ([a]ll, [s]ecrets, [h]ttp), default: all
 -ma <minifiedAnnotationsSupport>   Minified or unknown annotations support (yes, no), default: yes
 -r <mappingFile>                   Deobfuscation mapping file
 -s <searchString>                  Search string
 -u <url>                           API base url (http://localhost/api/)
 -v <verbose>                       Log level (off, error, warn, info, debug, trace)

java -jar bfscan.jar test/*.apk -u https://example.tld/api/

Пример

Для этого класса, использующего аннотации Spring, будут сгенерированы следующие результаты.

@RestController
@RequestMapping("/api")
public class UserController {

    @PostMapping("createUser")
    public String create(@RequestParam Optional<String> someParamName, @RequestBody User user) {
        return "response";
    }

Результаты

Метод: com.mycompany.springbootexample.UserController->create

• Метод Spring

POST /api/createUser?someParamName=value HTTP/1.1
Host: localhost
Connection: close
Content-Type: application/json

{
  "name": "name",
  "age": 1
}

Обфусцированный код

Если вы анализируете приложение, которое использует поддерживаемую библиотеку, но его код обфусцирован, вы можете создать файл сопоставления для замены имён классов.

Для этого вы можете вручную воспользоваться функцией "Rename" в декомпилированном коде в jadx-gui, а затем сохранить сгенерированный файл сопоставления (File > Save mappings). Либо использовать пример файла сопоставления для Retrofit и изменить его под ваше приложение.

Пример анализа приложения с переименованием классов с помощью файла сопоставления.

java -jar BFScan.jar ./tests/example.apk -r ./tests/mapping.txt

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

Этот проект использует:

• jadx - Apache License 2.0