データ暗号化
ルール
- すべての通信にTLS:HTTPをHTTPSにリダイレクトし、HSTSヘッダーを設定し、暗号化されていない接続を許可しない
- PIIカラムはアプリケーションレベルでAES-256-GCMにより暗号化してからデータベースに保存する
- メールアドレスはSHA-256でハッシュ化して検索用とし、表示用にはAES-256-GCMで暗号化する — データを露出せずに検索を可能にする
- パスワード:bcryptまたはargon2idのみ — SHA、MD5、可逆暗号化は絶対に使用しない
- データベースバックアップを暗号化し、暗号鍵はデータと別に保存する
- ブラウザ側の暗号化には
crypto.subtle を、サーバー側には node:crypto を使用する
- 暗号鍵は秘密管理サービスに保存し、コードや暗号化データと一緒に決して保存しない
import { createCipheriv, createDecipheriv, randomBytes } from "node:crypto";
const ENCRYPTION_KEY = Buffer.from(process.env.ENCRYPTION_KEY!, "hex");
function encrypt(plaintext: string): string {
const iv = randomBytes(12);
const cipher = createCipheriv("aes-256-gcm", ENCRYPTION_KEY, iv);
const encrypted = Buffer.concat([cipher.update(plaintext, "utf8"), cipher.final()]);
const tag = cipher.getAuthTag();
return Buffer.concat([iv, tag, encrypted]).toString("base64");
}
function decrypt(ciphertext: string): string {
const buf = Buffer.from(ciphertext, "base64");
const iv = buf.subarray(0, 12);
const tag = buf.subarray(12, 28);
const encrypted = buf.subarray(28);
const decipher = createDecipheriv("aes-256-gcm", ENCRYPTION_KEY, iv);
decipher.setAuthTag(tag);
return decipher.update(encrypted) + decipher.final("utf8");
}
避けるべきこと
- PIIをプレーンテキストで保存する — 一度データベースが侵害されるとすべてが露出する
- ECBモードや認証なしのAES(HMACなしのCBC)を使用する — GCMを使用すること
- パスワードのハッシュ化にMD5やSHAを使用する — これらはパスワードハッシュアルゴリズムではない
- 暗号鍵をソースコードにハードコーディングする — 環境変数やKMSを使用すること
- 機密データをHTTPで送信する(内部通信であっても) — すべての接続にTLSを使用すること