Apple MapKit JS-tokens genereren met Web Crypto API

Apple MapKit JS-tokens genereren met Web Crypto API: een modulaire aanpak

Dit script maakt gebruik van de Web Crypto API van JavaScript in een edge-omgeving, waarbij de nadruk ligt op compatibiliteit met Next.js-runtime. Het zorgt voor een geoptimaliseerde, modulaire en herbruikbare tokengeneratie voor Apple's 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-alternatief voor Node.js

Deze versie demonstreert het gebruik van de Node.js `crypto`-module voor het verwerken van PKCS#8-privésleutels, waarbij gebruik wordt gemaakt van runtime-mogelijkheden aan de serverzijde.

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

Veelgestelde vragen over Web Crypto API en Apple MapKit-tokens

1. Wat is PKCS#8 en waarom is dit vereist voor Web Crypto?
2. PKCS#8 is een sleutelcoderingsformaat dat wordt gebruikt om privésleutels veilig op te slaan. De Web Crypto API vereist dit formaat voor compatibiliteit en veilige sleutelimport.
3. Hoe helpt de TextEncoder bij cryptografische bewerkingen?
4. De TextEncoder converteert tekenreeksen naar een binair getal Uint8Array, wat nodig is voor ondertekening en andere cryptografische processen.
5. Wat is de rol van ECDSA in dit proces?
6. ECDSA (Elliptic Curve Digital Signature Algorithm) wordt gebruikt om een ​​veilige digitale handtekening te genereren. De crypto.subtle.sign methode past dit algoritme toe in de Web Crypto API.
7. Waarom worden mijn keyData ongeldig tijdens het importeren van de sleutel?
8. Ongeldig keyData fouten treden vaak op als gevolg van onjuiste conversie van PEM naar binair of verkeerd opgemaakte sleutelreeksen.
9. Hoe kan ik problemen met niet-ondertekende tokens oplossen?
10. Controleer de Base64-codering van uw JWT-componenten met behulp van btoa en zorg ervoor dat de string nauwkeurig wordt doorgegeven aan de cryptografische functies.

Afronding van het veilig genereren van tokens

De overstap van Node.js naar Web Crypto API biedt een dieper inzicht in moderne cryptografische tools. Ontwikkelaars kunnen hun processen aanpassen door zich te concentreren op sleutelafhandeling, coderingstechnieken en geavanceerde API's om te voldoen aan de eisen van edge-runtimes en het veilig genereren van tokens. 🚀

Of het nu op Next.js wordt geïmplementeerd of voor browsers wordt gebouwd, het gebruik van de Web Crypto API stelt ontwikkelaars in staat schaalbare, veilige applicaties te bouwen. Dankzij de compatibiliteit en efficiëntie zorgt de API ervoor dat kritieke taken zoals het ondertekenen van tokens robuust blijven, waardoor een soepelere gebruikerservaring ontstaat. 🔐