WebCrypto疑难：如何用deriveKey处理deriveKey生成的主密钥？

核心问题分析 #

你遇到的错误并非WebCrypto API缺陷，而是密钥用途的权限限制导致的：PBKDF2生成的密钥默认不具备deriveKey/deriveBits的使用权限，且WebCrypto的密钥用途是在生成/导入时就确定的不可变属性，后续调用deriveKey无法补加权限。

正确实现方案：直接生成支持派生用途的PBKDF2主密钥 #

无需导出再导入，只需在第一次调用deriveKey生成PBKDF2主密钥时，明确指定其keyUsages为["deriveKey", "deriveBits"]，就能直接用于HKDF派生子密钥，同时保持主密钥不可导出。

完整代码示例 #

async function generateMasterKey(password, salt) {
  // 将密码转换为PBKDF2可用的密钥
  const passwordKey = await crypto.subtle.importKey(
    "raw",
    new TextEncoder().encode(password),
    { name: "PBKDF2" },
    false,
    ["deriveKey"]
  );

  // 生成支持HKDF派生的主密钥，直接指定用途
  const masterKey = await crypto.subtle.deriveKey(
    {
      name: "PBKDF2",
      salt: salt,
      iterations: 100000,
      hash: "SHA-256"
    },
    passwordKey,
    { name: "HKDF", hash: "SHA-256" },
    false, // 主密钥设为不可导出
    ["deriveKey", "deriveBits"] // 赋予派生权限
  );

  return masterKey;
}

async function deriveAppKey(masterKey, appId) {
  // 用HKDF派生应用专属密钥
  return crypto.subtle.deriveKey(
    {
      name: "HKDF",
      salt: new Uint8Array(), // 无特定需求时传空数组
      info: new TextEncoder().encode(`app:${appId}`), // 用应用ID做唯一标识
      hash: "SHA-256"
    },
    masterKey,
    { name: "AES-GCM", length: 256 }, // 按应用需求指定密钥类型
    true, // 应用密钥是否可导出按需设置
    ["encrypt", "decrypt"]
  );
}

// 使用示例
(async () => {
  const password = "userSecurePassword123";
  const salt = crypto.getRandomValues(new Uint8Array(16)); // 需持久化存储该盐
  const masterKey = await generateMasterKey(password, salt);
  
  // 派生不同应用的密钥
  const app1Key = await deriveAppKey(masterKey, "app-001");
  const app2Key = await deriveAppKey(masterKey, "app-002");
  
  console.log("派生完成，主密钥未导出");
})();

规范依据 #

根据WebCrypto规范：

1. deriveKey生成的密钥，其keyUsages必须是目标算法支持的用途；
2. HKDF算法支持的用途仅为deriveKey和deriveBits，因此在PBKDF2派生主密钥时，必须明确指定这两个用途；
3. 密钥的用途是不可变属性，生成后无法修改，这就是后续调用deriveKey报错的根本原因。

临时方案的本质 #

导出再导入主密钥，本质是重新创建了一个可指定用途的新CryptoKey，但这属于冗余操作——直接在第一次deriveKey时设置正确用途即可避免。

内容的提问来源于stack exchange，提问作者Diggsey