Menghasilkan Token Apple MapKit JS dengan Web Crypto API

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

Skrip ini menggunakan Web Crypto API JavaScript di lingkungan edge, dengan fokus pada kompatibilitas dengan runtime Next.js. Ini memastikan pembuatan token yang dioptimalkan, modular, dan dapat digunakan kembali 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 Backend untuk Node.js

Versi ini mendemonstrasikan penggunaan modul `crypto` Node.js untuk penanganan kunci pribadi PKCS#8, memanfaatkan kemampuan runtime sisi server.

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

Pertanyaan Umum Tentang Web Crypto API dan Token Apple MapKit

1. Apa itu PKCS#8, dan mengapa diperlukan untuk Web Crypto?
2. PKCS#8 adalah format pengkodean kunci yang digunakan untuk menyimpan kunci pribadi dengan aman. Itu Web Crypto API memerlukan format ini untuk kompatibilitas dan impor kunci yang aman.
3. Bagaimana TextEncoder membantu dalam operasi kriptografi?
4. Itu TextEncoder mengubah string menjadi biner Uint8Array, yang diperlukan untuk penandatanganan dan proses kriptografi lainnya.
5. Apa peran ECDSA dalam proses ini?
6. ECDSA (Elliptic Curve Digital Signature Algorithm) digunakan untuk menghasilkan tanda tangan digital yang aman. Itu crypto.subtle.sign metode menerapkan algoritma ini di Web Crypto API.
7. Mengapa keyData saya menjadi tidak valid selama impor kunci?
8. Tidak sah keyData kesalahan sering kali terjadi karena konversi PEM ke biner yang salah atau string kunci yang salah format.
9. Bagaimana cara men-debug masalah dengan token yang tidak ditandatangani?
10. Verifikasi pengkodean Base64 komponen JWT Anda menggunakan btoa dan memastikan string diteruskan secara akurat ke fungsi kriptografi.

Menyelesaikan Pembuatan Token yang Aman

Transisi dari Node.js ke Web Crypto API menawarkan pemahaman yang lebih mendalam tentang alat kriptografi modern. Pengembang dapat menyesuaikan proses mereka dengan berfokus pada penanganan kunci, teknik pengkodean, dan API tingkat lanjut untuk memenuhi tuntutan runtime edge dan pembuatan token yang aman. 🚀

Baik diterapkan di Next.js atau dibuat untuk browser, penggunaan Web Crypto API memberdayakan pengembang untuk membangun aplikasi yang skalabel dan aman. Dengan kompatibilitas dan efisiensinya, API memastikan bahwa tugas-tugas penting seperti penandatanganan token tetap kuat, sehingga menciptakan pengalaman pengguna yang lebih lancar. 🔐