Web Crypto によるブラウザー内でのファイルのハッシュ計算
ブラウザーでファイルのハッシュを計算するには、file.arrayBuffer() でバイト列を読み取り、crypto.subtle.digest() に渡して、結果を16進数に変換します。以下のページでは、ローカルファイルを選択してチェックサムを計算し、必要に応じて公開元が提供する値と比較できます。ファイルはアップロードせず、ローカルで読み取ります。
ブラウザーの互換性と要件
crypto.subtle と File.prototype.arrayBuffer に対応したブラウザーが必要です。Web Crypto にはセキュアコンテキストが必要です。ページをホストする際は HTTPS を、ローカル開発では http://127.0.0.1 などのループバックアドレスを使います。このサンプルは、フォームを有効にする前に両方の API を確認します。
以下の二つのファイルを同じディレクトリに保存してください。JavaScript パッケージやビルド処理は不要です。ローカル配信用コマンドは POSIX シェルと Python 3 を使用しますが、既存の静的ファイルサーバーも使えます。
対応ハッシュアルゴリズム
公開元のチェックサムと同じアルゴリズムを使ってください。このサンプルの既定値は SHA-256 で、SHA-384 と SHA-512 も選択できます。16進数のダイジェストの長さは、それぞれ 64、96、128 文字です。Web Crypto の digest APIは SHA-1 にも対応していますが、既知の衝突の脆弱性があるため、セキュリティが重要な新規の検証用途には適していません。
ファイルのハッシュ計算の実装
以下を index.html として保存してください。遅延実行スクリプトは、フォームの解析後に実行されます。JavaScript の読み込みに失敗した場合にページを送信できないよう、コントロールは最初は無効になっています。
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>File checksum</title>
<script src="hash.js" defer></script>
</head>
<body>
<h1>File checksum</h1>
<form id="hashForm">
<fieldset id="hashControls" disabled>
<legend>Hash a local file</legend>
<p>
<label for="algorithmSelect">Hash algorithm</label>
<select id="algorithmSelect">
<option value="SHA-256">SHA-256</option>
<option value="SHA-384">SHA-384</option>
<option value="SHA-512">SHA-512</option>
</select>
</p>
<p>
<label for="fileInput">File (up to 50 MiB)</label>
<input type="file" id="fileInput" required />
</p>
<p>
<label for="expectedHash">Expected hexadecimal checksum (optional)</label>
<input type="text" id="expectedHash" spellcheck="false" autocomplete="off" />
</p>
<button type="submit">Calculate checksum</button>
</fieldset>
</form>
<p id="hashOutput" role="status">Checking browser support…</p>
<noscript>Enable JavaScript to calculate a checksum.</noscript>
</body>
</html>
以下を hash.js として保存してください。
async function calculateHash(file, algorithm = 'SHA-256') {
if (!(file instanceof File)) {
throw new Error('Input must be a File object')
}
const arrayBuffer = await file.arrayBuffer()
const hashBuffer = await crypto.subtle.digest(algorithm, arrayBuffer)
return Array.from(new Uint8Array(hashBuffer), (byte) =>
byte.toString(16).padStart(2, '0'),
).join('')
}
function setupFileHashing() {
const form = document.getElementById('hashForm')
const controls = document.getElementById('hashControls')
const fileInput = document.getElementById('fileInput')
const algorithmSelect = document.getElementById('algorithmSelect')
const expectedInput = document.getElementById('expectedHash')
const output = document.getElementById('hashOutput')
const digestLengths = { 'SHA-256': 64, 'SHA-384': 96, 'SHA-512': 128 }
if (
!window.isSecureContext ||
!window.crypto?.subtle ||
typeof File === 'undefined' ||
typeof File.prototype.arrayBuffer !== 'function'
) {
output.textContent =
'Use HTTPS or localhost in a browser with Web Crypto and File.arrayBuffer support.'
return
}
controls.disabled = false
output.textContent = 'Choose a file, then calculate its checksum.'
form.addEventListener('input', () => {
output.textContent = 'Inputs changed. Calculate the checksum again.'
})
form.addEventListener('submit', async (event) => {
event.preventDefault()
if (controls.disabled) return
const file = fileInput.files[0]
if (!file) {
output.textContent = 'Choose a file first.'
return
}
if (file.size > 50 * 1024 * 1024) {
output.textContent = 'Choose a file of 50 MiB or smaller.'
return
}
const algorithm = algorithmSelect.value
const expected = expectedInput.value.trim().toLowerCase()
if (
expected !== '' &&
(expected.length !== digestLengths[algorithm] || !/^[0-9a-f]+$/.test(expected))
) {
output.textContent = `Enter ${digestLengths[algorithm]} hexadecimal characters for ${algorithm}.`
return
}
controls.disabled = true
output.textContent = 'Computing checksum…'
try {
const hash = await calculateHash(file, algorithm)
let verdict = 'No expected checksum supplied.'
if (expected !== '') {
verdict = hash === expected ? 'Checksums match.' : 'Checksums do not match.'
}
output.textContent = `${file.name} (${algorithm}): ${hash}. ${verdict}`
} catch (error) {
output.textContent =
error instanceof DOMException && error.name === 'NotReadableError'
? 'Could not read the file. Select it again and retry.'
: 'Could not calculate the checksum. Try a smaller file or another browser.'
} finally {
controls.disabled = false
}
})
}
setupFileHashing()
calculateHash() は、テキストとしてデコードせずに生のバイト列を読み取ります。ファイル名と MIME タイプはダイジェストに含まれません。失敗の処理は呼び出し元に委ねます。ファイルの読み取りエラーを、未対応のアルゴリズムとして報告してはいけません。対象ファイルが変更された場合やアクセス不能になった場合、File API は読み取りを拒否することがあります。
フォームはハッシュ計算中に入力をロックし、成功時も失敗時も再び有効にします。入力を変更すると前の結果が消去されます。これにより、チェックサムが別のファイルやアルゴリズムの結果に見えるのを防ぎます。digest() は進捗イベントを提供しないため、処理中のメッセージに割合は表示されません。
ファイルの整合性の検証
ターミナルで、index.html と hash.js を含むディレクトリに移動し、次のコマンドを実行してください。
printf 'abc' > sample.txt
python3 -m http.server 8000 --bind 127.0.0.1
http://127.0.0.1:8000/ を開き、sample.txt を選択します。SHA-256 を選択したまま、期待するチェックサムとして次の値を貼り付けてください。
ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad
Calculate checksum をクリックしてください。結果にはファイル名、アルゴリズム、計算したダイジェストと、Checksums match. が表示されます。コマンドは末尾に改行のない、ちょうど三バイトのデータを作成します。テキストエディターで改行が追加されると、チェックサムは異なる値になります。
チェックサムの最初の文字を 0 に置き換えて再計算すると、Checksums do not match. が表示されます。16進数の英字は大文字でも入力でき、前後の空白も許容されます。長さが正しくない値、16進数以外の文字、貼り付けられたファイル名は拒否されます。検証済みとせずにダイジェストだけを計算するには、この欄を空のままにしてください。終了したら Ctrl+C でサーバーを停止してください。
実際のダウンロードでは、公開元の認証されたリリースページなど、信頼できる情報源から期待するチェックサムを取得してください。一致によって確認できるのは、その値とファイルの整合性であり、誰が公開したかを証明するものではありません。攻撃者がファイルとチェックサムの両方を置き換えられる場合、比較を成功させることができます。同様に、結果は JavaScript によって制御されるため、検証ツールも信頼できるページで実行してください。Web Crypto のセキュリティに関する考慮事項では、悪意のあるスクリプトが暗号処理を損なう理由を説明しています。
大容量ファイルの処理
crypto.subtle.digest() はストリーミング入力を受け付けません。ハッシュ計算の前にファイル全体がメモリに読み込まれ、ダイジェスト処理は入力をコピーするため、ファイルサイズを超えるメモリを見込む必要があります。このページは、50 MiB を超えるファイルを読み取り前に拒否します。これはサンプルアプリケーションの制限であり、ブラウザーの制限でも、すべてのデバイスに十分なメモリがあることの保証でもありません。
チャンクごとにハッシュを計算し、そのダイジェストを連結しても、ファイル全体のダイジェストにはなりません。最後のチャンクのダイジェストだけを保持した場合、検証対象もそのチャンクだけになります。より大きな入力には、逐次的なハッシュ計算の実装を選ぶか、サーバーでストリームのハッシュを計算してください。このサンプルを Web Worker に移しても、ファイル全体をメモリに保持する要件はなくなりません。
不一致の解釈
意図したファイルを選択したか、16進数のダイジェストだけをコピーしたか、公開元と同じアルゴリズムを選択したかを確認してください。不一致は、ダウンロードの途中切れ、リリースの違い、バイト列の変更を示す場合がありますが、チェックサムだけではどれが原因かは分かりません。別のアプリケーションで開いて保存すると内容が変わることがあるため、ダウンロードした元のファイルのハッシュを計算してください。
