16 — Test ve Teşhis Araçları
Kimin için: Entegrasyon hatalarını hızlıca çözmek isteyen geliştiriciler ve QA uzmanları.
Ön koşul: Geliştirici Portalı erişimi.
Tahmini süre: 10 dakika.
Ne Öğreneceksiniz
- Geliştirici Portalındaki Entegrasyon Teşhis Aracı'nı (
/teshis) kullanmayı, - Redirect URI hatalarını otomatik Levenshtein algoritmasıyla tespit etmeyi,
- Token İnceleyici ile JWT imza, süre ve claim geçerliliğini denetlemeyi,
- Webhook imza doğrulamasını test etmeyi.
Portal İçi Teşhis Araçları
Geliştirici Portalında uygulamanızı seçip Teşhis sekmesine tıklayarak aşağıdaki 5 araca erişebilirsiniz:
1. Redirect URI Hata Tespiti
Yönlendirme adresinizde bir harf, port veya protokol hatası olduğunda sistem otomatik olarak en yakın kayıtlı adresi bulur ve farkı açıklar:
- Protokol Farkı:
http://ilehttps://uyuşmazlığı. - Sonda Slash Farkı:
https://app.com/callback/ilehttps://app.com/callbackuyuşmazlığı. - Port Farkı:
3000yerine3001gönderilmesi. - Fragment Hatası: URI içinde
#işareti bulunması (OAuth 2.0 standardında yasaktır).
2. Test Authorize URL Üretici
Uygulamanız için tek tıkla geçerli bir PKCE S256 test bağlantısı üretir:
- Otomatik olarak
code_verifier,code_challenge(S256) ve rastgelestateoluşturur. - Üretilen URL'e tıklayarak tarayıcınızda giriş akışını anında test edebilirsiniz.
3. Token İnceleyici (Token Inspector)
Uygulamanızın aldığı bir Access Token veya ID Token'ı bu araca yapıştırarak:
- JWT Başlık (
header) ve Gövde (payload) içeriğini görebilirsiniz. - İmza Geçerliliği: JWKS anahtarlarıyla imzanın doğru olup olmadığını test eder.
- Süre Kontrolü: Token'ın geçerlilik süresinin dolup dolmadığını (kalan saniyeyi) gösterir.
- Audience & Issuer Kontrolü: Token'ın gerçekten sizin istemciniz için üretilip üretilmediğini teyit eder.
Token İnceleyici aracı token değerini sunucu loglarına kesinlikle **yazmaz**. Analiz bellek üzerinde anlık yapılır.
4. Webhook İmza Doğrulama Testi
Webhook alıcı sunucunuzu test etmek için:
- Belirli bir olay tipi seçip uygulamanıza test ping isteği gönderebilirsiniz.
- Gönderilen imza başlığını (
X-Talost-Signature) kendi kodunuzda test ederek doğrulama algoritmanızın hatasız çalıştığını teyit edebilirsiniz.
5. Son OAuth Hata Günlüğü
Uygulamanıza ait istemciler üzerinden son 24 saatte dönen başarısız giriş veya geçersiz token takası hatalarını (invalid_grant, invalid_client vb.) zaman damgasıyla listeler.
İlgili Sayfalar
Son doğrulama: 2026-10-04 · Kaynak: _envanter.md, src/lib/apps/diagnostics.ts