🤖 Obfu[DE]scate: 안드로이드 APK 디-난독화 및 비교 도구 📱

Obfu[DE]scate는 두 버전의 안드로이드 APK를 비교하고 디-난독화하는 과정을 단순화하도록 설계된 Python 도구입니다. 난독화의 일부로 함수 이름이 변경된 경우에도 마찬가지입니다. 퍼지 비교 로직을 통해 Obfu[DE]scate는 함수 간의 유사성을 식별하고 APK 버전 간의 변경 사항을 발견하는 데 도움을 줍니다.

➡️ 시작하기

설치

Obfu[DE]scate를 시작하는 것은 쉽습니다! 다음 단계를 따르세요:

1. 저장소를 로컬 머신에 클론합니다.
2. 의존성을 수동으로 설치하거나 포함된 requirements 파일을 사용하여 다음 명령어로 설치합니다:

pip install -r REQUIREMENTS.txt

3. 귀하의 시스템에 맞는 APKTool을 해당 웹사이트에서 다운로드하고, 설치된 후 PATH에 있는지 확인하세요.

Obfu[DE]scate는 Windows 11에서 테스트되었지만, 다른 시스템에서도 작동할 것입니다.

실행

Obfu[DE]scate는 동작을 사용자 정의할 수 있는 여러 명령줄 옵션을 제공합니다:

두 APK 파일을 비교하려면 다음 명령어로 Obfu[DE]scate를 실행하세요:

python ObfuDeScate.py -a1 "old_example.apk" -a2 "new_example.apk" -cp "com.example.path"

위 예제에서 Obfu[DE]scate는 old_example.apk APK 내 클래스 경로 com.example.path의 모든 함수를 검토하고, 이를 new_example.apk의 동일한 클래스 경로에서 발견된 모든 함수와 비교합니다.

🔎 출력

Obfu[DE]scate는 두 개의 출력 파일을 생성합니다: 새 줄로 구분된 목록 형식의 매핑 파일과 대화형 HTML 파일입니다. 이 출력 파일에는 다음이 포함됩니다:

• mapping.txt - 각 줄이 APK1과 APK2의 메서드 간 식별된 일치와 관련된 새 줄로 구분된 텍스트 파일입니다. 이러한 줄의 형식은 다음과 같습니다: com.chess.play.ObserveGameHelperImpl.d -> com.chess.play.ObserveGameHelperImpl.a .
• output.html - 웹 브라우저에서 열면 APK1의 모든 함수를 나열하는 HTML 파일입니다. 클릭하면 APK2의 일치하는 메서드(있는 경우), 일치 신뢰도, APK1 및 APK2의 해당 메서드에 대한 SMALI 코드 블록을 보여주는 드롭다운입니다.

🙏 기여

Obfu[DE]scate는 오픈소스 프로젝트이며 커뮤니티의 기여를 환영합니다. Obfu[DE]scate에 기여하고 싶으시면 다음 지침을 따라주세요:

• 저장소를 자신의 GitHub 계정으로 포크하세요.
• 기여 내용을 설명하는 이름으로 새 브랜치를 만드세요.
• 변경 사항을 적용하고 철저히 테스트하세요.
• 주 저장소에 풀 리퀘스트를 제출하고, 변경 사항에 대한 자세한 설명과 관련 문서를 포함하세요.
• 관리자의 피드백을 기다리고 의견이나 제안 사항이 있으면 처리하세요 (있는 경우).
• 변경 사항이 검토되고 승인되면 주 저장소에 병합됩니다.

⚖️ 행동 강령

Obfu[DE]scate는 Contributor Covenant 행동 강령을 따릅니다. Obfu[DE]scate에 기여할 때 이 행동 강령을 검토하고 준수해 주시기 바랍니다.

🐛 버그 리포트 및 기능 요청

버그를 발견하거나 새로운 기능에 대한 제안이 있으시면 GitHub 저장소에 이슈를 열어 주세요. 문제 재현 단계나 제안된 기능에 대한 명확한 설명 등 가능한 한 자세한 정보를 제공해 주세요. 여러분의 피드백은 가치 있으며 Obfu[DE]scate를 모든 사람에게 더 좋게 만드는 데 도움이 됩니다.

💛 감사

이 도구는 APKTool 없이는 작동하지 않을 것입니다! 또한, 이 README의 많은 예제는 Chess.com 앱을 기반으로 사용합니다. 여기에서 확인해 보세요.

📜 라이선스

GNU General Public License v3.0