Generering af Apple MapKit JS-tokens med Web Crypto API

Generering af Apple MapKit JS-tokens med Web Crypto API: A Modular Approach

Dette script bruger JavaScripts Web Crypto API i et edge-miljø med fokus på kompatibilitet med Next.js runtime. Det sikrer optimeret, modulær og genbrugelig tokengenerering til Apples 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));
}

Backend-alternativ til Node.js

Denne version demonstrerer brug af Node.js `crypto`-modul til håndtering af private nøgler i PKCS#8, der udnytter server-side runtime-kapaciteter.

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;
}

Ofte stillede spørgsmål om Web Crypto API og Apple MapKit Tokens

1. Hvad er PKCS#8, og hvorfor er det påkrævet til Web Crypto?
2. PKCS#8 er et nøglekodningsformat, der bruges til at opbevare private nøgler sikkert. De Web Crypto API kræver dette format for kompatibilitet og sikker nøgleimport.
3. Hvordan hjælper TextEncoder i kryptografiske operationer?
4. De TextEncoder konverterer strenge til en binær Uint8Array, som er nødvendig for signering og andre kryptografiske processer.
5. Hvad er ECDSA's rolle i denne proces?
6. ECDSA (Elliptic Curve Digital Signature Algorithm) bruges til at generere en sikker digital signatur. De crypto.subtle.sign metoden anvender denne algoritme i Web Crypto API.
7. Hvorfor bliver mine nøgledata ugyldige under nøgleimport?
8. Ugyldig keyData fejl opstår ofte på grund af forkert PEM-til-binær konvertering eller forkert formaterede nøglestrenge.
9. Hvordan kan jeg fejlsøge problemer med usignerede tokens?
10. Bekræft Base64-kodningen af ​​dine JWT-komponenter ved hjælp af btoa og sørg for, at strengen overføres nøjagtigt til de kryptografiske funktioner.

Indpakning af sikker tokengenerering

Overgang fra Node.js til Web Crypto API giver en dybere forståelse af moderne kryptografiske værktøjer. Udviklere kan tilpasse deres processer ved at fokusere på nøglehåndtering, kodningsteknikker og avancerede API'er for at imødekomme kravene til edge runtime og sikker tokengenerering. 🚀

Uanset om de implementeres på Next.js eller bygger til browsere, giver brug af Web Crypto API udviklere mulighed for at bygge skalerbare, sikre applikationer. Med sin kompatibilitet og effektivitet sikrer API'et, at kritiske opgaver som signeringstokens forbliver robuste, hvilket skaber mere jævne brugeroplevelser. 🔐