セッションと CSRF 検証による安全な AJAX ファイルアップロード
AJAX アップロードは、サーバーがセッション、権限、リクエスト、ファイル内容を検証した場合にのみ受理されます。このチュートリアルでは、これらの検証を実施し、アップロードの進捗を表示する、実行可能なブラウザーフォームと Node.js サーバーを紹介します。各ユーザーは、受理された自分のファイルだけをダウンロードできます。
サーバーが受理する内容の定義
この例でアップロードするのは添付用の JSON メモファイルであり、任意の画像や文書ではありません。各ファイルには、プロパティが message だけの UTF-8 JSON オブジェクトを格納し、その値を空白だけではない文字列にする必要があります。フォームを試す際は、次の内容を note.json として保存してください。
{"message":"Hello from an AJAX upload."}
サーバーは、file という名前の multipart フィールドをちょうど一つ、ファイルサイズを最大 64 KiB として受け付けます。追加のフィールドは認めません。また、境界やヘッダーを含む multipart 本文全体を 80 KiB 以下に制限します。どちらの制限も受信バイト数に対して適用します。PNG の名前を note.json に変えても、有効な JSON にはなりません。一方、有効なメモの内容であれば、名前が note.png でも、誤った MIME タイプで送信されても受理されます。この例では、これら二つのクライアントメタデータを意図的に無視し、受理したすべてのファイルを note.json という名前で、application/json を指定してダウンロードさせます。
これは、特定のアプリケーション向けのコンテンツポリシーです。JSON を解析しても、ファイルにマルウェアがないとは証明できません。HTML を含む文字列も、信頼できないデータのままです。この例では、その文字列を描画しません。より幅広いファイルタイプを扱う場合は、それぞれに検証と処理のルールを定めてください。MIME 許可リストやファイルシグネチャだけでは不十分です。OWASP のアップロードガイダンスを参照してください。
ローカルデモのセットアップ
Node.js 26 と最新のブラウザーを使用してください。以下の例は、Linux 上の Node.js 26.8.1 と Chromium 152 でテスト済みです。依存パッケージはありません。POSIX シェルで新しいディレクトリを作成します。
mkdir ajax-upload-demo && cd ajax-upload-demo
このコマンドが失敗した場合は作業を中断し、別の新しいディレクトリを選んでください。既存のプロジェクトを上書きしないでください。その中に、次の三つのファイルを保存します。server.ts、index.html、client.js。
サーバーは、空いているポートの 127.0.0.1 にのみバインドし、その URL と、alice および bob 用に新しく生成したパスワードを出力します。これらは使い捨てのローカルユーザーです。出力されたパスワードを知っていれば、誰でもそのユーザーとして操作できます。ログインするたびに、そのユーザーの以前のセッションは置き換わり、セッションは 15 分後に失効します。アップロードしたファイルは、プロセスが終了するまでメモリ内に保持され、ユーザーごとに最大十個まで保存できます。繰り返しアップロードすると別々のエントリが作成され、以前の添付ファイルが置き換わることはありません。
サーバー側でのルールの適用
次の内容を server.ts として保存してください。公開されるファイルは、明示的に配信する二つのクライアントアセットだけです。アップロード本文を読み取る前に、認証とセッションの CSRF トークンを検証します。ダウンロード時には、認証済みユーザー自身のマップで ID を検索するため、別のユーザーには、不明な ID の場合と同じ 404 が返されます。
import { randomBytes, randomUUID } from 'node:crypto'
import { readFile } from 'node:fs/promises'
import { createServer, type IncomingMessage, type ServerResponse } from 'node:http'
interface DemoUser {
name: string
password: string
session: string
csrf: string
expires: number
files: Map<string, Buffer>
}
const token = (): string => randomBytes(32).toString('hex')
const users: DemoUser[] = ['alice', 'bob'].map((name) => ({
name, password: token(), session: '', csrf: '', expires: 0, files: new Map(),
}))
const html = await readFile(new URL('./index.html', import.meta.url))
const script = await readFile(new URL('./client.js', import.meta.url))
let origin = ''
let cookieName = ''
class Rejection extends Error {
status: number
constructor(status: number, message: string) {
super(message)
this.status = status
}
}
function json(res: ServerResponse, status: number, body: unknown): void {
res.writeHead(status, { 'Content-Type': 'application/json' })
res.end(JSON.stringify(body))
}
async function readBody(req: IncomingMessage): Promise<Buffer> {
const chunks: Buffer[] = []
let size = 0
// Keep the socket writable so an oversized request can receive a 413 response.
for await (const chunk of req.iterator({ destroyOnReturn: false })) {
if (!Buffer.isBuffer(chunk)) throw new Error('Expected request bytes')
size += chunk.length
if (size > 80 * 1024) throw new Rejection(413, 'Request exceeds 80 KiB.')
chunks.push(chunk)
}
return Buffer.concat(chunks)
}
async function noteBytes(req: IncomingMessage): Promise<Buffer> {
const body = await readBody(req)
const contentType = req.headers['content-type'] ?? ''
if (!/^multipart\/form-data\s*;/i.test(contentType)) {
throw new Rejection(415, 'Use multipart/form-data.')
}
let form: FormData
try {
form = await new Response(new Uint8Array(body), {
headers: { 'Content-Type': contentType },
}).formData()
} catch {
throw new Rejection(400, 'Malformed multipart body.')
}
const entries = [...form.entries()]
const file = form.get('file')
if (entries.length !== 1 || !(file instanceof File)) {
throw new Rejection(400, 'Send exactly one file field and no other fields.')
}
if (file.size > 64 * 1024) throw new Rejection(413, 'File exceeds 64 KiB.')
const bytes = Buffer.from(await file.arrayBuffer())
let value: unknown
try {
value = JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(bytes))
} catch {
throw new Rejection(422, 'File must contain a UTF-8 JSON note.')
}
if (
typeof value !== 'object' || value === null || Array.isArray(value) ||
Object.keys(value).length !== 1 || !('message' in value) ||
typeof value.message !== 'string' || value.message.trim().length === 0
) {
throw new Rejection(422, 'Use an object with one nonblank message string.')
}
return bytes
}
function sessionData(user: DemoUser): unknown {
return {
user: user.name,
csrf: user.csrf,
files: [...user.files].map(([id, bytes]) => ({ id, bytes: bytes.length })),
}
}
async function handle(req: IncomingMessage, res: ServerResponse): Promise<void> {
if (req.headers.host !== new URL(origin).host) {
throw new Rejection(403, 'Origin not allowed.')
}
if (req.method === 'GET' && (req.url === '/' || req.url === '/client.js')) {
res.setHeader('Content-Type', req.url === '/' ? 'text/html; charset=utf-8' : 'text/javascript')
res.end(req.url === '/' ? html : script)
return
}
if (req.method === 'POST' && req.headers.origin !== origin) {
throw new Rejection(403, 'Origin not allowed.')
}
if (req.method === 'POST' && req.url?.startsWith('/login/')) {
const user = users.find((entry) => `/login/${entry.name}` === req.url)
if (!user || req.headers['x-demo-password'] !== user.password) {
throw new Rejection(401, 'Invalid demo credentials.')
}
user.session = token()
user.csrf = token()
user.expires = Date.now() + 15 * 60 * 1000
res.setHeader('Set-Cookie',
`${cookieName}=${user.session}; HttpOnly; SameSite=Strict; Path=/; Max-Age=900`)
json(res, 200, sessionData(user))
return
}
const session = req.headers.cookie?.split(';').map((part) => part.trim())
.find((part) => part.startsWith(`${cookieName}=`))?.slice(cookieName.length + 1)
const user = users.find((entry) => entry.session === session && entry.expires > Date.now())
if (!user) throw new Rejection(401, 'Log in again.')
if (req.method === 'GET' && req.url === '/session') {
json(res, 200, sessionData(user))
return
}
if (req.method === 'GET' && req.url?.startsWith('/files/')) {
const bytes = user.files.get(req.url.slice('/files/'.length))
if (!bytes) throw new Rejection(404, 'File not found.')
res.writeHead(200, {
'Content-Type': 'application/json',
'Content-Disposition': 'attachment; filename="note.json"',
})
res.end(bytes)
return
}
if (req.method !== 'POST' || req.url !== '/upload') {
throw new Rejection(404, 'Route not found.')
}
if (req.headers['x-csrf-token'] !== user.csrf) {
throw new Rejection(403, 'Refresh your session before uploading.')
}
const bytes = await noteBytes(req)
// A second login or session expiry during transfer must invalidate this request too.
if (user.session !== session || user.expires <= Date.now()) {
throw new Rejection(401, 'Log in again.')
}
if (user.files.size >= 10) throw new Rejection(409, 'Demo storage is full. Restart to clear it.')
const id = randomUUID()
user.files.set(id, bytes)
json(res, 201, { id, bytes: bytes.length })
}
const server = createServer({ requestTimeout: 30_000, headersTimeout: 10_000 }, (req, res) => {
res.setHeader('Cache-Control', 'no-store')
res.setHeader('X-Content-Type-Options', 'nosniff')
res.setHeader('Content-Security-Policy',
"default-src 'none'; script-src 'self'; connect-src 'self'; form-action 'self'; base-uri 'none'; frame-ancestors 'none'")
void handle(req, res).catch((error: unknown) => {
const status = error instanceof Rejection ? error.status : 500
const message = error instanceof Rejection ? error.message : 'Unable to handle the request.'
if (status === 500) console.error('Request failed unexpectedly.')
res.setHeader('Connection', 'close')
json(res, status, { error: message })
req.resume()
})
})
server.maxConnections = 16
server.listen(0, '127.0.0.1', () => {
const address = server.address()
if (!address || typeof address === 'string') throw new Error('Missing TCP address')
origin = `http://127.0.0.1:${address.port}`
cookieName = `ajax_demo_${address.port}`
console.log(`Open ${origin}`)
for (const user of users) console.log(`${user.name} password: ${user.password}`)
})
本文サイズの制限は、Node の multipart パーサーが個々のフィールドをバッファリングする前に適用されます。destroyOnReturn: false オプションを使うと、サイズ超過で早期に拒否する場合も、接続を閉じる前に HTTP レスポンスを送信できます。すべての検証が成功するまで、ストレージには何も追加されません。拒否された本文のエントリやディスク上のファイルは残りません。
/session が返すトークンは、HttpOnly セッション Cookie とは別のものです。ブラウザーはこれを X-CSRF-Token で送信し、サーバーはそのセッションに属するトークンと比較します。Origin の完全一致検証でも、ログインを含む POST リクエストを保護します。CORS アクセスは許可しません。これらの設計は同期トークンパターンに従っています。SameSite は保護をさらに強化しますが、トークン検証の代わりにはなりません。
ブラウザーフォームの追加
次の内容を index.html として保存してください。キーボードでフォームを操作できるように、ネイティブのファイル選択と送信ボタンを使用します。この例では、意図的に一度に一つのファイルを選択します。ドラッグ&ドロップやバッチキューを追加する場合も、同じサーバーの契約を維持してください。
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>AJAX note upload</title>
<script type="module" src="/client.js"></script>
</head>
<body>
<h1>Upload a private JSON note</h1>
<p>Files live in server memory until restart. Select one JSON note, up to 64 KiB.</p>
<fieldset id="controls">
<legend>Demo session and upload</legend>
<form id="login">
<label for="user">Demo user</label>
<select id="user"><option>alice</option><option>bob</option></select>
<label for="password">Password from the server terminal</label>
<input id="password" type="password" autocomplete="current-password" required />
<button>Log in</button>
</form>
<form id="upload">
<label for="file">JSON note</label>
<input id="file" type="file" accept=".json,application/json" required />
<button>Upload</button>
</form>
<button id="refresh" type="button">Refresh accepted files</button>
</fieldset>
<p id="identity">Not logged in.</p>
<label id="progress-label" for="progress">Request bytes transferred</label>
<progress id="progress" aria-labelledby="progress-label" max="100" value="0"></progress>
<p id="status" role="status" aria-live="polite"></p>
<h2>Your accepted files</h2>
<ul id="files"></ul>
</body>
</html>
ファイルの送信と受理の待機
次の内容を client.js として保存してください。セッション関連のリクエストには Fetch を使い、アップロードには XMLHttpRequest を使います。後者ではリクエストのアップロード進捗を取得できるためです。進捗バーが満杯になっても、リクエスト本文の送信が完了しただけで、サーバーがファイルを受理したとは限りません。/upload から HTTP 201 が返された場合にのみ、ダウンロードリンクを作成します。
const controls = document.getElementById('controls')
const login = document.getElementById('login')
const upload = document.getElementById('upload')
const user = document.getElementById('user')
const password = document.getElementById('password')
const fileInput = document.getElementById('file')
const progress = document.getElementById('progress')
const status = document.getElementById('status')
const identity = document.getElementById('identity')
const files = document.getElementById('files')
let csrf = ''
let busy = false
function failure(code) {
const messages = {
400: 'Send exactly one file and no extra fields.',
401: 'Log in with the password from the server terminal.',
403: 'Session check failed. Refresh accepted files or log in again.',
409: 'Demo storage is full. Restart the server to clear it.',
413: 'Upload exceeds a size limit. Choose a smaller file.',
415: 'The server requires multipart form data.',
422: 'Choose a UTF-8 JSON object with one nonblank message string.',
}
return new Error(messages[code] ?? 'Acceptance is unconfirmed. Refresh accepted files before retrying.')
}
async function run(action) {
if (busy) return
busy = true
controls.disabled = true
try {
await action()
} catch (error) {
status.textContent = error instanceof Error ? error.message : 'Request failed.'
} finally {
busy = false
controls.disabled = false
}
}
function addFile(file) {
const item = document.createElement('li')
const link = document.createElement('a')
link.href = `/files/${encodeURIComponent(file.id)}`
link.textContent = `Download ${file.id} (${file.bytes.toLocaleString()} bytes)`
item.append(link)
files.append(item)
}
async function loadSession(response) {
if (!response.ok) {
if (response.status === 401) {
csrf = ''
identity.textContent = 'Not logged in.'
files.replaceChildren()
}
throw failure(response.status)
}
const data = await response.json()
csrf = data.csrf
identity.textContent = `Logged in as ${data.user}.`
files.replaceChildren()
for (const file of data.files) addFile(file)
}
login.addEventListener('submit', (event) => {
event.preventDefault()
void run(async () => {
const response = await fetch(`/login/${encodeURIComponent(user.value)}`, {
method: 'POST',
headers: { 'X-Demo-Password': password.value },
credentials: 'same-origin',
})
password.value = ''
await loadSession(response)
status.textContent = 'Logged in. Choose a note to upload.'
})
})
function sendFile(file) {
return new Promise((resolve, reject) => {
const body = new FormData()
body.append('file', file)
const xhr = new XMLHttpRequest()
xhr.upload.onprogress = (event) => {
if (event.lengthComputable) progress.value = event.loaded / event.total * 100
}
xhr.upload.onload = () => { status.textContent = 'Transferred. Waiting for server acceptance…' }
xhr.open('POST', '/upload')
xhr.setRequestHeader('X-CSRF-Token', csrf)
xhr.responseType = 'json'
xhr.timeout = 45_000
xhr.onload = () => {
if (xhr.status === 201 && typeof xhr.response?.id === 'string') resolve(xhr.response)
else reject(failure(xhr.status))
}
xhr.onerror = xhr.ontimeout = xhr.onabort = () => reject(failure(0))
xhr.send(body)
})
}
upload.addEventListener('submit', (event) => {
event.preventDefault()
void run(async () => {
const file = fileInput.files[0]
if (!csrf) throw failure(401)
if (!file) throw new Error('Choose a file first.')
if (file.size > 64 * 1024) throw failure(413)
progress.value = 0
status.textContent = 'Uploading…'
const accepted = await sendFile(file)
addFile(accepted)
status.textContent = 'Accepted into private memory. Use the download link to check the bytes.'
})
})
async function refresh() {
await loadSession(await fetch('/session', { credentials: 'same-origin' }))
status.textContent = 'Accepted file list refreshed.'
}
document.getElementById('refresh').addEventListener('click', () => { void run(refresh) })
void run(refresh)
FormData を送信する際の Content-Type は、ブラウザーに設定させてください。生成された multipart 境界を含める必要があるためです。手動設定でリクエストが壊れる理由は MDN で解説されています。ファイル選択の accept 値とクライアント側のサイズ検証は、早期にフィードバックを返すためのものであり、どちらもサーバーのセキュリティ対策ではありません。いずれかのリクエストが処理中の場合は fieldset を無効にし、busy ガードで繰り返し送信を無視します。選択した File は、アップロード開始前に取得します。
受理と拒否の動作確認
三つのファイルをすべて格納したディレクトリから、サーバーを起動します。
node server.ts
出力された URL をそのまま開き、alice としてログインして、note.json を選択し、Upload を実行してください。「Accepted into private memory」と表示されたら、ダウンロードリンクを使用します。空白を含め、元のバイト列が添付ファイルとして返されます。保存先を尋ねるか、note.json がすでに存在するときに新しいファイル名を選ぶかは、ブラウザーが決定します。リンクをクリックしただけでは、ファイルが保存されたことは確認できません。
{"message":42} を含むファイルを試してください。バーが満杯になる場合もありますが、サーバーは 422 を返し、ページには必要な内容の説明が表示され、受理済みリストにエントリは追加されません。別のプライベートブラウザーウィンドウで bob としてログインし、Alice のダウンロード URL を開くと、404 が返されます。セッションがなければ 401 が返されます。サーバーのアプリケーションエラーには固定メッセージを使用し、パーサーの詳細、パス、送信された内容は含めません。
| レスポンス | 意味と次の操作 |
|---|---|
201 | 受理され、このプロセス内に保持されています。所有者が利用できます。 |
400 / 415 | multipart リクエストまたはそのフィールドを修正してください。 |
401 / 403 | 次のアップロード前に、セッションまたは CSRF 検証情報を復元してください。 |
413 | 固定のサイズ制限を超えています。より小さいファイルを選択してください。 |
422 | ファイルの内容を修正してください。 |
409 | このユーザーのファイルはすでに十個保存されています。再起動するとデモの全データが消去されます。 |
| ネットワークエラー、タイムアウト、その他のステータス | 受理されたか未確認です。受理済みリストを更新してから、次の操作を判断してください。 |
413 やレスポンスの消失を含め、自動再試行は行いません。サーバーがファイルを保存した後にレスポンスが失われた場合は、リストを更新すると新しいエントリが表示されます。ダウンロードしてバイト列を確認してください。手動で再アップロードすると、二つ目の ID が作成されます。本番環境で安全にアップロードを再試行するには、永続的でユーザー単位の重複排除の契約が必要です。このサーバーは、一時的な障害や Retry-After を通知しません。
アプリケーションへの組み込み
Ctrl+C でデモを停止すると、受理済みファイル、パスワード、セッションは破棄されます。デプロイ時には、ローカルユーザーとメモリ内のマップを、アプリケーションの認証、認可、CSRF ミドルウェア、非公開の永続ストレージに置き換えてください。HTTPS と Secure セッション Cookie を使用してください。デモの HTTP Cookie は、このループバックでの演習に限って使用します。Cookie の各属性には異なる役割があります。デプロイ先に応じたレート制限、同時実行数制限、ストレージクォータも設定してください。デモのリクエストサイズ制限や接続数制限は、これらの対策の代わりにはなりません。
より大きなファイルには、このサイズ制限付きのメモリ内パーサーではなく、ストリーミングパーサーと保存経路が必要です。再開可能なアップロードが必要な場合は、tus サーバーと互換クライアントを使用してください。ファイルをチャンクに分割するだけでは、認可、再構成、クリーンアップ、安全なリクエストの再実行は実現できません。この例には、意図的にチャンク用エンドポイントを設けていません。
