顧客がアップロードしたファイル名をストレージ パスとして直接使用することはできません。パス トラバーサルと名前の重複を防ぐためです。
アップロードされたファイルは `../../report.pdf` と呼ばれますが、これはサーバーがこの名前でファイルを保存する必要があるという意味ではありません。ファイル名はユーザーから取得され、入力データに属します。ディスク パスはシステム権限の境界に属します。この 2 つを混同すると、パス トラバーサル、名前の重複、Windows と Linux 間の動作の違いなどの問題が発生しやすくなります。
アップロードされたファイルの名前が ../../report.pdf だからといって、サーバーがこの名前でファイルを保存する必要があるというわけではありません。サーバー側のアップロード関数を作成する開発者だけでなく、ユーザー ファイルを処理する必要があり、パス トラバーサルや重複名のカバレッジを心配する必要があるチームも、この問題に遭遇するでしょう。この記事を読むと、表示名とストレージ名を区別し、各層でどのようなチェックを行うべきかを知り、受け入れ項目に従って自分の実装を見直すことができるようになります。
ファイル名はユーザーから取得され、入力データに属します。ディスク パスはシステム権限の境界に属します。この 2 つを混同すると、パス トラバーサル、名前の重複、Windows と Linux 間の動作の違いなどの問題が発生しやすくなります。
この記事では、合成サンプルを使用して処理方法を説明します。コードは隔離された環境でサンプル チェックされており、すべての実際のファイルや製品のパフォーマンスを保証するものではありません。重要な書類を処理する前に、原本を保管し、本文の境界と許容事項に従って確認してください。
アップロードしたファイル名をそのままストレージパスとして使用できますか?一文の結論
直接使用することはできません。表示名はインターフェイスの表示に使用され、ストレージ パスは内部 ID に基づいてサーバーによって生成されます。
| あなたの状況 | 推奨される実践方法 | 理由 |
|---|---|---|
| ユーザーの元のファイル名をインターフェースに表示する必要がある | 表示名は表示専用に予約されています | パスの交差を避けるために、ディスク パスから分離された表示名 |
| アップロードしたファイルを保存する必要がある | サーバーは内部 ID を生成し、ストレージ パスを接続します。 | 重複した名前による上書きを回避し、ユーザー入力の影響を受けないようにする |
| ファイル拡張子はストレージに参加する必要があります | サーバーの許可リストからサフィックスを取得します | ユーザーが指定した拡張子をコピーしないでください |
| ファイルの本当のタイプを判断する必要がある | コンテンツの検出と分析を行う | 拡張機能は偽造できる |
表示名とストレージ名は分離されています
元の名前はインターフェイス表示用に保持されますが、内部識別はサーバーによって生成されます。ストレージ サフィックスも、ユーザーが指定した拡張子をコピーするのではなく、サーバー側の許可リストから取得する必要があります。
次の例ではパスを構築するだけで、ディレクトリやファイルは作成されません。
最小パスコンストラクター
from pathlib import Path
import re
def storage_path(root, internal_id, extension):
if not re.fullmatch(r"[a-f0-9]{32}", internal_id):
raise ValueError("invalid internal id")
if extension not in {".pdf", ".docx", ".udoc"}:
raise ValueError("unsupported extension")
base = Path(root).resolve()
candidate = (base / (internal_id + extension)).resolve()
if candidate.parent != base:
raise ValueError("outside storage root")
return candidate
root = Path.cwd() / "synthetic-uploads"
identifier = "a" * 32
p = storage_path(root, identifier, ".pdf")
assert p.parent == root.resolve()
assert p.name == identifier + ".pdf"
for bad in ["../../report", "A" * 32, "a" * 31, "a" * 32 + "/x"]:
try:
storage_path(root, bad, ".pdf")
except ValueError:
pass
else:
raise AssertionError(bad)
この例では、内部 ID がサーバーによって生成されたことを前提としています。これは、任意のディスク攻撃環境に対する安全な書き込みファイルの実装ではありません。
- 確認してから実際に開くまでの間に競合が発生する可能性があります。
- 親ディレクトリのアクセス許可とシンボリック リンク ポリシーは個別に制御する必要があります。
- 一意の ID は、「上書き禁止」ポリシーを無視できるという意味でもありません。
ファイル名のサニタイズはファイル認証ではありません
ファイル名のクリーニングでは問題の一部しか解決できないため、さまざまな現象をさまざまなレベルで処理する必要があります。
| 入力現象 | どのレベルで処理する必要がありますか? | 欠点 |
|---|---|---|
| パス区切り文字が含まれています | ストレージパスとして使用されない | スラッシュを削除するだけでは十分ではありません |
| 拡張子PDF | コンテンツの検出と分析 | 拡張機能は鍛造可能 |
| 表示名にHTMLが含まれています | インターフェース出力エスケープ | ディスク名を変更しても解決できません。 |
| 同じ表示名 | 内部 ID の分離 | 以前のアップロードは上書きしないでください |
📊 コアの比較
| 練習する | 何が解決できるのか | 欠点 |
|---|---|---|
| ユーザーファイル名を直接使用する | 最も単純な実装 | パスの交差と重複した名前のカバレッジが発生する可能性があります |
| パス区切り文字を削除するだけです | 入力の処理された部分 | スラッシュを削除するだけでは十分ではありません |
| 拡張子に基づいてタイプを決定する | 予備微分ファイル | 拡張子は偽造される可能性があり、コンテンツの検出が必要です。 |
| サーバー側で生成された内部 ID | 同じ名前のファイルを分離します。パスはシステムによって制御されます。 | 「上書き禁止」ポリシーとディレクトリ権限制御に引き続き協力する必要がある |
オブジェクトストレージにも同じ境界があります
R2 またはその他のオブジェクト ストアには、従来のディレクトリ トラバーサルの完全なセマンティクスはありませんが、オブジェクト キーは依然として分離、オーバーライド、および公開された URL に影響を与えます。
- テナントから提供された文字列を共有プレフィックスに直接入力しないでください。
- ダウンローダーは、キー名のみに基づいて認証を推測することはできません。
翻訳を開始する前に、ファイルには ID が必要です
OmniDoc (製品ポータル)ワークフローに接続する場合、ユーザーには使い慣れたファイル名を表示し続け、独立したタスク ID とファイル ID を内部的に使用できます。
明確なドキュメンタリーのアイデンティティは次のような利点をもたらします。
- リトライが失敗した場合、元のタスクに正確に対応できます。
- 翻訳原稿のダウンロードとその後のレビューが正しいファイルに対応できます。
- 他の人のファイルを現在の結果と同じ名前で扱うリスクを軽減します。
🎯 どの方法があなたに適していますか?
ファイル名を表示する必要がある場合
ユーザーの元の表示名は保持されますが、ディスク パスではなくインターフェイスにのみ使用されます。
アップロードしたファイルを保存する必要がある場合
内部 ID はサーバーによって生成され、許可リストからサフィックスを取得し、実際のポリシーに従ってカバレッジとディレクトリのアクセス許可を制御します。
オブジェクトストレージを使用する場合
テナント文字列を共有プレフィックスに直接入力せず、ダウンロード時に個別の認可判断を行ってください。
❓ よくある質問 (FAQ)
1. スラッシュを削除した場合、ファイル名は安全ですか?
足りない。スラッシュを削除するだけでは入力の一部しか処理できず、パスの構築、上書き、ファイル タイプの決定は個別に処理する必要があります。
2. 拡張子が PDF だからといって、それは PDF ということになりますか?
できません。拡張機能は偽造される可能性があり、コンテンツの検出と分析が必要です。
3. 表示名に HTML が含まれている場合はどうすればよいですか?
インターフェイス出力中のエスケープは、ディスク上のファイル名を変更しても解決できません。
4. 一意の ID を使用した後も、上書きを無効にする必要がありますか?
必要。一意の ID は、「上書き禁止」ポリシーを無視できるという意味ではありません。
📝 概要
アップロードされたファイル名は、保存パスとは別に扱う必要があります。表示名は表示に使用され、保存パスは内部 ID に基づいてサーバーによって生成されます。パス、カバレッジ、タイプ、認可はすべて個別に検証されます。


