ファイル名に../が入ると保存先の外に書ける――UUID名と範囲内検査で防ぐ
ファイル名は利用者の入力である。保存先の決定権はサーバー側にある。利用者が送ったファイル名をそのまま保存先に使うと、../ で保存先の外に書ける。防ぎ方は3つある。保存名はサーバーが生成したUUIDにする。解決したパスが保存先の範囲内か比べる。既存ファイルの上書きは CREATE_NEW で失敗させる。この記事は2026年11月22日のOWASP実務セキュリティ学習「File Upload / Path Traversal」のレッスンをもとに、OWASPのチートシート2枚とZip Slipの実例で一段上に上げる。
関連する自記事として、同じOWASPシリーズの SSRFはURL検査だけでは防げない――JavaのリダイレクトとDNSの抜け道 がある。入力の検証をURLでやるか、ファイル名でやるかの違いはあるが、抜け道の構造は同じである。
ファイル名が保存先を決めてしまう書き方
レッスンの問題コードは次のものである。
@PostMapping("/api/profile/import-image")
public ResponseEntity<String> importImage(@RequestParam("file") MultipartFile file) throws IOException {
Path destination = Path.of("/app/uploads", file.getOriginalFilename());
file.transferTo(destination);
return ResponseEntity.ok("uploaded");
}
getOriginalFilename() が返すのは、利用者が送ったファイル名である。report.csv なら /app/uploads/report.csv に保存される。../../config/app.properties なら解決先は /config/app.properties になる。Path.of の第2引数が絶対パス /etc/passwd なら、base は捨てられて /etc/passwd そのものになる。次の表は、保存先 /srv/uploads での検証結果である。
| 送られたファイル名 | 解決先 | 範囲内か |
|---|---|---|
report.csv |
/srv/uploads/report.csv |
範囲内 |
../../config/app.properties |
/config/app.properties |
範囲外 |
../../../etc/cron.d/backdoor |
/etc/cron.d/backdoor |
範囲外 |
/etc/passwd |
/etc/passwd |
範囲外 |
subdir/report.csv |
/srv/uploads/subdir/report.csv |
範囲内 |
上書きも同じ書き方で起きる。Files.newOutputStream の既定は CREATE + TRUNCATE_EXISTING + WRITE で、宛先に既存のファイルがあると中身を置き換える。OWASPのFile Uploadチートシートは脅威として「既存ファイルの上書き」を挙げている。テンプレートや設定ファイルを上書きされると、書き込みがそのまま実行や設定変更につながる。
「../を取り除く」検査では防げない
../ を文字列から取り除く検査は、OWASPのPath Traversal Preventionチートシートが4つの理由で退けている。\ を区切りとして受け付ける環境では ..\ が残る。一度だけ取り除くと ....// から ../ が生まれる。チェックのあとでデコードされると %2e%2e%2f が通る。絶対パスには ../ が含まれない。
検証で確かめたとおり、....//....//config/app.properties は除去前はただの名前で、解決先は /srv/uploads/..../..../config/app.properties と範囲内である。ここから ../ を一度だけ取り除くと ../....//config/app.properties になり、解決先は /srv/..../config/app.properties と範囲外になる。検査そのものが traversal を作っている。文字を削る検査は、削る前と削る後で別々の文字列を見ている点で破綻している。
範囲内検査は解決してから比べる
OWASPのJavaの例は、入力を検証するのではなく、解決した結果を比べる。
Path base = Path.of("/srv/uploads").toRealPath();
Path target = base.resolve(userPath).normalize();
if (!target.startsWith(base)) {
throw new SecurityException("Invalid path");
}
順序が要点である。まず base に結合し、normalize() で . と .. を畳み、絶対パスなら base が捨てられることも含めて解決する。その結果を比べる。比べたパスをそのまま使う。元の入力から組み立て直さない。
startsWith は文字列の前方一致ではなく、名前要素単位の比較である。/srv/uploads-old/evil.csv は文字列では /srv/uploads で始まるが、名前要素では uploads-old と uploads は別の要素なので通らない。検証では、文字列の前方一致が true を返し、要素単位の比較が false を返すことを確かめた。
Windows では同じファイル名の扱いが変わる。\ も区切りになるため、..\..\config\app.properties は Linux ではただの名前で範囲内だが、Windows では範囲外に出る。OS がパスをどう解釈するかで、同じ検査の結果が変わる。
検査と使用のすき間――シンボリックリンクとTOCTOU
範囲内検査は文字列の上での検査である。保存先の中にシンボリックリンクがあると、検査を通ったパスがリンク先の外を指す。検査のあと、開く前にリンクへ置き換えられると、検査したパスと開くパスが別物になる。チェック時と使用時のすき間(TOCTOU)である。
OWASPの対策は3つある。信頼できない利用者に、アプリがパスで読む・書くディレクトリへファイルやリンクを作らせない。開くときに制限をかけるAPIを使う(Goの os.Root、Linux 5.6以降の openat2 と RESOLVE_BENEATH)。アプリに必要最小限のファイルシステム権限だけ与える。
Javaの標準ライブラリには os.Root や openat2 に相当するAPIがない。そのためJavaでは、範囲内検査に加えて、利用者に名前を選ばせないことが実質的な対策になる。保存名をサーバー生成のUUIDにすれば、リンクの差し替えの標的になる名前自体が存在しない。検査は検査として残し、名前の決定権を渡さないことが、すき間を小さくする。
Zip Slip――同じ穴の別入口
ファイル名の穴は、アップロードだけのものではない。ZIPの展開でも同じ穴が開く。Snykが2018年6月5日に公開したZip Slipは、アーカイブ内のファイル名に ../ を入れて展開先の外に書く脆弱性で、数千のプロジェクトに影響した。Javaで特に多かった。Javaにはアーカイブを高水準で処理する中心的なライブラリがなく、展開コードを手書きして共有する文化があったためである。影響を受けたのはApacheやOracleのライブラリを使った製品で、Google Cloud、Amazon CodePipeline、IBM DataPower、Alibaba JStorm、Twitter Heronなどが挙がっている。
脆弱なJavaの書き方は、アップロードの問題コードと同じ構造である。
Enumeration<ZipEntry> entries = zip.getEntries();
while (entries.hasMoreElements()) {
ZipEntry e = entries.nextElement();
File f = new File(dir, e.getName());
InputStream input = zip.getInputStream(e);
IOUtils.copy(input, write(f));
}
e.getName() はアーカイブを作った側が決めた名前である。検証では、エントリ ../../../../../../root/.ssh/authorized_keys が /root/.ssh/authorized_keys に解決され、範囲外になることを確かめた。実例では、この名前で authorized_keys を上書きする概念実証が示されている。OpenRefineでは CVE-2018-19859 として報告され、1.12.0未満が影響を受けた。
展開側の対策は、アップロードと同じ範囲内検査をエントリごとに行うことである。1つでも範囲外ならアーカイブ全体を拒否する。シンボリックリンクとハードリンクのエントリは、必要がなければ拒否するかスキップする。SEI CERTの IDS04-J「Safely extract files from ZipInputStream」も、展開前に名前を検証する書き方を示している。
Path base = Path.of("/srv/extracted").toRealPath();
while (entries.hasMoreElements()) {
ZipEntry entry = entries.nextElement();
Path target = base.resolve(entry.getName()).normalize();
if (!target.startsWith(base)) {
throw new SecurityException("Entry escapes the destination: " + entry.getName());
}
if (entry.isDirectory()) {
Files.createDirectories(target);
continue;
}
Files.createDirectories(target.getParent());
try (InputStream in = zip.getInputStream(entry);
OutputStream out = Files.newOutputStream(target,
StandardOpenOption.CREATE_NEW, StandardOpenOption.WRITE)) {
in.transferTo(out);
}
}
展開先の決定権も、展開する側が持つ。アーカイブの中の名前は、利用者のファイル名と同じく信頼できない入力である。
名前だけでは足りない――拡張子と中身とサイズ
保存名をUUIDにしても、拡張子と中身とサイズの検査は別に要る。レッスンの対象はCSVの取り込みで、許可する拡張子は .csv だけである。検証した判定は次のとおりである。
| 送られたファイル名 | 判定 |
|---|---|
report.csv |
許可 |
report.CSV |
許可(小文字にそろえて比べる) |
shell.jsp |
拒否 |
report.csv.jsp |
拒否(二重拡張子は最後の拡張子で判定する) |
report.csv%00.jsp |
拒否 |
report |
拒否(拡張子なし) |
OWASPが挙げる回避は、二重拡張子、NULバイト、大文字小文字の操作、同じ処理系に結びつく別拡張子(Javaでは .jsp / .jspx)、WindowsのNTFS代替データストリーム(: を含む名前)である。拡張子の検査は、ファイル名をデコードしてから行う。NULバイトについては、現代のJavaでは Path.of が InvalidPathException を投げるため、パスの層で閉じている。検証では、PythonでもNULを含むパスが ValueError になることを確かめた。
Content-Typeヘッダは利用者が送る値で、偽装は容易である。検証では、申告が text/csv でも先頭バイトが <%@ page import="java.io.*" %> のJSPである例を作った。ヘッダと中身は一致しない。CSVには画像のような署名(マジックバイト)がないため、中身の検証はパースで行う。CSVとして読めるか、列名と列数は合うかを見る。JSPの先頭行は期待する列名と一致しないので、パースの層で拒否できる。
サイズ上限も別に要る。検証では10 MiBを上限とし、10 MiBちょうどは許可、10 MiB + 1バイトは拒否になることを確かめた。ZIPを展開する場合は、圧縮後のサイズではなく展開後のサイズとファイル数で上限をかける。OWASPのASVS V5.2.3も、展開前に最大展開サイズと最大ファイル数をチェックすることを求めている。
保存先とダウンロード側の決め方
保存先の優先順位は、OWASPが次の順で示している。別のホストに置く。できなければwebrootの外に置く。webrootの中に置く場合は書き込み専用にする。アップロードした .htaccess や web.config が、ディレクトリごとの設定変更で無害な拡張子を実行対象に変えるおそれがあるため、アップロード用ディレクトリではディレクトリ単位の設定変更を無効化する(Apacheの AllowOverride None など)。
ダウンロード側も同じ穴がある。ダウンロードAPIがファイル名を受け取ってそのまま返すと、読み取りの traversal になる。公開してよいファイルはIDで引く(someid -> file.ext の対応表をサーバー側で持つ)。IDで引く場合も、認可は別に要る。他人のファイルのIDを指定すれば読めてしまうなら、パスの検査ではなく認可の欠落である。認可の考え方は、同じOWASPシリーズの Mass AssignmentはDTOだけでは防げない――roleを足すと管理者になる で扱った、項目単位の認可と同じ方向である。
検証環境
Javaコードはこの環境にJDKがないためJVMで実行していない。同じロジックをPython 3.12.3に写し、ファイル名8件の範囲内検査、文字列の前方一致の罠、除去検査の bypass、UUID保存名と拡張子 allow-list 6件、CREATE_NEW の原子性、Zip Slipのエントリ5件、Content-Typeの偽装、サイズ上限3件、NULバイトの扱いをすべて確認した。Javaコードは目視で構文を確認した。Windowsでの \ の扱いはOSの仕様によるもので、実測ではなくOWASPの記述による。
今後見るべきもの
- OWASP File UploadチートシートとPath Traversal Preventionチートシートの更新。ファイル名の扱い(8.3短縮名や代替データストリームなど)の記述が増えている。
- Springの
MultipartFile.transferToの挙動。バージョンで書き込み方法が変わるため、既定で上書きするかどうかを自分のバージョンで確かめる。 - 使っているZIP展開ライブラリのZip Slip対応。Snykの脆弱性データベースで、依存ライブラリにZip Slipの報告がないか見る。
- ASVS V5.2のファイル取り扱いの要求。展開サイズ、ファイル数、シンボリックリンクの扱いが版で変わる。
- 自分のサービスのアップロード。保存名はサーバー生成か、範囲内検査は解決したパスで比べているか、書き込みは
CREATE_NEWか、ダウンロードに認可があるか。この4つがそろっているかを見る。
参考資料
- OWASP File Upload Cheat Sheet
- OWASP Path Traversal Prevention Cheat Sheet
- SEI CERT IDS04-J. Safely extract files from ZipInputStream
- Snyk - Arbitrary File Write via Archive Extraction (Zip Slip) in OpenRefine (CVE-2018-19859)
- Snyk - Zip Slip Vulnerability Technical Whitepaper
- The Register - Loose .zips sink chips: How poisoned archives can hack your computer