web crypto api 是浏览器原生加密接口，支持密钥生成、加解密、签名和哈希等操作；基于w3c标准，安全性高、性能好，适用于前端敏感数据处理，但不能替代后端加密，也不宜单独保护长期密钥。
Web Crypto API 是浏览器原生支持的加密接口，无需第三方库即可完成密钥生成、加密、解密、签名和哈希等操作。它基于标准 Web 标准（W3C），安全性高、性能好，适合在前端安全处理敏感数据（如用户密码、临时令牌、本地存储内容），但不能替代后端加密，也不应单独用于保护长期密钥或高价值凭证。
支持的常用算法与适用场景
Web Crypto API 支持多种现代加密算法，选择需兼顾浏览器兼容性与安全需求：
- AES-GCM：推荐用于对称加密（如加密用户本地配置），支持认证加密（AEAD），可同时保证机密性与完整性；Chrome 45+、Firefox 34+、Edge 17+、Safari 14+ 支持。
- RSA-OAEP：适用于非对称加密（如用公钥加密会话密钥），适合密钥封装；需注意密钥长度建议 ≥2048 位。
- ECDSA（P-256/P-384）：常用于数字签名（如 JWT 签名验证），体积小、速度快，比 RSA 更适合前端。
- SHA-256 / SHA-512：用于哈希计算（如密码派生、数据指纹），不可逆，适合与 PBKDF2 或 HKDF 配合使用。
生成并使用 AES 密钥加密一段文本
以下是一个完整、可运行的 AES-GCM 加密示例，包含密钥生成、加密、解密三步，所有操作均在内存中完成，密钥不暴露：
// 1. 生成 256 位 AES-GCM 密钥
const key = await crypto.subtle.generateKey({ name: "AES-GCM", length: 256 }, true, ["encrypt", "decrypt"]);
// 2. 准备待加密数据与随机 IV（必须唯一）
const encoder = new TextEncoder();
const data = encoder.encode("Hello, Web Crypto!");
const iv = crypto.getRandomValues(new Uint8Array(12)); // GCM 推荐 12 字节 IV
// 3. 加密
const encrypted = await crypto.subtle.encrypt(
{ name: "AES-GCM", iv },
key,
data
);
// 4. 解密（仅示意，实际中密钥与 IV 需安全传递/存储）
const decrypted = await crypto.subtle.decrypt(
{ name: "AES-GCM", iv },
key,
encrypted
);
console.log(new TextDecoder().decode(decrypted)); // "Hello, Web Crypto!"
⚠️ 注意：IV 必须每次加密都随机生成且唯一，不可复用；密钥不可用 exportKey("jwk") 明文导出后存入 localStorage；若需持久化密钥，应使用 wrapKey + 主密钥加密保护。
安全使用的关键注意事项
Web Crypto 能力强大，但误用会导致严重风险：
-
密钥生命周期管理：调用
generateKey创建的密钥默认不可导出（extractable: false），这是安全默认值；除非明确需要（如跨窗口共享），否则不要设为true。 - 避免在主线程做大量加密：大文件加解密可能阻塞 UI，建议用 Web Worker 承载耗时操作。
- 不信任前端加密结果：攻击者可篡改 JS 逻辑绕过加密，服务端必须独立校验或重新处理敏感操作（如密码哈希应在服务端二次计算）。
-
检查浏览器支持：旧版 Safari 或 IE 完全不支持，可用
if ("subtle" in crypto)做基础检测，再按需降级或提示。
常见组合实践：用 PBKDF2 衍生密钥加密用户输入
当用户输入密码作为加密凭据时，不应直接用密码当 AES 密钥，而应通过密钥派生函数增强抗暴力破解能力：
async function encryptWithPassword(plainText, password) {
const encoder = new TextEncoder();
const salt = crypto.getRandomValues(new Uint8Array(16));
const iv = crypto.getRandomValues(new Uint8Array(12));
// 从密码派生 AES 密钥（迭代 100 万次，提升成本）
const keyMaterial = await crypto.subtle.importKey(
"raw",
encoder.encode(password),
{ name: "PBKDF2" },
false,
["deriveKey"]
);
const key = await crypto.subtle.deriveKey(
{ name: "PBKDF2", salt, iterations: 1e6, hash: "SHA-256" },
keyMaterial,
{ name: "AES-GCM", length: 256 },
true,
["encrypt", "decrypt"]
);
const encrypted = await crypto.subtle.encrypt({ name: "AES-GCM", iv }, key, encoder.encode(plainText));
// 返回 salt、iv、密文（base64），供后续解密使用
return {
salt: btoa(String.fromCharCode(...salt)),
iv: btoa(String.fromCharCode(...iv)),
cipher: btoa(String.fromCharCode(...new Uint8Array(encrypted)))
};
}
该模式适合加密本地缓存的笔记、表单草稿等低敏感度内容，但不适用于密码本身存储——密码应始终由服务端用 bcrypt/scrypt/Argon2 处理。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
