ブラウザーで Amazon S3 からファイルを安全にインポート
AWS 認証情報はサーバーまたは運用担当者のマシンに保持し、認可済みの単一オブジェクトに対して短期間だけ有効な署名付き GET URL を発行して、ブラウザーで Amazon S3 からバイト列を取得します。この例では最大 1 MiB のオブジェクトをインポートし、信頼できるバイト長と SHA-256 に照らして内容全体を検証した後に、成功を報告します。
ブラウザーで Amazon S3 から直接インポートする理由
ファイルは S3 からブラウザーに転送されるため、アプリケーションサーバーがレスポンス本文を中継しません。ただし、誰にどのオブジェクトの URL を渡すかは、引き続きサーバーが判断します。これは運用担当者が実行し、ローカルページへ手動で受け渡す小規模な例です。アプリケーションへのサインインや公開署名エンドポイントは実装していません。本番アプリケーションでは、URL の発行前に呼び出し元を認証し、対象オブジェクトへのアクセスを認可する必要があります。
署名付き URL は、所持者にアクセス権を与える仕組みです。入手した人は誰でも、有効期間内であればブラウザー以外からでも使用でき、再利用もできます。CORS は、別のオリジンの JavaScript がレスポンスを読み取れるかどうかを制御します。オブジェクトへのアクセスを制御するのは、S3 の権限と署名です。
S3 バケットの設定
us-east-1 にある非公開の汎用 S3 バケットを使用し、Block Public Access を有効にして、小さな既存オブジェクトを用意します。信頼できる作成元のアップロード記録から、バケット名、正確なキー、12 桁のバケット所有者アカウント ID、バイト長、SHA-256 を確認しておきます。受け入れるサイズは 0 バイト以上 1,048,576 バイト以下です。チェックサムは、ブラウザーがたまたま受信したデータから計算したハッシュではなく、保存されているオブジェクトのバイト列に対応している必要があります。この例では、ブラウザーによるデコードでバイト列が変わらないよう、HTTP コンテンツエンコーディングのないオブジェクトを使用します。
運用担当者には、そのオブジェクトを読み取る権限を持つ、設定済みの AWS SDK 認証情報ソースが必要です。このバージョン指定のない読み取りでは、対象オブジェクトの正確な ARN に対する
s3:GetObject が含まれます。SSE-KMS オブジェクトに対する KMS 権限など、追加の要件が適用される場合もあります。GetObject の認可要件を参照してください。署名の失敗を解消するために、オブジェクトを公開しないでください。
専用のテストバケットでは、ローカルページ用に次の JSON CORS 設定を使用します。既存のバケットでは、このルールを設定に統合し、他のルールでより広いオリジンを許可していないか確認してください。設定を置き換えると、他のアプリケーションに影響する可能性があります。この例はカスタムヘッダーなしで GET を送信し、ETag を調べないため、リクエストヘッダーのワイルドカード指定もレスポンスヘッダーの公開も不要です。S3 の CORS 要素を参照してください。
[
{
"AllowedOrigins": ["http://127.0.0.1:8787"],
"AllowedMethods": ["GET"],
"MaxAgeSeconds": 0
}
]
オリジンには、スキーム、ホスト名、ポートが含まれます。localhost と 127.0.0.1 は異なるオリジンです。以下のローカルサーバーが表示する正確な URL を使用し、別のポートを選ぶ場合は CORS ルールも変更してください。本番環境では HTTPS でアプリケーションを配信し、その HTTPS オリジンを完全一致で許可します。CORS を有効にしても S3 の ACL とポリシーは引き続き適用されます。
AWS SDK for JavaScript の使用
保守対象でパッチ適用済みの Node.js 26 リリース、別途インストールした Corepack、Fetch ストリームと Web Crypto に対応する最新のブラウザーを使用します。セットアップと運用スクリプトは Node.js 26.12.1、Corepack 0.36.0、Yarn 4.12.0、AWS SDK パッケージ 3.1073.0 で確認し、ページは Chromium 145 で確認しました。セキュリティリリースノートに従って Node にパッチを適用してください。ブラウザーはプラットフォーム API を使用し、AWS シークレットアクセスキーを受け取りません。
書き込み可能なディレクトリで、次の内容を Bash に貼り付けます。新しいプロジェクトを作成しますが、シェルの作業ディレクトリは元のままです。s3-browser-import ディレクトリが既に存在する場合は処理を拒否します。ローカルの Yarn 設定では、意図的にローカルの node_modules インストールを選択し、上位プロジェクトの Yarn 実行ファイルパスを無視します。
(
command -v node >/dev/null &&
command -v corepack >/dev/null &&
mkdir s3-browser-import &&
cd s3-browser-import &&
cat > package.json <<'JSON' &&
{
"private": true,
"type": "module",
"packageManager": "yarn@4.12.0",
"dependencies": {
"@aws-sdk/client-s3": "3.1073.0",
"@aws-sdk/s3-request-presigner": "3.1073.0"
}
}
JSON
printf '%s\n' 'nodeLinker: node-modules' 'enableGlobalCache: false' 'ignorePath: true' > .yarnrc.yml &&
touch yarn.lock &&
corepack yarn@4.12.0 install
)
インストールに失敗した場合、新しいディレクトリは調査用に残ります。次の 3 つのファイルを s3-browser-import 内に保存してください。以降のコマンドは、そのディレクトリから実行します。
運用担当者のマシンでチケットを発行
次の内容を sign.ts として保存します。引数は、バケット、キー、バケット所有者、想定バイト長、想定 SHA-256、有効期間(秒)です。この署名スクリプトは、小文字の英字、数字、ハイフンで構成されるバケット名を受け付けます。有効期間は 1 以上 300 以下の整数にする必要があります。すべてのメタデータは、信頼できるオブジェクトの記録から取得します。署名だけでは、オブジェクトの存在やアクセスの成功は確認できません。
import { GetObjectCommand, S3Client } from '@aws-sdk/client-s3'
import { getSignedUrl } from '@aws-sdk/s3-request-presigner'
async function main(): Promise<void> {
const args = process.argv.slice(2)
const [bucket, key, owner, sizeText, sha256, expiryText] = args
const size = Number(sizeText)
const expiresIn = Number(expiryText)
if (
args.length !== 6 || !bucket || !/^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$/.test(bucket) ||
!key || new TextEncoder().encode(key).length > 1024 || !/^\d{12}$/.test(owner ?? '') ||
!/^\d+$/.test(sizeText ?? '') || !Number.isSafeInteger(size) || size > 1_048_576 ||
!/^[a-f0-9]{64}$/.test(sha256 ?? '') || !/^\d+$/.test(expiryText ?? '') ||
!Number.isSafeInteger(expiresIn) || expiresIn < 1 || expiresIn > 300
) {
throw new Error('Invalid ticket arguments')
}
const client = new S3Client({
region: 'us-east-1',
endpoint: 'https://s3.us-east-1.amazonaws.com',
forcePathStyle: true,
})
try {
const command = new GetObjectCommand({ Bucket: bucket, Key: key, ExpectedBucketOwner: owner })
const url = await getSignedUrl(client, command, { expiresIn })
process.stdout.write(`${JSON.stringify({ url, size, sha256 })}\n`)
} finally {
client.destroy()
}
}
main().catch(() => {
console.error('Could not issue ticket. Check the six arguments and operator credentials.')
process.exitCode = 1
})
信頼できる記録に基づいて、シェル変数 S3_BUCKET、S3_KEY、S3_OWNER、S3_BYTES、S3_SHA256 を設定します。続いて、次のエントリーポイントをそのまま実行すると、単一の JSON チケットが出力されます。
node sign.ts "$S3_BUCKET" "$S3_KEY" "$S3_OWNER" "$S3_BYTES" "$S3_SHA256" 60
SDK のリクエスト署名機能は、運用担当者の認証情報ソースを使用します。そのソースは運用担当者のマシンに保持してください。認証情報をページに貼り付けたり、認可なしに任意のバケット名とキーを受け付ける署名エンドポイントを追加したりしないでください。
ブラウザーでオブジェクトをインポートして検証
このページ全体を index.html として保存します。チケットのサイズによって、アプリケーションのオブジェクト用バッファーの上限を定めます。ヘルパーがバイト列を返すには、ストリームがそのサイズで正確に終了し、SHA-256 が一致する必要があります。30 秒のタイマーが、取得処理とレスポンス本文の読み取り中にキャンセルを要求します。インポート中はタブをアクティブにしてください。バックグラウンドのタブではタイマーが遅れる場合があります。サイズ制限未満でも、転送が遅いと失敗する場合があります。同時に実行するインポートは 1 件だけです。
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="referrer" content="no-referrer">
<meta name="color-scheme" content="light dark">
<title>Private S3 import</title>
<link rel="icon" href="data:,">
<h1>Private S3 import</h1>
<form id="import-form">
<label for="ticket">Import ticket</label>
<textarea id="ticket" rows="6" cols="30" autocomplete="off" spellcheck="false"></textarea>
<button type="submit">Import</button>
</form>
<p role="status" id="status">Ready.</p>
<script>
async function importObject(ticket) {
if (!ticket || typeof ticket.url !== 'string' ||
!Number.isSafeInteger(ticket.size) || ticket.size < 0 || ticket.size > 1_048_576 ||
typeof ticket.sha256 !== 'string' || !/^[a-f0-9]{64}$/.test(ticket.sha256)) {
throw new Error('Invalid ticket')
}
const url = new URL(ticket.url)
if (url.protocol !== 'https:' || url.username || url.password || url.hash) {
throw new Error('Invalid object URL')
}
const controller = new AbortController()
const timer = setTimeout(() => controller.abort(), 30_000)
let reader
try {
const response = await fetch(url.href, {
mode: 'cors', credentials: 'omit', cache: 'no-store', redirect: 'error',
referrerPolicy: 'no-referrer', signal: controller.signal,
})
if (!response.ok || !response.body) throw new Error('Object read failed')
reader = response.body.getReader()
const bytes = new Uint8Array(ticket.size)
let offset = 0
for (;;) {
const { done, value } = await reader.read()
if (done) break
if (value.length > bytes.length - offset) throw new Error('Object exceeds expected size')
bytes.set(value, offset)
offset += value.length
}
if (offset !== bytes.length) throw new Error('Incomplete object')
const digest = new Uint8Array(await crypto.subtle.digest('SHA-256', bytes))
const actual = Array.from(digest, (byte) => byte.toString(16).padStart(2, '0')).join('')
if (actual !== ticket.sha256) throw new Error('Object checksum mismatch')
return bytes
} finally {
clearTimeout(timer)
controller.abort()
if (reader) {
await reader.cancel().catch(() => {})
reader.releaseLock()
}
}
}
const form = document.getElementById('import-form')
const input = document.getElementById('ticket')
const button = form.querySelector('button')
const status = document.getElementById('status')
let busy = false
form.addEventListener('submit', async (event) => {
event.preventDefault()
if (busy) return
busy = true
button.disabled = true
input.disabled = true
status.textContent = 'Importing…'
const raw = input.value
input.value = ''
try {
const bytes = await importObject(JSON.parse(raw))
status.textContent = `Imported ${bytes.length} verified bytes.`
} catch {
status.textContent = 'Import failed. Check the ticket, object metadata, expiry, and CORS.'
} finally {
busy = false
button.disabled = false
input.disabled = false
}
})
</script>
</html>
importObject は、アプリケーションで利用するための
Uint8Array を返します。フォームは検証済みの結果をバイト数として表示します。ファイルをディスクに保存せず、ハンドラーの終了後にインポートしたバイト列を保持することもありません。貼り付けたチケットを消去し、ブラウザーストレージ、サードパーティースクリプト、オブジェクト URL は使用しません。ただし、ブラウザーとハッシュ処理の実装には独自のバッファーがあるため、1 MiB はオブジェクトの上限であり、ブラウザーの総メモリー使用量の上限ではありません。
ページをローカルで配信
次の内容を serve.ts として保存します。ループバックでこのページだけを配信し、レスポンスのキャッシュを無効にします。運用担当者の認証情報を公開せず、署名も実装していません。
import { readFile } from 'node:fs/promises'
import { createServer } from 'node:http'
async function main(): Promise<void> {
const args = process.argv.slice(2)
const port = args.length === 0 ? 8787 : Number(args[0])
if (args.length > 1 || (args.length === 1 && !/^\d+$/.test(args[0])) ||
!Number.isInteger(port) || port < 0 || port > 65535) {
throw new Error('Invalid port')
}
const html = await readFile(new URL('./index.html', import.meta.url))
const server = createServer((request, response) => {
const ok = request.method === 'GET' && request.url === '/'
response.writeHead(ok ? 200 : 404, {
'Content-Type': 'text/html; charset=utf-8',
'Cache-Control': 'no-store',
'Referrer-Policy': 'no-referrer',
})
response.end(ok ? html : 'Not found')
})
server.on('error', () => {
console.error('Could not start server. Check whether the port is available.')
process.exitCode = 1
})
server.listen(port, '127.0.0.1', () => {
const address = server.address()
if (address && typeof address !== 'string') {
console.log(`Open http://127.0.0.1:${address.port}/`)
}
})
const signals: NodeJS.Signals[] = ['SIGINT', 'SIGTERM']
for (const signal of signals) {
process.once(signal, () => {
server.close()
server.closeAllConnections()
})
}
}
main().catch(() => {
console.error('Could not start server. Check the port and index.html.')
process.exitCode = 1
})
node serve.ts 8787
http://127.0.0.1:8787/ を開き、新しく発行した JSON を
Import ticket に貼り付けて、Import を選択します。インポートが成功すると、16 バイトのオブジェクトでは
Imported 16 verified bytes. が表示され、それ以外では実際のバイト数が表示されます。終了したら Ctrl+C でフォアグラウンドのサーバーを停止します。8787 が使用中の場合は別のポートを使用し、ページの URL とバケットの CORS ルールの両方を更新してください。
パフォーマンス最適化のヒント
この例では、サイズに上限を設けた単一のオブジェクトをメモリーに読み込み、使用前にハッシュを計算します。ヘルパーを大規模なアプリケーションに組み込む場合は、同時インポート数を制限してください。そのアプリケーションのメモリー予算を超えるファイルには、ストリーミングで処理する実装か、通常のブラウザーダウンロードを選びます。ダウンロード URL を開くだけでは、JavaScript でインポートしたバイト列を取得したり、ファイルの保存を確認したりできません。
セキュリティのベストプラクティス
チケット全体を機密情報として扱ってください。保護された経路を通じて、意図した受信者だけに渡します。アプリケーションの URL、分析データ、ログ、共有クリップボード履歴、ブラウザーストレージには含めないでください。フォームを消去しても、既に作成されたコピーは無効化できません。クエリ文字列には署名情報が含まれ、一時セッショントークンが含まれる場合もあります。AWS シークレットアクセスキーは含まれていません。運用担当者の認証情報ソースをページのディレクトリから分離し、チケットの表示時は端末の記録を避けてください。
S3 はリクエストの開始時に URL の有効期限を確認します。進行中のダウンロードは期限後も続く場合がありますが、期限後に再開すると失敗する場合があります。一時認証情報によって URL の有効期間が短くなることがあり、権限の変更によってアクセスできなくなることもあります。この例の有効期間 60 秒の URL は、ダウンロード済みデータを消去する仕組みではありません。チェックサムは、信頼できる作成元の記録との不一致を検出しますが、攻撃者が提供したチケットの信頼性を証明するものではありません。
よくある問題と解決策
- チケットの発行に失敗する: 6 つの引数、想定メタデータ、運用担当者の認証情報ソースを確認してください。失敗を回避するために認証情報をブラウザーへ移さないでください。
- ブラウザーが失敗を報告する: ユーザー向けのメッセージは、意図的に複数の失敗をまとめて表示します。チケットが期限切れでないか、署名者が指定した所有者 ID で正確なキーを読み取れるか、ページのオリジンが CORS と一致するかを確認してください。CORS でブロックされたレスポンスは、JavaScript から HTTP ステータスを確認できない場合があります。CORS を変更しても、不足している S3 権限は付与されません。
- レスポンスを読み取れても検証に失敗する: 作成元のサイズと SHA-256 を確認し、オブジェクトの置き換えや HTTP コンテンツエンコーディングの有無を調べ、対象のバイト列に対して新しいチケットを発行してください。途中で切れたレスポンス、チェックサムの不一致、キャンセルされた転送を、インポート済みオブジェクトとして報告してはいけません。
まとめ
ブラウザーではなく Transloadit のサーバーで実行する、アプリケーション管理のインポートについては、S3 インポート Robotを参照してください。このブラウザーワークフローでは、オブジェクトの認可は発行者側で行い、受信者には短期間だけ有効なチケットのみを渡します。
