MORF

모바일 정찰 프레임워크

모바일 애플리케이션 분석을 위한 강력한 공격적 보안 도구 키트

비밀을 찾아내고, 앱을 보호하며, 안전을 유지하세요.

📋 목차

• 💡 개요
• 🚀 빠른 시작
• 🔍 주요 기능
• 🏗️ 아키텍처
• 📋 일반적인 사용 사례
• 📦 설치
  • 사전 요구사항
  • 방법 1: Docker (권장)
  • 방법 2: 실행 스크립트
  • 환경 설정
• 🖥️ 사용법
  • 웹 인터페이스
  • 커맨드 라인 인터페이스
• 🏆 컨퍼런스 인정
• 🛣️ 개발 로드맵
• 👨‍💻 저자
• 📄 라이선스
• 🙏 감사의 말

💡 개요

MORF는 Android 및 iOS 애플리케이션 내의 민감한 정보를 자동으로 발견하는 고급 모바일 보안 분석 도구입니다. 보안 전문가, 침투 테스터 및 개발자를 대상으로 설계된 MORF는 모바일 앱 보안 상태에 대한 포괄적인 통찰력을 제공합니다.

🚀 빠른 시작

MORF는 Docker 또는 포함된 실행 스크립트를 사용하여 몇 초 안에 실행할 수 있습니다:

# 저장소를 클론하고 디렉터리로 이동
git clone https://github.com/amrudesh1/morf && cd morf

# 옵션 1: 실행 스크립트 사용 (권장)
chmod +x run.sh && ./run.sh

# 옵션 2: Docker Compose 사용
docker-compose up --build

그런 다음 브라우저에서 http://localhost 를 방문하여 APK 또는 IPA 파일을 업로드하면 분석이 시작됩니다!

🔍 주요 기능

MORF는 모바일 애플리케이션에 대한 포괄적인 보안 분석 기능을 제공합니다:

🏗️ 아키텍처

MORF는 Go 백엔드와 Angular 프론트엔드를 결합하여 강력한 분석과 직관적인 인터페이스를 제공합니다:

📋 일반적인 사용 사례

📦 설치

사전 요구사항

• Docker (가장 간단한 설치를 위해 권장)
• 대안: Go 및 Node.js (개발 환경용)

방법 1: Docker (권장)

macOS 사용자는 상세한 로컬 개발 가이드를 위해 README-LOCAL.md를 참조하세요.

# 저장소를 클론
git clone https://github.com/amrudesh1/morf
cd MORF

# 모든 서비스 시작 (MySQL, Redis, 백엔드, 프론트엔드)
./run-local.sh start

# 또는 docker-compose 직접 사용
docker-compose up -d

서비스에 접근 가능한 위치:

• 프론트엔드: http://localhost
• 백엔드 API: http://localhost:9092/api
• 상태 확인: http://localhost:9092/api/health

일반 명령어:

./run-local.sh start    # 모든 서비스 시작
./run-local.sh stop     # 모든 서비스 중지
./run-local.sh status   # 서비스 상태 확인
./run-local.sh logs     # 로그 보기

방법 2: 실행 스크립트

git clone https://github.com/amrudesh1/morf
cd morf
chmod +x run.sh
./run.sh

환경 설정

MORF는 데이터베이스에 연결하기 위해 DATABASE_URL 환경 변수가 필요합니다:

# macOS/Linux
export DATABASE_URL="root@tcp(localhost:3306)/Secrets?charset=utf8mb4&parseTime=True&loc=Local"

# Windows (CMD)
set DATABASE_URL=root@tcp(localhost:3306)/Secrets?charset=utf8mb4&parseTime=True&loc=Local

# Windows (PowerShell)
$env:DATABASE_URL = "root@tcp(localhost:3306)/Secrets?charset=utf8mb4&parseTime=True&loc=Local"

참고: Docker Compose는 호스트 머신에 설정된 환경 변수를 자동으로 사용합니다.

🖥️ 사용법

웹 인터페이스

MORF를 시작한 후 http://localhost에서 직관적인 웹 인터페이스에 접속하여 다음 단계를 따르세요:

1. 드래그 앤 드롭 인터페이스를 사용하여 APK 또는 IPA 파일 업로드
2. MORF가 애플리케이션을 처리하고 분석할 때까지 대기
3. 세부 결과 탐색 (포함):
   • 발견된 비밀 및 API 키
   • 구성 요소 보안 분석
   • 권한 평가
   • 딥링크 매핑
   • 포괄적인 메타데이터

커맨드 라인 인터페이스

MORF는 자동화 및 통합을 위한 강력한 CLI도 제공합니다:

# 콘솔 출력을 이용한 기본 스캔
./morf cli --apk-path=/path/to/app.apk

🏆 컨퍼런스 인정

컨퍼런스 출연

🛣️ 개발 로드맵

👨‍💻 저자

@amrudesh1

📄 라이선스

MORF는 MIT 라이선스에 따라 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

🙏 감사의 말

• Secrets Patterns Database - MORF가 비밀 탐지에 사용하는 패턴 데이터베이스
• 오픈소스 보안 커뮤니티 - 영감, 피드백 및 지원에 감사드립니다
• 모든 기여자 - MORF 프로젝트에 코드, 피드백 및 아이디어를 기여해 주신 모든 분들께 감사드립니다