Generera Apple MapKit JS-tokens med Web Crypto API

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

Det här skriptet använder JavaScripts Web Crypto API i en edge-miljö, med fokus på kompatibilitet med Next.js runtime. Det säkerställer optimerad, modulär och återanvändbar tokengenerering för 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 för Node.js

Den här versionen demonstrerar användningen av Node.js `crypto`-modul för hantering av privata PKCS#8-nyckel, vilket utnyttjar runtime-funktioner på serversidan.

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

Vanliga frågor om Web Crypto API och Apple MapKit-tokens

1. Vad är PKCS#8 och varför krävs det för webbkryptering?
2. PKCS#8 är ett nyckelkodningsformat som används för att lagra privata nycklar säkert. De Web Crypto API kräver detta format för kompatibilitet och säker nyckelimport.
3. Hur hjälper TextEncoder i kryptografiska operationer?
4. De TextEncoder konverterar strängar till en binär Uint8Array, vilket är nödvändigt för signering och andra kryptografiska processer.
5. Vilken roll har ECDSA i denna process?
6. ECDSA (Elliptic Curve Digital Signature Algorithm) används för att generera en säker digital signatur. De crypto.subtle.sign metoden tillämpar denna algoritm i Web Crypto API.
7. Varför blir min nyckeldata ogiltig under nyckelimport?
8. Ogiltig keyData fel uppstår ofta på grund av felaktig PEM-till-binär konvertering eller felformaterade nyckelsträngar.
9. Hur kan jag felsöka problem med osignerade tokens?
10. Verifiera Base64-kodningen för dina JWT-komponenter med hjälp av btoa och se till att strängen skickas korrekt till de kryptografiska funktionerna.

Avsluta Secure Token Generation

Övergång från Node.js till Web Crypto API ger en djupare förståelse för moderna kryptografiska verktyg. Utvecklare kan anpassa sina processer genom att fokusera på nyckelhantering, kodningstekniker och avancerade API:er för att möta kraven på edge-runtimes och säker tokengenerering. 🚀

Oavsett om du distribuerar på Next.js eller bygger för webbläsare, med hjälp av Web Crypto API ger utvecklare möjlighet att bygga skalbara, säkra applikationer. Med sin kompatibilitet och effektivitet säkerställer API:et att viktiga uppgifter som att signera tokens förblir robusta, vilket skapar smidigare användarupplevelser. 🔐