MORF

モバイル偵察フレームワーク

モバイルアプリケーション分析のための強力な攻撃的セキュリティツールキット

シークレットを見つけ、アプリを守り、安全を維持する。

📋 目次

• 💡 概要
• 🚀 クイックスタート
• 🔍 主な機能
• 🏗️ アーキテクチャ
• 📋 一般的なユースケース
• 📦 インストール
  • 前提条件
  • 方法1: Docker（推奨）
  • 方法2: 実行スクリプト
  • 環境設定
• 🖥️ 使用方法
  • Webインターフェース
  • コマンドラインインターフェース
• 🏆 カンファレンスでの評価
• 🛣️ 開発ロードマップ
• 👨‍💻 著者
• 📄 ライセンス
• 🙏 謝辞

💡 概要

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 はホストマシンに設定された環境変数を自動的に使用します。

🖥️ 使用方法

Webインターフェース

MORF を起動したら、http://localhost で直感的な Web インターフェースにアクセスし、以下の手順に従ってください。

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 プロジェクトにコード、フィードバック、アイデアを提供してくださった皆様