Fitur Lanjutan

Panduan ini menjelaskan fitur dan kemampuan lanjutan dari alat JWT Parser untuk pengguna tingkat lanjut dan developer.

Manajemen Riwayat

Pelacakan Riwayat Otomatis

Alat ini secara otomatis menyimpan token yang telah diparse ke local storage browser Anda:

• Penyimpanan Persisten: Riwayat tetap tersedia setelah browser dimulai ulang
• Berfokus pada Privasi: Data hanya tetap berada di browser Anda
• Pembersihan Otomatis: Dibatasi hingga 50 token terbaru

Operasi Riwayat

• Muat dari Riwayat: Klik item riwayat mana pun untuk memuat ulang token tersebut
• Hapus Riwayat: Hapus semua token yang tersimpan sekaligus
• Pemilihan Token Tertentu: Pilih token tertentu untuk dianalisis ulang

Informasi Riwayat

Setiap entri riwayat menampilkan:

• Algoritma: Algoritma penandatanganan yang digunakan
• Kedaluwarsa: Kapan token berakhir masa berlakunya
• Stempel Waktu: Kapan token diparse
• Pratinjau Token: 50 karakter pertama token

Fitur Analisis Token

Deteksi Algoritma

Alat ini secara otomatis mengenali dan menampilkan:

• Algoritma Simetris: HS256, HS384, HS512
• Algoritma Asimetris: RS256, RS384, RS512, ES256, ES384, ES512
• Algoritma none: Token tanpa perlindungan (hanya untuk pengembangan)

Analisis Kedaluwarsa

• Waktu Kedaluwarsa: Mengubah timestamp Unix menjadi tanggal dan waktu yang mudah dibaca
• Zona Waktu: Ditampilkan dalam zona waktu lokal Anda
• Token Kedaluwarsa: Menunjukkan dengan jelas apakah token sudah kedaluwarsa

Analisis Claims

• Claims Standar: Secara otomatis mengidentifikasi claims standar RFC 7519
• Claims Kustom: Menampilkan claims khusus aplikasi
• Objek Bersarang: Menangani struktur payload yang kompleks

Fitur Salin dan Ekspor

Salinan Terstruktur

Saat Anda menyalin hasil, Anda akan mendapatkan keluaran terstruktur seperti ini:

Header:
{
  "alg": "HS256",
  "typ": "JWT"
}

Payload:
{
  "sub": "1234567890",
  "name": "John Doe",
  "iat": 1516239022,
  "exp": 1516242622
}

Signature:
SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

Kasus Penggunaan Saat Menyalin

• Dokumentasi: Sertakan dalam dokumentasi API
• Debugging: Bagikan dengan anggota tim untuk analisis
• Pengujian: Gunakan dalam skenario pengujian otomatis
• Laporan: Masukkan ke laporan audit keamanan

Penanganan Error dan Validasi

Validasi Format

Alat ini melakukan pemeriksaan format secara menyeluruh:

• Validasi Struktur: Memastikan ada tepat 3 bagian yang dipisahkan titik
• Validasi Base64URL: Memverifikasi bahwa setiap bagian adalah base64url yang valid
• Validasi JSON: Memastikan header dan payload berupa JSON yang valid

Pesan Error

Pesan error yang jelas dan dapat ditindaklanjuti meliputi:

• Format Tidak Valid: Panduan spesifik tentang struktur JWT
• Error Parsing: Informasi detail mengenai kegagalan parsing
• Masalah Encoding: Bantuan untuk menangani masalah base64url

Pola Integrasi

Integrasi ke Workflow Pengembangan

1. Pengujian API: Parse token dari respons API
2. Debugging Autentikasi: Analisis token selama pengembangan
3. Code Review: Verifikasi struktur token di pull request
4. Dokumentasi: Buat contoh untuk dokumentasi API

Integrasi Pengujian

• Unit Test: Gunakan data hasil parsing dalam assertion
• Integration Test: Verifikasi struktur token dalam skenario pengujian
• Security Test: Analisis token untuk potensi risiko keamanan

Pertimbangan Performa

Pemrosesan di Sisi Klien

• Tanpa Panggilan Jaringan: Semua parsing dilakukan di browser Anda
• Pemrosesan Cepat: Hasil instan untuk sebagian besar token
• Hemat Memori: Penggunaan memori minimal
• Dapat Digunakan Offline: Berfungsi tanpa koneksi internet

Penanganan Token Besar

• Batas Ukuran: Menangani token hingga batas memori browser
• Performa: Dioptimalkan untuk ukuran JWT yang umum
• Penanganan Error: Menangani token terlalu besar dengan baik

Kompatibilitas Browser

Browser yang Didukung

• Chrome: Dukungan penuh (disarankan)
• Firefox: Dukungan penuh
• Safari: Dukungan penuh
• Edge: Dukungan penuh

Fitur yang Diperlukan

• Local Storage: Untuk fungsi riwayat
• Clipboard API: Untuk fungsi salin
• JSON Parsing: Untuk analisis token

Praktik Keamanan Terbaik

Penanganan Token

• Jangan Pernah Mencatat Token: Hindari mencatat token sensitif
• Lingkungan Aman: Gunakan hanya di lingkungan yang aman dan privat
• Pembersihan Berkala: Hapus riwayat secara rutin
• Kontrol Akses: Pastikan hanya pengguna yang berwenang yang dapat mengakses alat

Privasi Data

• Hanya Penyimpanan Lokal: Tidak ada data yang dikirim ke server eksternal
• Isolasi Browser: Data tetap berada di browser Anda
• Bersihkan Saat Berganti Konteks: Hapus data saat berpindah konteks

Pemecahan Masalah

Masalah Umum

1. Token Tidak Bisa Diparse: Periksa format dan encoding
2. Riwayat Tidak Tersimpan: Pastikan browser mendukung local storage
3. Fitur Salin Tidak Berfungsi: Periksa izin clipboard browser
4. Masalah Tampilan: Coba muat ulang halaman

Tips Debugging

• Periksa Console: Cari error JavaScript
• Verifikasi Format: Pastikan struktur token benar
• Uji dengan Contoh: Gunakan token contoh bawaan
• Bersihkan Cache: Coba hapus cache browser bila perlu

Referensi API

Struktur Token

interface ParsedJWT {
  header: string; // String JSON yang sudah diformat
  payload: string; // String JSON yang sudah diformat
  signature: string; // Signature mentah
}

interface JWTInfo {
  algorithm: string; // Algoritma penandatanganan
  type: string; // Jenis token
  expires: string; // Waktu kedaluwarsa
}

Struktur Riwayat

interface HistoryRecord {
  id: string; // Pengenal unik
  token: string; // Token JWT lengkap
  algorithm: string; // Algoritma penandatanganan
  expires: string; // Waktu kedaluwarsa
  timestamp: number; // Waktu parsing
}

Langkah Selanjutnya

Lanjutkan ke Pertimbangan Keamanan untuk panduan keamanan penting, atau lihat Contoh untuk skenario penggunaan nyata.