使用 Web Crypto API 生成 Apple MapKit JS 令牌

使用 Web Crypto API 生成 Apple MapKit JS 令牌：模块化方法

该脚本在边缘环境中使用 JavaScript 的 Web Crypto API，重点关注与 Next.js 运行时的兼容性。它确保为 Apple 的 MapKit 生成优化、模块化和可重用的令牌。

// Frontend solution using Web Crypto API
async function generateAppleMapKitToken() {
  // Header for the JWT
  const header = {
    alg: 'ES256',
    kid: 'your-key-id', // Replace with your actual key ID
    typ: 'JWT'
  };
  const epoch = Math.floor(Date.now() / 1000);
  const claims = {
    iss: 'your-team-id', // Replace with your actual team ID
    iat: epoch,
    exp: epoch + 60 * 60 * 24 * 7,
    origin: 'http://localhost:3000'
  };
  const unsignedToken = btoa(JSON.stringify(header)) + '.' + btoa(JSON.stringify(claims));
  const privateKeyPem = `-----BEGIN PRIVATE KEY-----\\nYOUR_PRIVATE_KEY\\n-----END PRIVATE KEY-----`;
  const privateKeyBuffer = convertPemToBinary(privateKeyPem);
  const key = await crypto.subtle.importKey(
    'pkcs8',
    privateKeyBuffer,
    { name: 'ECDSA', namedCurve: 'P-256' },
    false,
    ['sign']
  );
  const signature = await crypto.subtle.sign(
    { name: 'ECDSA', hash: { name: 'SHA-256' } },
    key,
    new TextEncoder().encode(unsignedToken)
  );
  const base64Signature = btoa(String.fromCharCode(...new Uint8Array(signature)));
  return unsignedToken + '.' + base64Signature.replace(/=/g, '').replace(/\+/g, '-').replace(/\//g, '_');
}

// Helper function to convert PEM to binary
function convertPemToBinary(pem) {
  const base64 = pem.replace(/-----\\w+ PRIVATE KEY-----/g, '').replace(/\\s+/g, '');
  return Uint8Array.from(atob(base64), c => c.charCodeAt(0));
}

Node.js 的后端替代方案

此版本演示了如何使用 Node.js “crypto” 模块进行 PKCS#8 私钥处理，并利用服务器端运行时功能。

const crypto = require('crypto');
function generateAppleMapKitTokenNode() {
  const header = {
    alg: 'ES256',
    kid: process.env.APPLE_MAPS_P8_KEY_ID,
    typ: 'JWT'
  };
  const epoch = Math.floor(Date.now() / 1000);
  const claims = {
    iss: process.env.APPLE_TEAM_ID,
    iat: epoch,
    exp: epoch + 60 * 60 * 24 * 7,
    origin: 'http://localhost:3000'
  };
  const unsignedToken = Buffer.from(JSON.stringify(header)).toString('base64') + '.' +
    Buffer.from(JSON.stringify(claims)).toString('base64');
  const signer = crypto.createSign('sha256');
  signer.update(unsignedToken);
  signer.end();
  const signature = signer
    .sign({
      key: process.env.APPLE_MAPS_P8_KEY.replace(/\\n/g, '\\n'),
      format: 'pem'
    })
    .toString('base64')
    .replace(/=/g, '')
    .replace(/\\+/g, '-')
    .replace(/\\//g, '_');
  return unsignedToken + '.' + signature;
}

有关 Web Crypto API 和 Apple MapKit 令牌的常见问题解答

1. 什么是 PKCS#8，为什么 Web 加密需要它？
2. PKCS#8 是一种用于安全存储私钥的密钥编码格式。这 Web Crypto API 需要此格式以实现兼容性和安全密钥导入。
3. TextEncoder 如何帮助加密操作？
4. 这 TextEncoder 将字符串转换为二进制 Uint8Array，这是签名和其他加密过程所必需的。
5. ECDSA 在此过程中扮演什么角色？
6. ECDSA（椭圆曲线数字签名算法）用于生成安全的数字签名。这 crypto.subtle.sign 方法在 Web Crypto API 中应用此算法。
7. 为什么我的 keyData 在密钥导入期间变得无效？
8. 无效的 keyData 由于 PEM 到二进制转换不正确或密钥字符串格式错误，经常会发生错误。
9. 如何调试未签名令牌的问题？
10. 使用以下命令验证 JWT 组件的 Base64 编码 btoa 并确保字符串准确地传递给加密函数。

结束安全令牌生成

从 Node.js 过渡到 Web Crypto API 可以让您更深入地了解现代加密工具。开发人员可以通过专注于密钥处理、编码技术和高级 API 来调整其流程，以满足边缘运行时和安全令牌生成的需求。 🚀

无论是在 Next.js 上部署还是为浏览器构建，使用 Web Crypto API 都使开发人员能够构建可扩展的安全应用程序。凭借其兼​​容性和效率，该 API 可确保签名令牌等关键任务保持稳健，从而创造更流畅的用户体验。 🔐