中文 | English

ZAFrida UI - PyCharm Frida 플러그인

현재 버전: 0.3.6

프로젝트 소개

PyCharm/IntelliJ를 위한 Frida 그래픽 도구

ZAFrida UI는 PyCharm 및 JetBrains 계열 IDE에 통합된 Frida 그래픽 조작 플러그인입니다. Frida 명령줄 작업의 번거로움과 스크립트 관리의 혼란을 해결하기 위해 설계되었으며, 장치, 프로세스, 스크립트 및 로그를 관리할 수 있는 완벽한 UI 인터페이스를 제공합니다.

핵심 특징은 "체크박스 방식" 템플릿 관리 시스템입니다. 사용자는 체크/해제를 통해 코드 조각을 메인 스크립트에 동적으로 삽입하거나 주석 처리하여 "블록 쌓기" 방식의 Hook 스크립트를 조립할 수 있습니다. 또한 플러그인은 완전한 프로젝트 기반 관리(zafrida-project.xml)를 내장하여 다중 장치 및 다중 환경 구성을 빠르게 전환할 수 있습니다.

ZAFrida는 Frida를 대체하지 않으며, frida-tools를 위한 강력한 UI 셸 역할을 하여 기존 Python 및 Frida 환경과 원활하게 연결됩니다.

간편 Wiki: ZAFrida UI 간편 Wiki (BBS) (더 간단한 Wiki) 상세 사용 가이드: ZAFrida UI 상세 사용 가이드 Wiki

데모

빠른 시작

1. 플러그인 설치: IDE 플러그인 마켓에서 "ZAFrida"를 검색하거나 디스크에서 설치합니다.
2. 환경 구성: Settings -> Tools -> ZAFrida를 열고 frida 실행 파일 경로를 설정합니다(자동으로 인식되지 않는 경우).
3. 프로젝트 생성: 프로젝트 뷰에서 우클릭 -> New Frida Project.
4. 스크립트 작성/선택: Run 패널에서 당신의 agent.js를 선택합니다.
5. Hook 디버깅:

• 장치 연결 (USB 또는 Remote 또는 Gadget).
• 대상 프로세스 또는 패키지 이름 선택.
• Run 클릭.

6. 템플릿 사용: Templates 탭으로 전환하여 필요한 Hook 기능(예: "SSL Pinning Bypass")을 체크하면 코드가 자동으로 스크립트에 주입됩니다.
7. Skills 자동화 (선택 사항): 기본적으로 비활성화되어 있습니다. Settings/Preferences -> ZAFrida -> Skills HTTP API로 이동하여 Enable Skills를 체크하면 로컬 API가 자동으로 시작됩니다(수동 Start/Stop도 가능). CLI 및 템플릿 위치:
   • skills-cli/zafrida_skill_cli.py
   • skills-template/zafrida-http-control/

커뮤니티 그룹 QR 코드

기능 특징

• 장치 및 프로세스 관리
  frida-ls-devices 및 frida-ps를 통합하여 한 번의 클릭으로 장치 목록을 새로 고치고 실행 중인 프로세스, 실행 중인 앱 또는 설치된 애플리케이션을 볼 수 있습니다.

• 다중 모드 연결
  USB / Remote / Gadget 모드를 완벽하게 지원하며, 사용자 정의 원격 Host 및 Port를 지원하여 복잡한 명령줄 인수를 수동으로 조합할 필요가 없습니다.

• 대화형 스크립트 실행 (Run / Attach)

  • 단순한 "모드 전환"이 아닌 Run (기본 Spawn) 및 Attach 두 가지 실행 동작을 지원합니다.
  • Force Stop으로 대상 애플리케이션을 강제 종료할 수 있습니다.
  • 내장 콘솔 로그 출력 및 자동으로 프로젝트 디렉터리 zafrida-logs/에 로그 저장.

• JS 편집기 우클릭 메뉴 (중요)

  • Frida JS 파일 편집 영역에서 우클릭하면 다음을 직접 선택할 수 있습니다:
    • Run Frida JS: 현재 JS 파일을 메인 스크립트로 실행 (기본 Spawn).
    • Attach Frida JS: 현재 JS 파일을 추가 스크립트로 이미 실행 중인 대상 프로세스에 주입.
  • 실행 전에 현재 파일을 자동 저장하고 스크립트가 속한 ZAFrida Project로 자동 전환합니다.
  • 빠른 PoC, 데모 검증, Gadget 모드 또는 이미 실행 중인 프로세스에 즉시 주입하기에 적합합니다.
  • 단축키:
    • Windows / Linux: Ctrl + Alt + S
    • macOS: ⌘ + ⌥ + S

• 편집기 우클릭 Snippets 삽입

  • JS 편집기 우클릭 메뉴에서 ZAFrida Frida Snippets를 제공합니다.
  • 한 번의 클릭으로 자주 사용하는 Frida 코드 조각을 삽입합니다 (예:
    • Java.perform 래핑 구조
    • Java 메서드 Hook 템플릿
    • Interceptor.attach Native Hook

적용 시나리오

ZAFrida UI는 Frida를 사용하는 모든 리버스 엔지니어링 시나리오에 적합하며, 특히:

• Android / iOS App 침투 테스트 및 리버스 분석.
• 다양한 Hook 스크립트를 자주 전환해야 하는 디버깅 프로세스.
• Python과 JS를 혼합하여 개발하는 엔지니어 (PyCharm/IDEA 사용에 익숙한 경우).

기술 문서

• 환경 요구 사항:

  • IntelliJ IDEA 또는 PyCharm (권장 2024.3+)
  • 로컬에 Python3 및 frida-tools 설치 (pip install frida-tools)
  • 시스템 PATH에 frida, frida-ps, frida-ls-devices가 있거나 플러그인 설정에서 경로를 지정했는지 확인하세요.

• 문제 제보: Github Issues

프로젝트 실행

1. 소스 클론: git clone https://github.com/yilongmd/zafrida-ui.git
2. IntelliJ IDEA로 프로젝트를 엽니다.
3. Gradle 작업 runIde를 실행하여 디버그 환경을 시작합니다.

시스템 데모

메인 인터페이스 및 실행 패널 (Run Panel)

장치 선택, 스크립트 선택, 실행 모드 구성 및 콘솔 출력을 제공합니다.

동적 템플릿 관리 (Template Panel)

왼쪽에서 카테고리 선택, 가운데에서 템플릿 체크, 오른쪽에서 실시간 코드 미리보기. 체크박스는 스크립트 내용의 활성/비활성을 직접 제어합니다.

설정 인터페이스 (Settings)

사용자 정의 Frida 도구 경로, 원격 연결 주소 및 로그 구성을 지원합니다.

프로젝트 생성 마법사

표준화된 Frida 프로젝트 구조를 빠르게 생성합니다.

기술 아키텍처

개발 환경

• 언어: Java 21, Java, 빌드 스크립트는 Gradle Kotlin DSL 사용
• 프레임워크: IntelliJ Platform SDK
• 빌드 도구: Gradle
• 의존성: frida frida-tools (Python 환경)

감사의 말

이 프로젝트에 Frida JS 스크립트 템플릿을 제공해 주신 다음 분들께 특별히 감사드립니다:

• 小佳
• Lane
• 迷人

더 많은 기여자 및 감사 정보는 CONTRIBUTORS.md를 참조하세요.