Generering av Apple MapKit JS-tokens med Web Crypto API

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

Dette skriptet bruker JavaScripts Web Crypto API i et edge-miljø, med fokus på kompatibilitet med Next.js runtime. Det sikrer optimalisert, modulær og gjenbrukbar tokengenerering for 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 for Node.js

Denne versjonen demonstrerer bruk av Node.js `crypto`-modul for håndtering av private PKCS#8-nøkler, og utnytter kjøretidsfunksjoner på serversiden.

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 stilte spørsmål om Web Crypto API og Apple MapKit Tokens

1. Hva er PKCS#8, og hvorfor kreves det for webkryptering?
2. PKCS#8 er et nøkkelkodingsformat som brukes til å lagre private nøkler sikkert. De Web Crypto API krever dette formatet for kompatibilitet og sikker nøkkelimport.
3. Hvordan hjelper TextEncoder i kryptografiske operasjoner?
4. De TextEncoder konverterer strenger til en binær Uint8Array, som er nødvendig for signering og andre kryptografiske prosesser.
5. Hva er rollen til ECDSA i denne prosessen?
6. ECDSA (Elliptic Curve Digital Signature Algorithm) brukes til å generere en sikker digital signatur. De crypto.subtle.sign metoden bruker denne algoritmen i Web Crypto API.
7. Hvorfor blir nøkkeldataene mine ugyldige under nøkkelimport?
8. Ugyldig keyData feil oppstår ofte på grunn av feil PEM-til-binær konvertering eller feilformaterte nøkkelstrenger.
9. Hvordan kan jeg feilsøke problemer med usignerte tokens?
10. Bekreft Base64-kodingen til JWT-komponentene dine ved å bruke btoa og sikre at strengen sendes nøyaktig til de kryptografiske funksjonene.

Avslutter Secure Token Generation

Overgang fra Node.js til Web Crypto API gir en dypere forståelse av moderne kryptografiske verktøy. Utviklere kan tilpasse prosessene sine ved å fokusere på nøkkelhåndtering, kodingsteknikker og avanserte API-er for å møte kravene til edge-runtime og sikker tokengenerering. 🚀

Enten du distribuerer på Next.js eller bygger for nettlesere, gir bruk av Web Crypto API utviklere mulighet til å bygge skalerbare, sikre applikasjoner. Med sin kompatibilitet og effektivitet sikrer APIen at kritiske oppgaver som signering av tokens forblir robuste, og skaper jevnere brukeropplevelser. 🔐