untar_dir() を介した fastcore におけるパストラバーサル (Tar Slip)深刻度: 重大、CVSS 3.1 9.8
ベクトル (v3.1): CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H
影響を受けるバージョン: fastcore 0 から 2.2.44 まで (執筆時点の最新版、未修正)
修正バージョン: 執筆時点では未修正
CWE: CWE-22 (パス名の制限されたディレクトリへの不適切な制限、'パストラバーサル')
コンポーネント: fastcore.xtras.untar_dir() → fastcore.xtras._unpack() → shutil.unpack_archive()
高リスクなランタイム: Python < 3.14 (Python 3.14 では安全な data tar フィルターがデフォルトになる)
報告者: Rahul Karne
CNA: VulnCheck
fastcore.xtras.untar_dir(fname, dest) は、アーカイブを「dest に」展開する、ドキュメント化されたヘルパーです。
内部的には、アーカイブを標準ライブラリの shutil.unpack_archive() に 展開フィルターなし、アーカイブメンバーのパス検証なし、展開後の包含チェックも一切なし で渡します。
その結果、メンバーに ../ トラバーサルシーケンスや絶対パスを含む TAR アーカイブは、呼び出し元が fastcore に展開を要求したディレクトリの 外側 にファイルを書き込むことができます。
untar_dir(fname, dest) がすべてを dest 内に制限すると合理的に期待する呼び出し元は、代わりにプロセスが書き込み可能な任意の場所への任意のファイル書き込みを許してしまいます。
untar_dir() を呼び出すプロセスの権限下での任意のファイル書き込み。
何が上書きされるかによって、以下の結果につながる可能性があります:
概念実証では、完全に無害なデモディレクトリ内で、書き込み → インポート → コード実行 の連鎖全体をエンドツーエンドで実証しています。
fastcore は fast.ai エコシステム全体にわたる基盤的な依存関係であり、以下を含みます:
fastainbdevghapi毎月数千万回のダウンロードがあります。
untar_dir() は、一般的な「アーカイブをダウンロードしてから展開する」ワークフローの背後にある展開プリミティブであり、fastai の untar_data と同じ一般的なパターンに従っています。
untar_dir() に、内容が完全には信頼されていないアーカイブを渡すコードパスはすべて露出します。
脆弱なコードは fastcore/xtras.py に存在します:
def _unpack(fname, out):
import shutil
shutil.unpack_archive(str(fname), str(out)) # <-- no filter, no validation
ls = out.ls()
return ls[0] if len(ls) == 1 else out
def untar_dir(fname, dest, rename=False, overwrite=False, uid=-1, gid=-1):
"untar `file` into `dest` ..."
import tempfile, shutil
dest = Path(dest)
with tempfile.TemporaryDirectory() as d:
out = Path(d) / remove_suffix(Path(fname).stem, '.tar')
out.mkdir()
...
src = _unpack(fname, out) # extraction escapes `out` here
...
shutil.move(str(src), dest)
...
return dest
untar_dir() は内部の一時展開ディレクトリを作成します:
<tempdir>/<random>/<archive-stem>/
次に _unpack() を呼び出し、アーカイブを直接以下に転送します:
shutil.unpack_archive()
TARアーカイブの場合、これは最終的にtarfile.extractall()を呼び出します。
Python < 3.14では、デフォルトの展開動作はfully_trustedであり、トラバーサルメンバーが尊重される可能性があります。
例えば、次のようなアーカイブメンバーです:
../../../some/other/dir/file
は展開ディレクトリを基準に書き込まれるため、そのディレクトリの外に脱出できる。
fastcore には次のいずれも存在しない:
filter="data" を渡す。.. パスコンポーネントを拒否する。untar_dir() は shutil.unpack_archive() を、安全でサンドボックス化されたアーカイブ展開ツールであるかのように扱っている。
そうではない。
Python 標準ライブラリのドキュメントは、信頼できないアーカイブを展開すると要求された宛先の外にファイルが作成される可能性があると警告しており、TAR アーカイブには安全な展開フィルタリングを推奨している。
fastcore は、サポートする Python バージョンに対して適切な展開フィルタを渡すことも、同等の封じ込めガードを実装することもしていない。
また、untar_dir() の呼び出し元に対して、このセキュリティ上重要な挙動について警告もしていない。
TAR メンバーは任意のパス文字列を含むことができる。
影響を受ける Python バージョンでは、tarfile.extractall() はデフォルトで .. トラバーサルシーケンスを自動的に無効化しない。
したがって、fastcore の一時展開ディレクトリを基準としたトラバーサルメンバーを書き込むだけで、そのディレクトリを脱出し、プロセスが書き込み権限を持つ任意の場所に書き込むのに十分である。
信頼できるプリミティブは、次のような相対トラバーサルである:
../../../target/file
これは概念実証で使用されている手法です。
危険な入力はアーカイブの内容であり、開発者が選択した保存先パスではありません。
アーカイブは外部または半信頼の場所から取得されることが頻繁にあり、以下が含まれます:
したがって、信頼できない、または半信頼のソースからアーカイブをダウンロードし、その後 untar_dir() を使用して処理するあらゆるサービスやツールが到達可能となる可能性があります。
PoC には、この配信経路を実証するために、攻撃者が制御する HTTP エンドポイントから細工されたアーカイブを配信するバリアントも含まれています。
悪用に成功するには、以下が必要です:
アプリケーションが、内容が攻撃者の影響を受けるアーカイブ(アップロード、ダウンロード、その他信頼できないアーカイブなど)に対して fastcore.xtras.untar_dir() を呼び出している。
ランタイムが Python < 3.14 を使用している、または安全な TAR 抽出フィルターが適用されないその他の構成である。
任意のファイル書き込みからコード実行へのエスカレーションには、プロセスが後でトラバーサルによって到達可能な場所からファイルをインポートまたはロードする必要があります。例えば:
任意のファイル書き込みおよび構成/データの変更には、条件 1 と 2 のみが必要です。
poc_fastcore_cna_demo.py は実際の fastcore.xtras.untar_dir() API を呼び出します。
このデモンストレーションは意図的に無害です。
PoC によって作成されるすべてのファイルは、以下を使用して指定された単一のデモディレクトリ内に留まります:
--demo-root
PoC は実際のシステムファイルを変更せず、クラウドサービスや認証情報にもアクセスしません。
_unpack() と untar_dir() の環境詳細および脆弱なソースコードを出力します。
以下を含むデモ用のレイアウトを作成します:
service_app/plugins/
以下を作成します:
attacker_supplied_upload.tar
意図された展開ルートの外側を指すように設計されたアーカイブメンバーを含むアーカイブ、これにはトラバーサルメンバーや以下が含まれます:
service_app/plugins/startup_hook.py
def auto_extract_uploaded_archive(received_archive):
return untar_dir(
received_archive,
intended_root,
overwrite=True
)
ファイルが意図した展開ディレクトリの外側に書き込まれたことを検証します。
アーカイブによって書き込まれた以下をインポートすることで、サービスのリロードをシミュレートします:
startup_hook.py
無害なスタートアップフックは次を作成します:
SERVICE_RELOAD_MARKER
これは完全なチェーンを示しています:
Attacker-controlled archive
↓
Path traversal during extraction
↓
Arbitrary file write
↓
Write into importable / auto-loaded location
↓
Application loads attacker-controlled file
↓
Code execution
影響を受けるパッケージをインストールします:
pip install fastcore
この問題は以下によって確認されています:
fastcore 2.2.30
デモは次のいずれかに対して実行できます:
fastcore のコピー--source を使用して選択した、ローカルに展開されたソースツリーすべての PoC の書き込みは、--demo-root で指定されたディレクトリ内に留まります。
以前の PoC 出力をクリーンアップします:
python poc_fastcore_cna_demo.py --demo-root ./poc_fastcore --clean
デモンストレーションを実行します:
python poc_fastcore_cna_demo.py \
--demo-root ./poc_fastcore \
--source latest \
--no-pause
出力例(抜粋):
fastcore version: 2.2.30
Outside marker exists after extraction? True
Is outside marker inside intended extraction root? False
Relative traversal marker exists after extraction? True
Is relative traversal marker inside intended extraction root? False
Service plugin file exists after extraction? True
Service reload marker exists? True
POC WORKED: fastcore extracted attacker-controlled tar members outside the intended root.
サポートされている Python バージョンでは、次のような安全な展開フィルタを使用してください:
filter="data"
shutil.unpack_archive() または対応する tarfile の展開操作を使用します。
すべてのアーカイブメンバーは展開前にチェックすべきです。
以下を拒否します:
.. を含むパスリンクターゲットも展開前に解決および検証すべきです。
書き込み前にすべての宛先パスを解決し、意図した展開ルートの配下に留まっていることを検証します。
概念的には:
resolved_member_path
↓
must remain inside
↓
resolved_extraction_root
解決された宛先が展開ルートの外に出る場合、展開は失敗するべきです。
リグレッションテストは少なくとも以下をカバーするべきです:
../ traversal
absolute paths
Windows drive-letter paths
UNC paths
symbolic links
hard links
untar_dir() が信頼できないアーカイブを安全に処理することを意図しているかどうかを明確に文書化してください。
安全でない展開が意図的にサポートされている場合でも、安全な動作がデフォルトであるべきです。
安全でない動作は、アーカイブの内容を暗黙的に信頼するのではなく、明示的なオプトインを必要とすべきです。
パッケージレベルの修正がリリースされるまでの間:
untar_dir() に直接渡さないでください。