QuadraInspect

   ____                  __           ____                           __ 
  / /\ \__  ______ _____/ /________ _/  _/___  _________  ___  _____/ /_
 / / / / / / / __ `/ __  / ___/ __ `// // __ \/ ___/ __ \/ _ \/ ___/ __/
/ /_/ / /_/ / /_/ / /_/ / /  / /_/ // // / / (__  ) /_/ /  __/ /__/ /_  
\___\\_\__,_/\__,_/\__,_/_/   \__,_/___/_/ /_/____/ .___/\___/\___/\__/  
                                                /_/                     

QuadraInspect는 AndroPass, APKUtil, RMS, MobFS를 통합한 안드로이드 프레임워크로, 안드로이드 애플리케이션의 보안을 분석하는 강력한 도구를 제공합니다. AndroPass는 안드로이드 애플리케이션의 인증 및 권한 부여 메커니즘 보안 분석에 중점을 둔 도구이고, APKUtil은 APK 파일에서 귀중한 정보를 추출하는 도구입니다. 마지막으로 MobFS와 RMS는 애플리케이션의 스토리지를 가상 환경에 마운트하여 파일 시스템을 분석하는 것을 용이하게 합니다.

이 세 가지 도구를 결합함으로써 QuadraInspect는 안드로이드 애플리케이션의 취약점 분석에 대한 포괄적인 접근 방식을 제공합니다. 이 프레임워크는 개발자, 보안 연구원, 침투 테스터가 자신의 또는 타사 애플리케이션의 보안을 평가하는 데 사용될 수 있습니다. QuadraInspect는 세 가지 도구 모두에 대한 통합 인터페이스를 제공하여 사용을 더 쉽게 만들고 종합적인 취약점 분석에 필요한 시간을 단축합니다. 궁극적으로 이 프레임워크는 안드로이드 애플리케이션의 보안을 강화하고 잠재적인 위협으로부터 사용자의 민감한 데이터를 보호하는 것을 목표로 합니다.

요구 사항

• Windows, Linux 또는 Mac
• NodeJs 설치
• Python 3.10 이상 설치
• OpenSSL-3 설치
• Wkhtmltopdf 설치
• 애드인에 따른 추가 사항

설치

ubuntu 또는 기타 linux에 python3.10 설치

• Step 0: 사전 요구사항

sudo apt install wget build-essential libreadline-gplv2-dev libncursesw5-dev libssl-dev libsqlite3-dev tk-dev libgdbm-dev libc6-dev libbz2-dev libffi-dev zlib1g-dev  

• Step 1: python 다운로드

sudo su && wget https://www.python.org/ftp/python/3.10.8/Python-3.10.8.tgz && tar xzf Python-3.10.8.tgz && cd Python-3.10.8 

• Step 2: python 설치

./configure --enable-optimizations 
make altinstall 

도구 설치

도구를 설치하려면 다음을 수행해야 합니다: 첫째: git clone https://github.com/morpheuslord/QuadraInspect

둘째: 관리자 cmd 또는 powershell을 열고 (Mobfs 설정을 위해) 다음을 실행합니다:

pip install -r requirements.txt && python main.py

또는

sudo pip3.10 install -r requirements.txt && sudo python3.10 main.py

셋째: QuadraInspect가 로드되면 이 명령을 실행합니다 QuadraInspect Main>> : START install_tools

도구들은 tools 디렉토리에 다운로드되며, setup.py와 setup.bat 명령이 자동으로 실행되어 전체 설치가 완료됩니다.

애드인

애드인은 커뮤니티가 편집할 수 있도록 마련되었습니다. 관심 있는 사람은 누구든지 config/additional.py 파일을 편집하여 새로운 도구를 추가할 수 있으며, 도구와 프로그램의 원활한 설치에 필요한 모든 특정 구성도 포함됩니다.

• 애드인은 사용 모드에 따라 update addins 또는 update-addins 명령을 사용하여 업데이트할 수 있습니다.
• 각 애드인에 대해 해당하는 config 파일을 작성하여 config 디렉토리에 배치해야 합니다.
• 각 도구는 main.py도 업데이트해야 합니다. 여러분 모두가 지원과 도구 구축의 일환으로 더 많은 도구를 추가해 주시기를 바랍니다.

현재 애드인에는 APKEditor라는 추가 도구가 하나 있습니다. START addins 명령으로 설치할 수 있으며, 실행하려면 java RTE가 필요합니다.

사용법

각 모듈에는 명령어와 설명이 상세히 나와 있고 작동을 변경할 수 있는 도움말 기능이 있습니다.

OS 및 모드

• Linux와 Mac에서는 sudo 사용자로 실행해야 합니다.
• Windows에서는 설치만 Admin으로 할 수 있으며, 나머지는 일반 사용자로 수행할 수 있습니다.

원활한 작동을 위해 해결해야 할 핵심 사항은 다음과 같습니다:

• 공격을 시작하기 전에 APK 파일 또는 대상을 선언해야 합니다.
• 공격은 이 프레임워크를 통해 결합된 별개의 개체이므로, 사용 방법을 조사하는 것이 좋습니다.
• APK 파일은 args를 사용하거나 도구 내에서 SET target을 사용하여 선언할 수 있습니다.
• 대상 APK 파일은 모든 도구가 해당 폴더에서 대상 파일을 검색하므로 target 폴더에 배치해야 합니다.

모드

두 가지 모드가 있습니다:

|
└─> F 모드
└─> A 모드

F 모드

f 모드는 프롬프트 등을 통해 프레임워크의 대화형 변형을 사용할 수 있는 활성 인터페이스를 제공하는 모드입니다.

F 모드는 일반 모드이며 쉽게 사용할 수 있습니다.

A 모드

A 모드 또는 인수 모드는 인수를 통해 입력을 받아 사용자의 개입 없이 명령을 실행합니다. 이는 메인 메뉴로 제한되며, 향후에는 이 기능을 통합된 코드까지 확장할 계획입니다.

python main.py --target <APK_file> --mode a --command install_tools/tools_name/apkleaks/mobfs/rms/apkleaks

메인 모듈

전체 도구의 메인 메뉴에는 다음과 같은 옵션과 명령이 있습니다:

프레임 모드:

인수 모드:

위에서 언급했듯이, 도구를 사용하기 전에 대상을 설정해야 합니다.

Apkleaks 메뉴

APKLeaks 메뉴도 매우 직관적이며 고려할 사항이 몇 가지 있습니다:

• SET output 및 SET json-out 옵션은 실제 파일이 아닌 파일 이름을 입력받으며, result 디렉토리에 출력을 생성합니다.
• SET pattern 옵션은 json 패턴 파일의 이름을 입력받습니다. JSON 파일은 pattern 디렉토리에 있어야 합니다.

Mobfs

Mobfs는 매우 간단합니다. 기본값이 포트 5000인 포트 번호만 주의하면 됩니다. 프로그램을 시작한 후 브라우저에서 127.0.0.1:5000으로 연결하면 됩니다.

AndroPass

AndroPass도 매우 간단합니다. 파일을 입력으로 받아 추가 입력 없이 작업을 수행합니다.

아키텍처:

APK 분석 프레임워크는 Metasploit과 유사한 모듈식 아키텍처를 따릅니다. 다음 모듈로 구성됩니다:

• 핵심 모듈: 핵심 모듈은 명령줄 인터페이스, 입출력 처리, 로깅과 같은 프레임워크의 기본 기능을 제공합니다.
• 정적 분석 모듈: 정적 분석 모듈은 매니페스트 파일, 리소스, 코드와 같은 APK 파일의 구조와 내용을 분석합니다.
• 동적 분석 모듈: 동적 분석 모듈은 네트워크 트래픽, API 호출, 파일 시스템 상호 작용과 같은 APK 파일의 동작을 분석합니다.
• 리버스 엔지니어링 모듈: 리버스 엔지니어링 모듈은 APK 파일의 소스 코드를 디컴파일하고 분석합니다.
• 취약점 테스트 모듈: 취약점 테스트 모듈은 취약점 및 익스플로잇 식별과 같은 APK 파일의 보안을 테스트합니다.

추가 방법

현재는 3개만 있지만, 원하는 경우 더 많은 도구를 추가할 수 있습니다. 고려해야 할 사항은 다음과 같습니다:

• 설치 프로그램 함수
• 별도 도구 함수
• 메인 함수

설치 프로그램 함수

• config/installer.py를 편집해야 합니다.
• 설치 프로그램에서 고려해야 할 사항은 저장소 링크입니다.
• 오류를 방지하기 위해 클로너와 디렉토리를 try-except 조건에 넣습니다.
• 추가 설치에 적절한 명령을 선택합니다.

별도 도구 함수

• config/mobfs.py, config/androp.py, config/apkleaks.py를 편집해야 합니다.
• 특정 도구에 대한 새 함수를 작성합니다.
• 파일 처리는 자유입니다. 파일 이름을 인수로 전달한 다음 subprocess 함수를 사용하여 이름으로 파일을 찾는 것을 권장합니다.
• 원치 않는 오류를 방지하기 위해 도구도 try-except 조건에 넣는 것이 좋습니다.

메인 함수

• 메인 함수 홀더 역할을 하도록 스위치 함수에 새 케이스를 추가해야 합니다.
• 도움말 메뉴 목록과 명령은 요구 사항과 편의에 따릅니다.

원하는 경우 업그레이드를 수행하고 이 저장소에 추가하여 더 많은 사람들이 사용할 수 있도록 이 도구를 성장시킬 수 있습니다.

Docker

아직 개발 중입니다.

기여

누구나 기여할 수 있습니다. 이 도구가 가능한 한 많은 사람들에게 유용하기를 바랍니다. 기여하고 싶다면 자유롭게 해주세요. 기여할 수 있는 한 가지 방법은 자신의 도구나 코드와 전체 프레임워크에 가치를 더할 수 있다고 생각하는 도구를 추가하는 것입니다.