frida-codeshare-search について
frida-codeshare-searchは、Frida CodeShareスクリプトの検索、確認、抽出、実行を支援するスキルです。セキュリティ担当者向けに、実行前のソース確認、対象との互換性確認、許可範囲の確認を案内します。
主な機能
- 01CodeShareスクリプトの検索
- 02プロジェクトソースのローカル抽出
- 03実行前のスクリプト確認
- 04プラットフォームとバージョンの適合確認
- 05Fridaフックの調整と実行
活用シーン
- 01対象アプリ向けスクリプトの検索
- 02実行前のスクリプト監査
- 03CodeShareプロジェクトの抽出と調整
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ rudra-ravi/ frida-skills --skill frida-codeshare-searchインストール後、Claude Code で/frida-codeshare-searchを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yamlscripts/codeshare_extract.py
詳細
Frida CodeShare の検索
ユーザーが Frida CodeShare スクリプトの検索、確認、ダウンロード、適用、実行を希望する場合に、このスキルを使用します。
ルール
- サードパーティ製の計測を実行する前に、許可と対象範囲を確認します。
- CodeShare スクリプトは、まず偵察目的のものとして扱います。実行する前にソースを読みます。
- 抽出後に
-l script.jsを使ってローカルで確認することを優先します。ユーザーが公開コードを直接取得して実行することを了承した場合に限り、frida --codeshareを使用します。 - 動作を変更する前に、スクリプトが対象プラットフォーム、アプリのバージョン、ライブラリ名、シンボル、Frida のバージョンに適合していることを確認します。
Curl で検索する
URL エンコードしたクエリパラメーターを使って検索ページを取得します。
curl -fsSL --get --data-urlencode "query=instagram" "https://codeshare.frida.re/search/" -o codeshare-search.html
結果カードを解析します。
python3 /path/to/frida-codeshare-search/scripts/codeshare_extract.py search codeshare-search.html
パーサーはタイトル、作成者、URL、いいね数、閲覧数、説明を報告します。プラットフォームとの適合性、タイトルに記載された新しさやバージョン、特定のフレームワークへの対応、監査に十分なソースの明確さを基準に候補を選びます。
プロジェクトのスクリプトを抽出する
プロジェクトページを取得します。
curl -fsSL "https://codeshare.frida.re/@Eltion/instagram-ssl-pinning-bypass/" -o codeshare-project.html
埋め込まれた projectSource をローカルスクリプトに抽出します。
python3 /path/to/frida-codeshare-search/scripts/codeshare_extract.py project codeshare-project.html -o agent.js
その後、実行前に確認します。
sed -n '1,220p' agent.js
実行方法
確認済みのローカルスクリプトを実行します。
frida -U -f com.instagram.android -l agent.js --no-pause
直接実行が許容される場合は、CodeShare 経由で直接実行します。
frida -U --codeshare Eltion/instagram-ssl-pinning-bypass -f com.instagram.android --no-pause
CodeShare ページに ${projectSlug} のようなプレースホルダーが表示されている場合は、プロジェクト URL のスラッグを使用します。
適用時のチェックリスト
- Android の Java フックは
Java.perform()内にあり、オーバーロードが明示されています。 - ネイティブフックは、エクスポートやシンボルを解決する前にモジュールを待ちます。
- iOS のフックは
ObjC.availableを確認し、クラス/セレクターまたはシンボルの存在を確認します。 - 広範な SSL/root/整合性バイパスの一式は、実際に動作するフックだけに絞り込みます。
- ログでどのフックが動作を変更したかを確認でき、失敗時には正確なコマンド、アプリのバージョン、Frida のバージョン、対象アーキテクチャが記録されます。
参考資料
- Frida 公式 CLI ドキュメント:https://frida.re/docs/frida-cli/
- Frida 公式 JavaScript API ドキュメント:https://frida.re/docs/javascript-api/
- Frida CodeShare:https://codeshare.frida.re/
- OWASP MASTG の Frida CodeShare ツールに関する注記:https://mas.owasp.org/MASTG/tools/generic/MASTG-TOOL-0032/
コメント
Markdown 対応