Gelişmiş Özellikler
Bu kılavuz, ileri düzey kullanıcılar ve geliştiriciler için JWT Parser aracının gelişmiş özelliklerini ve yeteneklerini açıklar.
Geçmiş Yönetimi
Otomatik Geçmiş Takibi
Araç, ayrıştırılan token'ları tarayıcınızın yerel depolama alanına otomatik olarak kaydeder:
- Kalıcı Depolama: Geçmiş, tarayıcı yeniden başlatılsa bile korunur
- Gizlilik Odaklı: Veriler yalnızca tarayıcınızda kalır
- Otomatik Temizlik: Son 50 token ile sınırlıdır
Geçmiş İşlemleri
- Geçmişten Yükle: İstediğiniz geçmiş kaydına tıklayarak token'ı yeniden yükleyin
- Geçmişi Temizle: Kaydedilmiş tüm token'ları tek seferde kaldırın
- Seçimli Yeniden Analiz: Yeniden incelemek için belirli token'ları seçin
Geçmiş Bilgileri
Her geçmiş kaydı şunları gösterir:
- Algoritma: Kullanılan imzalama algoritması
- Sona Erme: Token'ın ne zaman geçersiz olacağı
- Zaman Damgası: Token'ın ne zaman ayrıştırıldığı
- Token Önizlemesi: Token'ın ilk 50 karakteri
Token Analiz Özellikleri
Algoritma Tespiti
Araç aşağıdakileri otomatik olarak belirler ve gösterir:
- Simetrik Algoritmalar: HS256, HS384, HS512
- Asimetrik Algoritmalar: RS256, RS384, RS512, ES256, ES384, ES512
- none Algoritması: Güvence altına alınmamış token'lar (yalnızca geliştirme için)
Sona Erme Analizi
- Sona Erme Zamanı: Unix zaman damgasını okunabilir tarih ve saate dönüştürür
- Saat Dilimi: Yerel saat diliminizde gösterir
- Süresi Dolmuş Token'lar: Token'ın süresinin dolup dolmadığını açıkça belirtir
Claim Analizi
- Standart Claim'ler: RFC 7519 standart claim'lerini otomatik olarak tanımlar
- Özel Claim'ler: Uygulamaya özgü claim'leri gösterir
- İç İçe Nesneler: Karmaşık payload yapılarını işler
Kopyalama ve Dışa Aktarma Özellikleri
Yapılandırılmış Kopyalama
Sonuçları kopyaladığınızda aşağıdaki gibi yapılandırılmış bir çıktı elde edersiniz:
Header:
{
"alg": "HS256",
"typ": "JWT"
}
Payload:
{
"sub": "1234567890",
"name": "John Doe",
"iat": 1516239022,
"exp": 1516242622
}
Signature:
SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
Kopyalamanın Kullanım Alanları
- Dokümantasyon: API dokümantasyonuna ekleyin
- Hata Ayıklama: Analiz sonuçlarını ekip üyeleriyle paylaşın
- Testler: Otomatik test senaryolarında kullanın
- Raporlar: Güvenlik denetimi raporlarına ekleyin
Hata İşleme ve Doğrulama
Biçim Doğrulaması
Araç kapsamlı biçim kontrolleri yapar:
- Yapı Doğrulaması: Noktalarla ayrılmış tam 3 bölüm olduğunu doğrular
- Base64URL Doğrulaması: Her bölümün geçerli bir base64url olduğunu denetler
- JSON Doğrulaması: Header ve payload alanlarının geçerli JSON olduğunu doğrular
Hata Mesajları
Açık ve uygulanabilir hata mesajları sunulur:
- Geçersiz Biçim: JWT yapısı hakkında net yönlendirme
- Ayrıştırma Hataları: Ayrıştırma başarısızlıkları hakkında ayrıntılı bilgi
- Kodlama Sorunları: base64url kodlama problemlerini çözmeye yardımcı olur
Entegrasyon Kalıpları
Geliştirme Akışına Entegrasyon
- API Testi: API yanıtlarından gelen token'ları ayrıştırın
- Kimlik Doğrulama Hata Ayıklaması: Geliştirme sırasında token'ları analiz edin
- Kod İncelemesi: Pull request'lerde token yapısını doğrulayın
- Dokümantasyon: API belgeleri için örnekler oluşturun
Test Entegrasyonu
- Birim Testleri: Ayrıştırılmış verileri assertion'larda kullanın
- Entegrasyon Testleri: Test senaryolarında token yapısını doğrulayın
- Güvenlik Testleri: Token'ları olası güvenlik riskleri açısından inceleyin
Performans Hususları
İstemci Tarafı İşleme
- Ağ Çağrısı Yok: Tüm ayrıştırma tarayıcı içinde yapılır
- Hızlı İşleme: Çoğu token için anında sonuç verir
- Bellek Verimliliği: Düşük bellek kullanımı sağlar
- Çevrimdışı Çalışma: İnternet bağlantısı olmadan da kullanılabilir
Büyük Token'ları İşleme
- Boyut Sınırları: Tarayıcı belleğinin izin verdiği boyuta kadar token işler
- Performans: Tipik JWT boyutları için optimize edilmiştir
- Hata Yönetimi: Aşırı büyük token'ları kontrollü şekilde ele alır
Tarayıcı Uyumluluğu
Desteklenen Tarayıcılar
- Chrome: Tam destek (önerilir)
- Firefox: Tam destek
- Safari: Tam destek
- Edge: Tam destek
Gerekli Özellikler
- Local Storage: Geçmiş işlevi için
- Clipboard API: Kopyalama işlevi için
- JSON Parsing: Token analizi için
Güvenlik İçin En İyi Uygulamalar
Token Yönetimi
- Token'ları Asla Günlüğe Yazmayın: Hassas token'ları loglara kaydetmeyin
- Güvenli Ortam: Aracı yalnızca güvenli ve özel ortamlarda kullanın
- Düzenli Temizlik: Geçmişi düzenli olarak temizleyin
- Erişim Kontrolü: Araca yalnızca yetkili kullanıcıların eriştiğinden emin olun
Veri Gizliliği
- Yalnızca Yerel Depolama: Veriler harici sunuculara gönderilmez
- Tarayıcı İzolasyonu: Veriler tarayıcınızda kalır
- Bağlam Değiştirirken Temizleme: Bağlam değiştirirken verileri silin
Sorun Giderme
Yaygın Sorunlar
- Token Ayrıştırılamıyor: Biçimi ve kodlamayı kontrol edin
- Geçmiş Kaydedilmiyor: Tarayıcının yerel depolamayı desteklediğini doğrulayın
- Kopyalama Çalışmıyor: Tarayıcı pano izinlerini kontrol edin
- Görüntüleme Sorunları: Sayfayı yenilemeyi deneyin
Hata Ayıklama İpuçları
- Konsolu Kontrol Edin: JavaScript hatalarını arayın
- Biçimi Doğrulayın: Token yapısının doğru olduğundan emin olun
- Örneklerle Test Edin: Yerleşik örnek token'ı kullanın
- Önbelleği Temizleyin: Gerekirse tarayıcı önbelleğini temizleyin
API Başvurusu
Token Yapısı
interface ParsedJWT {
header: string; // Biçimlendirilmiş JSON dizgesi
payload: string; // Biçimlendirilmiş JSON dizgesi
signature: string; // Ham imza
}
interface JWTInfo {
algorithm: string; // İmzalama algoritması
type: string; // Token türü
expires: string; // Sona erme zamanı
}
Geçmiş Yapısı
interface HistoryRecord {
id: string; // Benzersiz kimlik
token: string; // Tam JWT token'ı
algorithm: string; // İmzalama algoritması
expires: string; // Sona erme zamanı
timestamp: number; // Ayrıştırma zamanı
}
Sonraki Adımlar
Önemli güvenlik yönergeleri için Güvenlik Hususları sayfasını inceleyin veya gerçek kullanım senaryoları için Örnekler bölümüne bakın.