パストラバーサル対策とは、ユーザーが指定したファイル名やパスを検証し、「../」などを使って意図したディレクトリの外にあるファイルへアクセスされることを防ぐことです。入力をそのままファイルパスに連結するのが原因で、Pythonの標準ライブラリpathlibだけで根本対策ができます。まずは最短のコードで全体像を見てから、各ステップを詳しく説明します。
この記事で分かること
- パストラバーサル(ディレクトリトラバーサル)は、ユーザー入力のファイル名を検証せずパスに連結すると、許可した範囲の外のファイルにアクセスされてしまう脆弱性であること
- os.path.joinやPath同士の結合だけでは「../」を取り除いてくれない。結合したあとに正規化(resolve)し、許可ディレクトリの内側かどうかを確認する処理が別に必要なこと
- pathlib.Path.resolve()はシンボリックリンクも解決するため、is_relative_to()と組み合わせれば、シンボリックリンク経由の回避にも対応できること
対象読者:ファイルアップロード・ダウンロード機能や、ユーザー入力をファイルパスに使うコードを書くエンジニアの方
執筆:ゆるふわセキュリティ編集部 最終更新日:2026年11月11日
安全なファイルパス検証の流れ
結合
許可ディレクトリ + 入力
正規化
resolve()で絶対パスに
範囲チェック
is_relative_to()で確認
許可/拒否
範囲外なら例外にする
from pathlib import Path
def read_file_safe(base: Path, filename: str) -> str:
base = base.resolve()
target = (base / filename).resolve()
if not target.is_relative_to(base):
raise ValueError(f"許可された範囲の外のパスです: {filename}")
return target.read_text()base(許可したディレクトリ)と、結合後にresolve()したtargetを比べ、targetがbaseの内側にあるかをis_relative_to()で確認します。範囲外なら例外を出して処理を止めるだけです。以降で、何が危ないのか・何が足りないのかを順番に見ていきます。
なぜ起きるのか:入力がファイルパスの一部になる
原因はSQLインジェクションやXSSと同じ構造で、ユーザー入力を検証せずにそのまま使ってしまうこと。ファイル名のつもりで受け取った入力に../(親ディレクトリへ移動する記号)が混ざっていると、公開用のディレクトリの外にあるファイルまで読めてしまいます。Webの脆弱性の中でも、アクセス制御の不備に分類される代表例です。
① 危ない書き方(検証せずに結合する)
import os
import tempfile
from pathlib import Path
# この記事専用のサンドボックス(公開してよいディレクトリと、見せてはいけないファイル)
root = Path(tempfile.mkdtemp())
public_dir = root / "public"
public_dir.mkdir()
(public_dir / "readme.txt").write_text("これは公開してよいファイルです")
(root / "secret.txt").write_text("社外秘: これは見せてはいけないファイルです")
def read_file_unsafe(base: Path, filename: str) -> str:
# ❌ 入力をそのままパスに連結している
path = base / filename
return path.read_text()
print(read_file_unsafe(public_dir, "readme.txt")) # 想定どおり
print(read_file_unsafe(public_dir, "../secret.txt")) # 範囲外まで読めてしまうこれは公開してよいファイルです
社外秘: これは見せてはいけないファイルですpublic_dir(公開用ディレクトリ)の中だけを読ませたいのに、../secret.txtという入力で一段上のファイルまで読めてしまいました。os.path.joinやPathの/演算子は単にパスをつなぐだけで、「../を無害化する」機能はありません。
joinやPath結合は「対策」ではない
os.path.join(base, filename)やbase / filenameは文字列(パス)を組み立てるだけの処理です。結合したあとに正規化と範囲チェックを別途行わない限り、../を含む入力を防げません。
② 安全な書き方(正規化してから範囲を確認する)
def read_file_safe(base: Path, filename: str) -> str:
base = base.resolve()
target = (base / filename).resolve()
if not target.is_relative_to(base):
raise ValueError(f"許可された範囲の外のパスです: {filename}")
return target.read_text()
print(read_file_safe(public_dir, "readme.txt"))
try:
read_file_safe(public_dir, "../secret.txt")
except ValueError as e:
print("拒否:", e)これは公開してよいファイルです
拒否: 許可された範囲の外のパスです: ../secret.txtresolve()で絶対パスに正規化してから、is_relative_to()で「baseの内側に収まっているか」を確認しています。../が何個連なっていても、正規化すれば最終的な行き先が明らかになるので、この2段階だけで防げます。
文字列の前方一致(startswith)は使わない
str(target).startswith(str(base))のような文字列比較は、/dataと/data2のように似た名前の隣のディレクトリを誤って許可してしまうことがあります。パス同士の比較はis_relative_to()やos.path.commonpathなど、パスとして扱う方法を使います。
まとめ
- パストラバーサルは、ユーザー入力を検証せずファイルパスに使うと起きる
joinやパスの結合だけでは../を防げない。結合後にresolve()で正規化する- 正規化したパスが許可ディレクトリの内側か
is_relative_to()で確認し、外なら拒否する - 文字列の前方一致ではなく、パスとしての比較を使う
よくある質問
Q. パストラバーサルとディレクトリトラバーサルは違う攻撃?
A. 同じ脆弱性を指す別名です。「../」を使って意図したディレクトリの外に出ようとする点は共通で、OWASPの解説でも両方の呼び方が使われています。本記事でもどちらも同じ意味で使っています。
Q. os.path.joinだけ使っていれば安全?
A. いいえ、安全ではありません。joinはパスをつなぐだけの処理で、入力に含まれる「../」を取り除く機能はありません。つないだあとにresolve()で正規化し、許可ディレクトリの内側かを確認する処理を別に実装する必要があります。
Q. FlaskやDjangoを使っていればこの対策は不要?
A. フレームワークが用意している静的ファイル配信やsend_fileのような標準機能は、内部でこれに近い検証を行っています。ただし、自分でファイル名を受け取って独自にファイルを開く処理を書く場合は、フレームワークの保護の外になるため、本記事と同じ検証を自分で実装する必要があります。
📚 もう少し詳しく(背景と理論)気になる人向け・タップで開く
パストラバーサルはCWE-22「Improper Limitation of a Pathname to a Restricted Directory」に分類される脆弱性です1。攻撃者は../(親ディレクトリへの移動)を連ねたり、絶対パスを直接渡したりして、アプリケーションが想定していないディレクトリのファイルにアクセスしようとします2。
対策の核は、CWEが推奨する**パスの正規化(canonicalization)**です。正規化関数で../やシンボリックリンクを解決した絶対パスを求め、その結果が許可ディレクトリの内側にあるかを確認します1。Pythonではpathlib.Path.resolve()が正規化を、is_relative_to()が範囲チェックを担います。ファイル名に使える文字を制限する(ディレクトリ区切り文字/を許可しないなど)allowlist方式を組み合わせると、さらに安全性が高まります1。
次の一歩 🌸
ファイルパスと並んで入力検証が重要な脆弱性はSQLインジェクション防御とXSS防御、アップロードしたファイルの改ざん確認はファイルの改ざん検知、Web脆弱性の全体像はWebの脆弱性へどうぞ。
参考資料・出典
- CWE-22: Improper Limitation of a Pathname to a Restricted Directory ('Path Traversal')パストラバーサルの定義と、パス正規化による対策を示すMITREの脆弱性分類(本記事執筆時のネットワーク制限で公式ページ本文は未確認。複数の独立した解説記事で一致する内容のみ記載)
- Path Traversal | OWASP FoundationOWASPによる攻撃手法の解説ページ。「../」を使う手法や別名(directory traversalなど)を紹介(公式ページ本文は未確認。検索結果の要約で確認)
- pathlib — オブジェクト指向のファイルシステムパス | Python公式ドキュメントPath.resolve()(パスの正規化)とPurePath.is_relative_to()(範囲の判定)の仕様(公式ページ本文は未確認。検索結果の要約で確認。コード自体は本記事執筆時にPython 3.11.18で実際に実行して動作を確認済み)
ゆるふわポータルでは、一次情報・公的資料にもとづき、専門用語をできるだけやさしく翻訳することを心がけています。内容に誤りや古い情報がある場合は、お問い合わせからご連絡ください。
執筆:ゆるふわセキュリティ編集部 最終更新日:2026年11月11日
Footnotes
-
CWE-22: Improper Limitation of a Pathname to a Restricted Directory ('Path Traversal')。正規化関数で
../やシンボリックリンクを解決したうえで、許可ディレクトリの内側かを確認する対策が推奨されている(本記事執筆時のネットワーク制限で公式ページ本文は未確認。検索結果の要約と複数の独立した解説記事で一致する内容のみ記載)。 ↩ ↩2 ↩3 -
OWASPはこの攻撃を「path traversal」「directory traversal」などと呼び、
../を連ねる手法や絶対パスの直接指定を典型例として挙げている(公式ページ本文は未確認。検索結果の要約で確認)。 ↩
