AIで作ったZIP商品、展開前に「../」を止める。2つの危ない名前を検査した見本

../../buyer-note.txtを含むZIPでも、Pythonは問題なく作成しました。配布用のREADMEやテンプレートをAIに増やしてもらうと、ZIPの中身が購入者向けのフォルダだけを指すとは限りません。そこで、展開はせず、ファイル名の一覧だけを読む小さな見本を試しました。
これは実際の販売物ではなく、危ない名前を入れた合成ZIPの確認です。問題のあるアーカイブを解凍して試すと、検査自体が余計なファイルを書き出しかねません。まずは展開前に止めます。
解凍前の一覧には、ファイル名だけがある
ZIPには、アーカイブ内の各ファイル名が記録されています。../../buyer-note.txtは、親ディレクトリへ2回戻る指定です。/tmp/outside.txtは、配布先フォルダと無関係な絶対パスです。
OWASPは、../の並びや絶対パスが想定外の場所を参照する経路になりうると説明しています。ダウンロード商品では、悪意ある入力だけが原因ではありません。AIへの指示が曖昧だったり、素材を別の場所からコピーしたりして、意図しない名前が混ざる場合もあります。
作成元のフォルダが正しくても、アーカイブへ渡すメンバー名は別に指定できます。作成成功と、展開してよい名前だけであることは別の確認でした。
親ディレクトリ参照と絶対パスだけを弾く
Pythonのzipfileでinfolist()を読むと、展開せずに各メンバー名を取得できます。ZIP内部の区切りはPOSIX形式なので、ここではPurePosixPathで文字列として扱います。
PurePosixPathはファイルシステムへアクセスしません。is_absolute()で絶対パスを確かめ、partsに..があれば失敗にします。assets/../manifest.jsonのように一見フォルダ内へ戻る名前も、この見本では同じ理由で失敗にします。検査規則を少なくすると、購入者への説明も短く保てます。
from __future__ import annotations
import sys
import zipfile
from pathlib import PurePosixPath
def problem(name: str) -> str | None:
path = PurePosixPath(name)
if path.is_absolute():
return "absolute path"
if any(part == ".." for part in path.parts):
return "parent-directory segment"
return None
failed = False
for filename in sys.argv[1:]:
errors: list[tuple[str, str]] = []
with zipfile.ZipFile(filename) as archive:
for info in archive.infolist():
if info.is_dir():
continue
reason = problem(info.filename)
if reason:
errors.append((info.filename, reason))
state = "FAIL" if errors else "PASS"
print(f"{PurePosixPath(filename).name}: {state} invalid_paths={len(errors)}")
for name, reason in errors:
print(f" {reason}: {name}")
failed |= bool(errors)
raise SystemExit(1 if failed else 0)
合成ZIPは3ファイルだけの安全なものと、2つの危ない名前を含むものを作りました。実行に使ったPythonは3.13.5です。
cd "$TMPDIR/zip-path-traversal-lab"
python3 --version
python3 make_samples.py
python3 check_zip_paths.py safe-product.zip
printf 'safe_exit=%s\n' "$?"
Python 3.13.5
safe-product.zip: PASS invalid_paths=0
safe_exit=0
safe-product.zipのメンバーはREADME.md、assets/cover.png、templates/plan.txtです。いずれも配布物のルートから始まる相対パスなので、検査は終了コード0で終わりました。
次は、悪い入力を同じ検査器へ渡します。失敗時にも出力を残すため、シェル側で一時的にset -eを外しています。
set +e
python3 check_zip_paths.py unsafe-product.zip
rc=$?
set -e
printf 'unsafe_exit=%s\n' "$rc"
unsafe-product.zip: FAIL invalid_paths=2
parent-directory segment: ../../buyer-note.txt
absolute path: /tmp/outside.txt
unsafe_exit=1
2件を見つけ、終了コードは1になりました。この段階ではZIPを解凍していません。購入者のフォルダや作業用フォルダへ書き出す前に、PRや納品前チェックを止められます。
AIへの指示は「ZIPを作る」の後に置く
AIにファイル作成を頼むときは、ZIP化の指示にもう1行だけ加えます。たとえば「アーカイブ内の名前は相対パスだけにし、..と絶対パスを含めない」と明記します。
ただし、指示だけで終えると、あとで素材を足したときに抜けます。この見本では、作成後のZIPへ検査を通し、失敗なら中身を展開せずに名前の生成元へ戻します。検査器が勝手に名前を書き換えない点も大切です。READMEのリンクや商品説明と、ZIP内の名前を別々に直す事故を避けられます。
前にZIP内の名前の衝突を確かめた回では、異なる2つの名前が同じ場所へ展開される問題を扱いました。今回は、その場所そのものが配布先の外を指さないかを見ます。両方を通しても、圧縮率やファイルサイズ、ライセンスは別に確認が必要です。
この検査で見ないもの
この見本は..とPOSIX形式の絶対パスを対象にしています。Windows形式のドライブ名、シンボリックリンク、暗号化ZIP、展開先ツール固有の挙動は扱いません。
範囲を広げる前に、どのOSで、どの解凍ツールを購入者へ案内するかを決めます。AIがファイルを素早く増やすほど、配布前の確認は「読めるか」だけでは足りません。まず名前を一覧で読み、購入者のフォルダの外へ向かう記号は1つでも止めます。最初の関門は、名前。
出典
- Python公式文書: zipfile(ZIPアーカイブの作成、読取り、メンバー一覧)
- Python公式文書: pathlib(ファイルシステムへアクセスしないPurePathと絶対パスの判定)
- OWASP: Path Traversal(
../と絶対パスを含む経路のリスクと入力検証)


