当前位置：首页 > 文章列表 > 文章 > 前端 > JavaScript密码学实战：WebCryptoAPI使用教程

JavaScript密码学实战：WebCryptoAPI使用教程

2026-01-23 14:07:50 0浏览收藏

今日不肯埋头，明日何以抬头！每日一句努力自己的话哈哈~哈喽，今天我将给大家带来一篇《JavaScript密码学实战：Web Crypto API应用解析》，主要内容是讲解等等，感兴趣的朋友可以收藏或者有更好的建议在评论提出，我都会认真看的！大家一起进步，一起学习！

Web Crypto API 可在浏览器中实现安全加密操作，支持密钥管理、AES-GCM 加解密、HMAC、ECDSA 签名及 SHA-256 哈希，适用于数据保护与身份认证，需结合 HTTPS、安全存储与后端协作以构建完整安全体系。

JavaScript密码学_Web Crypto API应用实践

Web Crypto API 是现代浏览器提供的一套强大的加密功能接口，能够在客户端实现安全的密码学操作，而无需依赖第三方库。它支持哈希计算、对称加密、非对称加密、数字签名和密钥生成等操作，适用于身份认证、数据保护、安全通信等场景。本文将介绍如何在实际项目中使用 Web Crypto API 完成常见加密任务。

生成和管理密钥

密钥是加密操作的核心。Web Crypto API 提供了 crypto.subtle.generateKey() 方法来安全地生成密钥对或对称密钥。

例如，生成一对用于加密/解密的 RSA 密钥：

const generateRsaKeyPair = async () => {
  return await crypto.subtle.generateKey(
    {
      name: "RSA-OAEP",
      modulusLength: 2048,
      publicExponent: new Uint8Array([1, 0, 1]),
      hash: "SHA-256"
    },
    true,
    ["encrypt", "decrypt"]
  );
};

对于对称加密（如 AES-GCM），可以生成一个共享密钥：

const generateAesKey = async () => {
  return await crypto.subtle.generateKey(
    {
      name: "AES-GCM",
      length: 256
    },
    true,
    ["encrypt", "decrypt"]
  );
};

生成的密钥默认不可提取，提升了安全性。若需导出，应设置 extractable: true 并使用 exportKey() 转换为可传输格式（如 JWK）。

数据加密与解密

使用对称加密保护敏感数据是一种常见做法。AES-GCM 模式既加密又验证完整性，适合大多数场景。

示例：使用 AES-GCM 加密字符串

const encryptData = async (key, data) => {
  const encoder = new TextEncoder();
  const encoded = encoder.encode(data);

  const iv = crypto.getRandomValues(new Uint8Array(12)); // 初始化向量
  const ciphertext = await crypto.subtle.encrypt(
    {
      name: "AES-GCM",
      iv: iv
    },
    key,
    encoded
  );

  return { ciphertext, iv };
};

对应的解密过程：

const decryptData = async (key, ciphertext, iv) => {
  const decrypted = await crypto.subtle.decrypt(
    {
      name: "AES-GCM",
      iv: iv
    },
    key,
    ciphertext
  );

  const decoder = new TextDecoder();
  return decoder.decode(decrypted);
};

注意：每次加密必须使用唯一的 IV，避免重放攻击。

消息完整性与数字签名

确保数据未被篡改可通过哈希或签名实现。Web Crypto 支持 HMAC 和 ECDSA 等机制。

生成消息摘要（SHA-256）：

const hashMessage = async (message) => {
  const encoder = new TextEncoder();
  const data = encoder.encode(message);
  return await crypto.subtle.digest("SHA-256", data);
};

使用 ECDSA 进行签名和验证：

const signData = async (privateKey, data) => {
  const encoder = new TextEncoder();
  const encoded = encoder.encode(data);

  return await crypto.subtle.sign(
    {
      name: "ECDSA",
      hash: { name: "SHA-256" }
    },
    privateKey,
    encoded
  );
};

const verifySignature = async (publicKey, signature, data) => {
  const encoder = new TextEncoder();
  const encoded = encoder.encode(data);

  return await crypto.subtle.verify(
    {
      name: "ECDSA",
      hash: { name: "SHA-256" }
    },
    publicKey,
    signature,
    encoded
  );
};

签名可用于用户身份确认或防止数据伪造。