Menjana Token Apple MapKit JS dengan Web Crypto API

Menjana Token Apple MapKit JS dengan Web Crypto API: Pendekatan Modular

Skrip ini menggunakan API Kripto Web JavaScript dalam persekitaran kelebihan, memfokuskan pada keserasian dengan masa jalan Next.js. Ia memastikan penjanaan token yang dioptimumkan, modular dan boleh diguna semula untuk MapKit Apple.

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

Alternatif Bahagian Belakang untuk Node.js

Versi ini menunjukkan penggunaan modul `crypto` Node.js untuk pengendalian kunci persendirian PKCS#8, memanfaatkan keupayaan masa jalan sebelah pelayan.

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

Soalan Lazim Mengenai Web Crypto API dan Token Apple MapKit

1. Apakah PKCS#8, dan mengapa ia diperlukan untuk Web Crypto?
2. PKCS#8 ialah format pengekodan kunci yang digunakan untuk menyimpan kunci peribadi dengan selamat. The Web Crypto API memerlukan format ini untuk keserasian dan import kunci selamat.
3. Bagaimanakah TextEncoder membantu dalam operasi kriptografi?
4. The TextEncoder menukar rentetan kepada binari Uint8Array, yang diperlukan untuk menandatangani dan proses kriptografi lain.
5. Apakah peranan ECDSA dalam proses ini?
6. ECDSA (Elliptic Curve Digital Signature Algorithm) digunakan untuk menjana tandatangan digital yang selamat. The crypto.subtle.sign kaedah menggunakan algoritma ini dalam Web Crypto API.
7. Mengapa data kunci saya menjadi tidak sah semasa import kunci?
8. Tidak sah keyData ralat sering berlaku disebabkan penukaran PEM-ke-perduaan yang salah atau rentetan kekunci tersalah format.
9. Bagaimanakah saya boleh nyahpepijat isu dengan token yang tidak ditandatangani?
10. Sahkan pengekodan Base64 komponen JWT anda menggunakan btoa dan pastikan rentetan dihantar dengan tepat kepada fungsi kriptografi.

Membungkus Penjanaan Token Selamat

Peralihan daripada Node.js kepada Web Crypto API menawarkan pemahaman yang lebih mendalam tentang alat kriptografi moden. Pembangun boleh menyesuaikan proses mereka dengan memfokuskan pada pengendalian kunci, teknik pengekodan dan API lanjutan untuk memenuhi permintaan masa jalan tepi dan penjanaan token selamat. 🚀

Sama ada menggunakan Next.js atau membina untuk penyemak imbas, menggunakan Web Crypto API memperkasakan pembangun untuk membina aplikasi berskala dan selamat. Dengan keserasian dan kecekapannya, API memastikan tugas kritikal seperti menandatangani token kekal teguh, mewujudkan pengalaman pengguna yang lebih lancar. 🔐