ZIPを開く前に、シンボリックリンクを止める|デジタル商品の合成見本

ZIPを開く前に、シンボリックリンクを止める|デジタル商品の合成見本

ZIPの一覧にtemplates/currentと出ていれば、当初は普通のファイルかフォルダだと考えられます。けれどZIPのメンバーには、別の場所を指すシンボリックリンクも入れられます。購入者へ渡すテンプレート一式では、リンクを必要としないなら、展開より前に止めるほうが判断しやすいです。

今回は実在の商品や購入者データを使わず、2つの合成ZIPを作りました。安全なZIPは通常ファイル2件で終了コード0、リンクを1件含むZIPは終了コード1です。AIにファイル案を増やしてもらう場面でも、最終的に配るZIPの種類まで確認するための小さな検査として扱えます。

前回は、ZIP内の../や絶対パスを展開前に検査しました。今回は名前の文字列ではなく、メンバーに記録された種類を読みます。../がなくても、リンクなら展開する側の扱いに依存するためです。

「名前がある」と「中身を持つ」は別でした

シンボリックリンクは、別のパスを指す特殊なファイルです。Linux系の形式情報では、通常ファイルとリンクは異なる種類として保存できます。ZIPを作るPythonのzipfileでも、各メンバーのexternal_attrにその情報を持たせられました。

最初は、ZIPは配布するファイルの入れ物なのだから、一覧を読めば十分だと考えられます。しかし、一覧は名前を示すだけです。templates/currentが文字列として見えても、その実体が何かまでは分かりません。購入者の環境でリンクをたどる設計まで持ち込まないため、ここではリンクを見つけた時点で失敗にします。

[素材と説明書をまとめる]
             │
             ▼
      [ZIPのメンバー一覧]
             │
       種類を読む
       ┌─────┴─────┐
       ▼           ▼
通常ファイル      シンボリックリンク
       │           │
       ▼           ▼
   配布候補       展開せずに止める

この検査は、リンク先が安全かを判定するものではありません。リンクを許可しない配布物へ、リンクが1件でも混ざっていないかを確かめる関門です。

今回の言葉をそろえる

用語この見本での意味
ZIPメンバーZIPの中に記録された1つの名前と内容です。
シンボリックリンク自身の内容として、別のパスを指す特殊なファイルです。
属性ファイルの種類や権限のように、名前と内容以外へ付く情報です。
external_attrPythonのZipInfoが持つ、ZIPメンバーの外部属性です。
stat.S_IFLNKPythonでシンボリックリンクの種類を表す定数です。
終了コードコマンドの成否を数字で返す値です。この見本では0が通過、1が検出です。

普通のZIPとリンク入りZIPを作る

次のスクリプトを$TMPDIR/zip-symlink-lab/make_samples.pyとして保存しました。$TMPDIRは一時ディレクトリを表します。safe-product.zipには通常ファイルだけを2件、symlink-product.zipには通常ファイル1件と、../drafts/latestを指すリンク1件を入れます。判断の境目。

make_samples.pyの全文
from __future__ import annotations

import stat
import zipfile
from pathlib import Path

root = Path(__file__).parent


def add_file(archive: zipfile.ZipFile, name: str, body: str) -> None:
    info = zipfile.ZipInfo(name)
    info.external_attr = (stat.S_IFREG | 0o644) << 16
    archive.writestr(info, body)


def add_symlink(archive: zipfile.ZipFile, name: str, target: str) -> None:
    info = zipfile.ZipInfo(name)
    info.create_system = 3
    info.external_attr = (stat.S_IFLNK | 0o777) << 16
    archive.writestr(info, target)


with zipfile.ZipFile(root / "safe-product.zip", "w") as archive:
    add_file(archive, "README.md", "# delivery\n")
    add_file(archive, "templates/plan.txt", "template\n")

with zipfile.ZipFile(root / "symlink-product.zip", "w") as archive:
    add_file(archive, "README.md", "# delivery\n")
    add_symlink(archive, "templates/current", "../drafts/latest")

print("safe-product.zip")
print("symlink-product.zip")

リンクを作る部分では、種類をstat.S_IFLNKにして、create_system = 3でUNIX系の属性として記録しました。リンク先はtemplates/currentという名前ではなく、本文の../drafts/latestです。見た目だけで配布物を確認すると、この違いを取りこぼします。

属性を読み、リンクなら終了コード1にする

検査器を$TMPDIR/zip-symlink-lab/check_zip_symlinks.pyとして保存します。external_attrを16ビット右へずらして種類の部分を取り出し、stat.S_IFLNKと一致するかを確かめます。リンクなら、名前と格納されたリンク先を表示して失敗にします。

check_zip_symlinks.pyの全文
from __future__ import annotations

import stat
import sys
import zipfile
from pathlib import PurePosixPath


def is_symlink(info: zipfile.ZipInfo) -> bool:
    mode = info.external_attr >> 16
    return stat.S_IFMT(mode) == stat.S_IFLNK


failed = False
for filename in sys.argv[1:]:
    links: list[tuple[str, str]] = []
    with zipfile.ZipFile(filename) as archive:
        for info in archive.infolist():
            if is_symlink(info):
                target = archive.read(info).decode("utf-8", "replace")
                links.append((info.filename, target))
    state = "FAIL" if links else "PASS"
    print(f"{PurePosixPath(filename).name}: {state} symlinks={len(links)}")
    for name, target in links:
        print(f"  symlink: {name} -> {target}")
    failed |= bool(links)

raise SystemExit(1 if failed else 0)

まず通常ファイルだけのZIPを通しました。実行時のPythonは3.13.5です。

cd "$TMPDIR/zip-symlink-lab"
python3 --version
python3 make_samples.py
python3 check_zip_symlinks.py safe-product.zip
printf 'safe_exit=%s\n' "$?"
Python 3.13.5
safe-product.zip
symlink-product.zip
safe-product.zip: PASS symlinks=0
safe_exit=0

次に、リンクを含む方を同じ検査器へ渡します。失敗しても終了コードを表示するため、このブロックだけset +eで止まらないようにしました。

set +e
python3 check_zip_symlinks.py symlink-product.zip
rc=$?
set -e
printf 'symlink_exit=%s\n' "$rc"
symlink-product.zip: FAIL symlinks=1
  symlink: templates/current -> ../drafts/latest
symlink_exit=1

リンク1件を検出し、終了コードは1でした。ZIPを展開していないので、リンク先を作業場所でたどる必要はありません。販売候補のZIPを作った直後にこの検査を置けば、通常ファイルだけにするか、リンクを含める理由と対象環境を明示するかを、配布前に決められます。

最後に、検査が読んだ属性をそのまま出しました。120777だけがリンクとして判定されています。

python3 - <<'PY'
import stat, zipfile
for filename in ('safe-product.zip', 'symlink-product.zip'):
    with zipfile.ZipFile(filename) as archive:
        for info in archive.infolist():
            mode = info.external_attr >> 16
            print(f'{filename} {info.filename} mode={mode:o} is_symlink={stat.S_IFMT(mode) == stat.S_IFLNK}')
PY
safe-product.zip README.md mode=100644 is_symlink=False
safe-product.zip templates/plan.txt mode=100644 is_symlink=False
symlink-product.zip README.md mode=100644 is_symlink=False
symlink-product.zip templates/current mode=120777 is_symlink=True

止める場所を、展開より前にする

この見本ではリンクの内容が../drafts/latestでした。ただし、リンク先が商品フォルダ内に見える場合でも、今回は通しません。配布物にリンクを含めるなら、購入者が使うOS、解凍ツール、リンク先を一緒に設計してから個別に許可するべきだからです。

AIでテンプレート、画像、説明書をまとめると、ファイル数はすぐ増えます。だからといって、ファイル名だけを確認して終えると、種類の違いは残ります。この見本では、「ZIPに入っている」ことだけを納品条件にしません。リンクが不要な商品では、「通常ファイルだけ」をもう1つの条件にします。

この検査にも限界があります。ZIP属性を持たない形式や、Windowsのショートカットファイル、リンク先が実在するかは確認しません。今回の目的は、展開時の挙動を再現することではなく、リンクを不要な配布物から確実に除くことです。

出典

この記事をシェア