雜湊函式為什麼重要

每當使用者建立帳號,您的系統都會面對一個根本問題:要如何儲存他們的密碼?天真的答案是存成純文字,這種做法曾造成歷史上最嚴重的幾起資料外洩。雜湊函式是正確答案的基礎。

雜湊、加鹽與 HMAC:安全處理資料的開發者指南

密碼學雜湊函式會把任意長度的輸入轉成固定長度的輸出(稱為「摘要」或「雜湊」),並具備三項關鍵特性:

  1. 確定性: 相同的輸入永遠產生相同的輸出。
  2. 單向性: 即使拿到輸出,要在計算上還原輸入也是不可行的。
  3. 雪崩效應: 輸入有極小的變化(即使只有 1 位元),輸出也會完全不同。

這些特性讓您只需儲存雜湊,而不必儲存密碼本身。使用者登入時,把輸入內容做雜湊,再與儲存的雜湊比對。若相符,代表密碼正確,而您始終不需要知道原始密碼。


雜湊演算法比較

就安全用途而言,並非所有雜湊演算法都一樣。

演算法 輸出大小 速度 可用於密碼? 目前狀態
MD5 128 位元 非常快 絕對不行 已被破解:已發現碰撞
SHA-1 160 位元 快 絕對不行 已不建議使用:已發現碰撞
SHA-256 256 位元 快 不行(太快) 用於完整性檢查是安全的
SHA-512 512 位元 快 不行(太快) 用於完整性檢查是安全的
bcrypt 192 位元 慢(可調整) 可以 建議使用
scrypt 可變 慢 + 吃記憶體 可以 建議使用
Argon2id 可變 慢 + 吃記憶體 可以 目前的最佳選擇

為什麼密碼雜湊時「太快」是問題

SHA-256 是為速度而設計的,在現代硬體上每秒可計算數十億次雜湊。這很適合檢查檔案完整性,卻非常不適合儲存密碼:偷走您資料庫的攻擊者,每秒可以嘗試數十億次猜測。

bcrypt、Argon2id 等密碼雜湊演算法是刻意設計得很慢的。它們帶有成本係數(也稱工作係數或迭代次數),用來控制每次雜湊所需的計算量。隨著硬體變快,您就提高成本係數,以維持同樣的實際安全性。

SHA-256:每秒約 10 億次雜湊(GPU)
bcrypt(成本 12):每秒約 200 次雜湊 — 慢 500 萬倍
Argon2id:可設定,還能設得更慢

鹽:為什麼不可省略

即使使用慢速演算法,仍有另一種攻擊:彩虹表,也就是預先計算好、把常見密碼對應到其雜湊的資料庫。如果兩位使用者的密碼都是 “hunter2”,他們的 bcrypt 雜湊會不同,但在沒有加鹽的情況下,他們的 SHA-256 雜湊會完全相同,洩漏兩人使用相同密碼的事實。

鹽(salt) 是為每位使用者產生的唯一隨機值,在雜湊之前與密碼結合。鹽會與雜湊一起以明文儲存(它不是祕密,目的是提供隨機性,而不是機密性)。

使用者 A:鹽 = "x7kP9mQ3",密碼 = "hunter2"
  → hash("x7kP9mQ3hunter2") → 唯一的雜湊 A

使用者 B:鹽 = "r2Tz8wN5",密碼 = "hunter2"
  → hash("r2Tz8wN5hunter2") → 唯一的雜湊 B(完全不同)

現代的密碼雜湊函式庫會自動處理鹽的產生。您絕不應該自己實作加鹽邏輯。

實際實作

// JavaScript / Node.js — 使用 bcrypt
import bcrypt from 'bcrypt';

// 對密碼做雜湊(鹽會自動產生並內嵌)
const hash = await bcrypt.hash('myPassword123', 12); // 12 = 成本係數
// "$2b$12$..." — 字串中包含演算法、成本、鹽與雜湊

// 登入時驗證
const isValid = await bcrypt.compare('myPassword123', hash); // true
const isWrong = await bcrypt.compare('wrongPassword', hash); // false
# Python — 使用 argon2-cffi(Argon2id)
from argon2 import PasswordHasher

ph = PasswordHasher(
    time_cost=3,     # 迭代次數
    memory_cost=65536, # 64 MB
    parallelism=2,
)

hash = ph.hash('myPassword123')  # 自動包含鹽

try:
    ph.verify(hash, 'myPassword123')  # 回傳 True,或拋出例外
    print("Valid password")
except Exception:
    print("Invalid password")
// Go — 使用 golang.org/x/crypto/bcrypt
import "golang.org/x/crypto/bcrypt"

// 雜湊
hash, err := bcrypt.GenerateFromPassword([]byte("myPassword123"), 12)

// 驗證
err = bcrypt.CompareHashAndPassword(hash, []byte("myPassword123"))
if err == nil {
    // 有效
}

HMAC:具備驗證功能的完整性檢查

單純的雜湊回答的是:「這份資料和之前一樣嗎?」
HMAC(Hash-based Message Authentication Code) 回答的是:「這份資料沒被修改過,而且是來自知道祕密金鑰的人嗎?」

HMAC 結合雜湊函式與共用的祕密金鑰:

HMAC(key, message) = hash(key ⊕ opad || hash(key ⊕ ipad || message))

如果不知道金鑰,即使能讀取並修改訊息,也無法產生有效的 HMAC。

常見使用情境

Webhook 簽章驗證: Stripe、GitHub 等服務會以 HMAC-SHA256 替 Webhook 酬載簽章,讓您能驗證請求確實來自它們:

import crypto from 'crypto';

function verifyWebhookSignature(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  
  // 使用 timingSafeEqual 以防止計時攻擊
  return crypto.timingSafeEqual(
    Buffer.from(signature, 'hex'),
    Buffer.from(expected, 'hex')
  );
}

API 請求簽章: 部分 API 要求以 HMAC 對請求參數簽章,以防止竄改與重送攻擊。

Cookie 完整性: 替 Cookie 的值簽章,讓竄改能被察覺(不過敏感資料仍應另外加密)。


用於資料完整性的 SHA-256(不是用於密碼)

對於非密碼的用途,例如驗證檔案完整性、產生內容指紋、建立校驗碼,SHA-256 是正確的選擇。它速度快、支援廣泛,且產生 64 個字元的十六進位字串。

// 瀏覽器 — 使用 Web Crypto API
async function sha256(text) {
  const encoder = new TextEncoder();
  const data = encoder.encode(text);
  const hashBuffer = await crypto.subtle.digest('SHA-256', data);
  const hashArray = Array.from(new Uint8Array(hashBuffer));
  return hashArray.map(b => b.toString(16).padStart(2, '0')).join('');
}

const hash = await sha256('Hello, World!');
// "dffd6021bb2bd5b0af676290809ec3a53191dd81c7f70a4b28688a362182986d"
import hashlib

# SHA-256
h = hashlib.sha256(b"Hello, World!").hexdigest()
# "dffd6021bb2bd5b0af676290809ec3a53191dd81c7f70a4b28688a362182986d"

# SHA-512(更強,輸出更大)
h512 = hashlib.sha512(b"Hello, World!").hexdigest()

要避免的常見安全錯誤

1. 用 MD5 或 SHA-1 處理密碼

這些演算法在密碼學上已被破解,可以用彩虹表還原。凡是與安全有關的用途,都不要使用。

2. 自己發明密碼學

雜湊函式的實作充滿細微的陷阱(計時攻擊、填充問題、金鑰衍生錯誤)。請務必使用經過充分審查的函式庫。

3. 比對時忘了使用 timingSafeEqual

單純的字串比對(===)一遇到第一個不相符就會提前結束。這會形成計時旁路:攻擊者可以量測比對所花的時間,逐一猜出正確的字元。對安全敏感的值,請一律使用恆定時間比對。

4. 重複使用鹽

如果所有使用者都用同一個鹽,密碼相同的使用者就會有相同的雜湊。每位使用者都必須有唯一、隨機產生的鹽。

5. 把祕密存在程式碼中

用於 HMAC 的祕密金鑰應來自環境變數或密鑰管理服務,絕不能寫死在原始碼中。


2026 年 11 月新增的功能

  • 現在支援 MD5、SHA-3(224/256/384/512)與 CRC32(在瀏覽器內以純 JS 實作)。MD5 與 SHA-3 也可用於 HMAC(CRC32 沒有 HMAC)。
  • MD5 與 CRC32 可被構造碰撞,請只用於檔案比對與舊 API 相容,不要用於竄改偵測或密碼學。

在工具中試用

常見問題

雜湊與加密有什麼不同?

雜湊是單向的:無法從雜湊還原原始資料。加密是雙向的:有金鑰就能解密密文,還原原始資料。密碼請用雜湊(您永遠不需要「看到」原始內容)。需要取回的資料,例如信用卡號或個人資訊,請用加密。

如何選擇 bcrypt 的成本係數?

成本係數應設定成在您的正式環境硬體上,雜湊需要約 100~300 毫秒。可以從成本 12 開始,並用 bcrypt.hash('test', cost) 實測。隨著硬體進步,再逐步提高成本。

該用 SHA-256 還是 SHA-3?

SHA-256(屬於 SHA-2 系列)很安全,仍是部署最廣的選擇。SHA-3(Keccak)的設計根本不同,同樣安全,但函式庫支援較少。除非有特定的合規或相容性要求規定必須使用 SHA-3,否則 SHA-256 是實務上的預設選擇。

除了密碼之外,敏感資料也可以用雜湊嗎?

需要取回的資料(社會安全號碼、支付卡號)請用加密,而不是雜湊。只需要驗證的資料(密碼、文件指紋)請用雜湊。至於儲存在伺服器端的 API 權杖,由於本來就是高熵的隨機值,使用 SHA-256 雜湊(不必用 bcrypt)是可以接受的。

什麼是雜湊碰撞?

當兩個不同的輸入產生相同的雜湊輸出時,就發生了碰撞。對 256 位元的雜湊來說,用暴力法找出碰撞在計算上是不可能的。但 MD5 與 SHA-1 存在已知的弱點,可以刻意製造碰撞,因此它們已不再被視為安全。