如何在Chrome扩展中用SubtleCrypto签名Google OAuth JWT？

1. 是否可以用浏览器API在Chrome扩展中签名Google JWT？ #

可以，Chrome扩展的后台脚本（包括Service Worker、背景页）完全支持SubtleCrypto API，不需要依赖Node.js或第三方库就能完成服务账号的JWT签名流程。

2. 正确的实现方向和方法 #

你的代码核心问题出在密钥处理、算法参数匹配、Base64编码格式这三个地方，以下是修正后的完整实现：

错误分析 #

• 密钥类型混淆：服务账号JSON里的private_key是RSA私钥，开头应为-----BEGIN PRIVATE KEY-----，你代码里误写为PUBLIC KEY，且导入时用了加密算法RSA-OAEP，签名需要用RSASSA-PKCS1-v1_5。
• Base64编码错误：JWT要求URL安全的Base64（替换+为-，/为_，去掉末尾=），普通btoa不满足要求。
• 签名结果处理错误：SubtleCrypto.sign返回的是ArrayBuffer，不能直接用TextDecoder解码，要转成URL安全的Base64。

修正后的代码 #

// 工具函数：普通Base64转URL安全Base64
function base64UrlEncode(str) {
  return btoa(str)
    .replace(/\+/g, '-')
    .replace(/\//g, '_')
    .replace(/=+$/, '');
}

// 工具函数：Base64字符串转ArrayBuffer
function base64ToArrayBuffer(b64) {
  const byteString = atob(b64);
  const byteArray = new Uint8Array(byteString.length);
  for (let i = 0; i < byteString.length; i++) {
    byteArray[i] = byteString.charCodeAt(i);
  }
  return byteArray;
}

// 工具函数：ArrayBuffer转URL安全Base64
function arrayBufferToBase64Url(buffer) {
  const bytes = new Uint8Array(buffer);
  let str = '';
  for (const byte of bytes) {
    str += String.fromCharCode(byte);
  }
  return base64UrlEncode(str);
}

async function encodeJWT(email, scopes, privateKey) {
  // 1. 生成JWT的Header和Payload
  const iat = Math.floor(Date.now() / 1000);
  const exp = iat + 3600; // 有效期1小时，Google要求不超过1小时
  const header = { alg: 'RS256', typ: 'JWT' };
  const payload = {
    iss: email,
    scope: scopes.join(' '),
    aud: 'https://accounts.google.com/o/oauth2/token',
    exp: exp,
    iat: iat
  };

  // 转成URL安全的Base64
  const encodedHeader = base64UrlEncode(JSON.stringify(header));
  const encodedPayload = base64UrlEncode(JSON.stringify(payload));
  const unsignedJWT = `${encodedHeader}.${encodedPayload}`;

  // 2. 处理私钥：去除头尾标记和换行
  const cleanedKey = privateKey
    .replace('-----BEGIN PRIVATE KEY-----', '')
    .replace('-----END PRIVATE KEY-----', '')
    .replace(/\n/g, '');

  // 3. 导入私钥：使用RSASSA-PKCS1-v1_5算法（对应RS256）
  const importedKey = await crypto.subtle.importKey(
    'pkcs8', // 服务账号私钥是PKCS8格式
    base64ToArrayBuffer(cleanedKey),
    {
      name: 'RSASSA-PKCS1-v1_5',
      hash: { name: 'SHA-256' }
    },
    false, // 私钥不需要可导出
    ['sign'] // 只用于签名
  );

  // 4. 签名并转成URL安全Base64
  const signatureBuffer = await crypto.subtle.sign(
    'RSASSA-PKCS1-v1_5',
    importedKey,
    new TextEncoder().encode(unsignedJWT)
  );
  const encodedSignature = arrayBufferToBase64Url(signatureBuffer);

  // 5. 拼接完整JWT
  return `${unsignedJWT}.${encodedSignature}`;
}

关键注意事项 #

• 确保私钥是服务账号JSON中的private_key字段，格式为-----BEGIN PRIVATE KEY-----开头，不要误拿公钥。
• Chrome扩展中，crypto.subtle只能在安全上下文中使用，后台脚本、弹出页、HTTPS页面的内容脚本都支持，普通HTTP页面的内容脚本不行。
• 生成的JWT有效期不要超过1小时，Google OAuth服务会拒绝过期或有效期过长的JWT。

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