Sorun Giderme
Bu sayfa, SecTrail Authenticator kullanımında sık karşılaşılan sorunları ve çözümlerini içerir.
Hızlı Tanı Tablosu
| Belirti | Olası Neden | Bölüm |
|---|---|---|
| OTP kodu kabul edilmiyor | Cihaz saati hatalı | Kod Sorunları |
| Bildirim gelmiyor | İzin veya ağ sorunu | Bildirim Sorunları |
| Bildirim geliyor ama onay işlenmiyor | Cihazın sunucuya erişimi yok | Onay İşlenmiyor |
| QR kod taranamıyor | Kamera izni veya görüntü kalitesi | QR Sorunları |
| Uygulama açılmıyor / kapanıyor | Jailbreak/root tespiti | Uygulama Açılmıyor |
| QR ile giriş yanlış hesabı kullanıyor | Hesap sırası | Hesap Sırası |
| Passkey seçeneği görünmüyor | İşletim sistemi sürümü | Passkey Sorunları |
OTP Kodu Kabul Edilmiyor
Belirtiler:
- "OTP kodu hatalı" mesajı alınıyor
- Her deneme başarısız oluyor
- Kod doğru okunmasına rağmen reddediliyor
Soft OTP kodları cihaz saatine göre üretilir. Cihaz saati sunucu saatinden saparsa üretilen tüm kodlar geçersiz olur. Sorunun büyük çoğunluğu budur.
Çözüm Adımları
1. Cihaz saatini otomatik ayara alın
- iOS: Ayarlar → Genel → Tarih ve Saat → Otomatik Ayarla ✅
- Android / Huawei: Ayarlar → Sistem → Tarih ve saat → Otomatik tarih ve saat ✅
Ayar zaten açıksa, kapatıp tekrar açarak saatin yeniden senkronize olmasını sağlayın.
2. Zaman dilimini kontrol edin
Saat doğru görünse bile zaman dilimi yanlışsa kodlar geçersiz olur. Zaman diliminin de otomatik ayarlandığından emin olun.
3. Güncel kodu kullanın
Kodlar 30 saniyede bir yenilenir. Sayaç bitmek üzereyse yeni kodu bekleyin.
4. Doğru hesabın kodunu girdiğinizi doğrulayın
Birden fazla hesabınız varsa, giriş yaptığınız kuruma ait hesabın kodunu kullandığınızdan emin olun.
5. Hesabı yeniden kaydedin
Yukarıdakiler çözmezse, gizli anahtar hatalı kaydedilmiş olabilir. Kayıt panelinden hesabı yeniden kaydedin.
Soft OTP kodları cihaz üzerinde üretilir. Kod sorunları ağ kaynaklı değildir — internet bağlantısını kontrol etmek bu soruna çözüm getirmez.
Anlık Bildirim Gelmiyor
Belirtiler:
- Giriş yapılıyor ancak cihaza bildirim ulaşmıyor
- İstek zaman aşımına uğruyor
Çözüm Adımları
1. Bildirim iznini kontrol edin
- iOS: Ayarlar → SecTrail Authenticator → Bildirimler → İzin Ver ✅
- Android / Huawei: Ayarlar → Uygulamalar → SecTrail Authenticator → Bildirimler → İzin Ver ✅
2. İnternet bağlantısını doğrulayın
Anlık bildirim internet bağlantısı gerektirir. Cihazın çevrimiçi olduğundan emin olun.
3. Mobil veri ile test edin
Cihazı Wi-Fi'dan çıkarıp mobil veri (4G/5G) ile test edin:
- Mobil veride çalışıyor, Wi-Fi'da çalışmıyorsa → sorun cihazın bağlı olduğu ağdadır. Ağ yöneticinizden, kullanıcı cihazlarının bağlandığı ağda
cs.sectrail.com:443ve bildirim servislerine erişim açmasını isteyin. - İkisinde de çalışmıyorsa → sorun izin veya cihaz kaydındadır.
4. Pil optimizasyonunu kapatın (Android)
Android'de pil tasarrufu, arka plan bildirimlerini engelleyebilir:
Ayarlar → Uygulamalar → SecTrail Authenticator → Pil → Kısıtlama yok / Optimize etme
5. Cihaz kaydını yenileyin
Kayıt sırasında cihaz kayıt isteği sunucuya ulaşmamış olabilir. Hesabı kayıt panelinden yeniden kaydedin ve kayıt sonrası en az 30 saniye uygulamayı açık tutun.
Bildirim Geliyor Ama Onay İşlenmiyor
Belirtiler:
- Bildirim cihaza ulaşıyor ve görüntüleniyor
- "Onayla" butonuna basılıyor ancak giriş tamamlanmıyor
- İstek zaman aşımına uğruyor
Bildirimin cihaza ulaşması ile onayın işlenmesi iki ayrı adımdır:
- Bildirimin gelmesi → Firebase Cloud Messaging üzerinden sağlanır
- Onayın işlenmesi → mobil uygulamanın doğrudan
cs.sectrail.comadresine bağlanmasıyla sağlanır
Cihaz bu adrese ulaşamazsa bildirim görünür, ancak "Onayla" işlemi sunucuya ulaşmaz ve giriş tamamlanmaz.
Mobil Cihazın Eriştiği Adres
Kullanıcı cihazlarının bağlandığı ağda aşağıdaki erişimin açık olması gerekir:
Hedef: cs.sectrail.com
Port: 443 (HTTPS)
Yön: Outbound (mobil cihazdan)
Bu erişim şu işlemler için kullanılır:
| İşlem | Ne Zaman |
|---|---|
| Cihaz kaydı | Hesap ilk kaydedildiğinde |
| Onay/red sonucu | Kullanıcı bildirime yanıt verdiğinde |
| QR ile giriş doğrulaması | QR kod tarandığında |
SecTrail MFA sunucusunun cs.sectrail.com erişimi ile mobil cihazların bu adrese erişimi ayrı gereksinimlerdir. Sunucu tarafında kural açık olsa bile, kullanıcıların bağlandığı kurumsal Wi-Fi ağında bu erişim kapalıysa onaylar işlenmez.
Çözüm Adımları
- Cihazı mobil veri (4G/5G) ile test edin — çalışıyorsa sorun Wi-Fi ağındadır
- Kullanıcı Wi-Fi ağında
cs.sectrail.com:443çıkışını açtırın - Misafir/kullanıcı Wi-Fi ağlarında içerik filtreleme veya proxy olup olmadığını kontrol edin
QR Kod Taranamıyor
Belirtiler:
- Kamera açılıyor ama QR kod okunmuyor
- "Invalid QR Code" / "Unknown QR Code" hatası
Çözüm Adımları
1. Kamera iznini kontrol edin
- iOS: Ayarlar → SecTrail Authenticator → Kamera ✅
- Android / Huawei: Ayarlar → Uygulamalar → SecTrail Authenticator → İzinler → Kamera ✅
2. Görüntü koşullarını iyileştirin
- Ekran parlaklığını artırın
- QR kodun tamamının kamera görüş alanında olduğundan emin olun
- Telefonu çok yakın veya çok uzak tutmayın
- Ekran yansımasını önleyin
3. QR kodun geçerliliğini kontrol edin
QR kodların sınırlı bir geçerlilik süresi vardır. Kod ekranda uzun süre bekledi ise sayfayı yenileyerek yeni kod oluşturun.
4. Doğru QR kodu taradığınızdan emin olun
Kayıt QR kodu ile QR ile giriş kodu farklıdır. Uygulama içeriğe göre otomatik yönlendirme yapar, ancak geçersiz bir QR taranırsa hata verir.
5. Manuel kayıt kullanın
Kamera sorunu devam ediyorsa hesabı elle ekleyebilirsiniz:
⚙️ menü → How to Use It → "Register with Manual Informations" → Add Account
Gizli anahtar (Secret Key), kayıt panelindeki QR kodun altında gösterilir.
"Secret Key is invalid" Hatası
Manuel kayıt sırasında alınan bu hata, girilen gizli anahtarın formatının geçersiz olduğunu gösterir.
Gizli anahtarı elle yazmak yerine kopyalayıp yapıştırın. Karakterlerin yanlış okunması en sık karşılaşılan nedendir.
Uygulama Açılır Açılmaz Kapanıyor
Belirti: Uygulama başlatılıyor ancak hemen kapanıyor.
SecTrail Authenticator, jailbreak yapılmış (iOS) veya root'lanmış (Android) cihazlarda bilinçli olarak çalışmaz ve kendini kapatır.
Bu bir hata değil, güvenlik önlemidir: güvenliği ihlal edilmiş bir cihazda kimlik doğrulama sırlarının korunması garanti edilemez. Bu kontrol devre dışı bırakılamaz.
Çözüm
- Cihazın jailbreak/root durumunu kaldırın, veya
- Kurumsal kimlik doğrulama için güvenliği ihlal edilmemiş bir cihaz kullanın
Bazı özelleştirilmiş Android ROM'ları veya geliştirici seçenekleri, root tespit mekanizmasını tetikleyebilir. Cihazınız root'lu değilse ancak sorun devam ediyorsa BT ekibinizle görüşün.
QR ile Giriş Yanlış Hesabı Kullanıyor
Belirti: Birden fazla hesap kayıtlı ve QR ile giriş istenen hesapla değil, başka bir hesapla yapılıyor.
QR ile giriş, uygulamadaki ilk sıradaki (en üstteki) hesabı otomatik olarak kullanır. Bu bir hata değil, tasarım gereğidir.
Çözüm
- ⚙️ menü → Accounts sayfasını açın
- Giriş yapmak istediğiniz hesabı sürükleyerek en üste taşıyın
- Değişiklik anında etkili olur — QR ile giriş artık bu hesabı kullanır
Sık kullandığınız kurumsal hesabı kalıcı olarak en üstte tutun. QR ile giriş yapmadan önce hesap sırasını hızlıca kontrol etmeyi alışkanlık hâline getirin.
QR ile Giriş Tamamlanamıyor
Belirtiler:
- "Authentication Failed" mesajı
- "Request Timeout" mesajı
- İşlem 30 saniye sürüp başarısız oluyor
Çözüm Adımları
1. Cihazın sunucuya erişimini kontrol edin
QR ile giriş, mobil cihazın doğrudan cs.sectrail.com adresine bağlanmasını gerektirir. Cihazı mobil veri ile test edin.
👉 Mobil Cihazın Eriştiği Adres
2. QR kodun süresinin dolmadığından emin olun
Giriş ekranını yenileyerek yeni bir QR kod oluşturun ve tekrar tarayın.
3. Hesap sırasını kontrol edin
Doğru hesabın en üstte olduğundan emin olun — yanlış hesap kullanılıyorsa sunucu isteği reddedebilir.
4. Oturumu yenileyin
Tarayıcı oturumunu yenileyip giriş işlemini baştan başlatın.
5. Uygulamanın güncel olduğundan emin olun
Mağazadan uygulama güncellemesi olup olmadığını kontrol edin.
Biyometrik Doğrulama Etkinleştirilemiyor
Belirti: Biometric Authentication anahtarı açılıyor ama hemen kapalı konuma dönüyor.
Olası Nedenler ve Çözümler
| Neden | Çözüm |
|---|---|
| Cihazda kayıtlı biyometri yok | Cihaz ayarlarından parmak izi / yüz tanıma kaydedin |
| Donanım desteklemiyor | PIN kilidi kullanın |
| Biyometrik doğrulama iptal edildi | Anahtarı tekrar açıp doğrulamayı tamamlayın |
Biyometrik ayar kaydedildiğinde uygulama otomatik olarak yeniden başlar. Bu beklenen davranıştır.
Güvenlik Ayarları Değiştirilemiyor
Belirti: Security sayfasındaki PIN veya biyometrik anahtarı gri görünüyor ve değiştirilemiyor.
Ayarın yanında ☁️ bulut ikonu ve "Remote Configured" ifadesi varsa, bu ayar yöneticiniz tarafından merkezi olarak zorunlu kılınmıştır ve cihazdan değiştirilemez.
Değişiklik için BT ekibinizle görüşün.
Passkey Seçeneği Görünmüyor
Belirti: Uygulamada passkey ile ilgili hiçbir seçenek bulunmuyor.
Kontrol Listesi
1. İşletim sistemi sürümünü kontrol edin
| Platform | Gerekli Minimum Sürüm |
|---|---|
| iOS | 17.0 veya üzeri |
| Android | 14 (API 34) veya üzeri |
Cihazınız bu eşiğin altındaysa özellik hiç görünmez. Bu beklenen davranıştır.
2. Ekran kilidi tanımlı mı?
Passkey kullanımı için cihazda bir ekran kilidi (PIN, desen veya biyometrik) tanımlı olmalıdır.
3. Otomatik doldurma sağlayıcısı etkin mi?
- iOS: Ayarlar → Genel → Otomatik Doldurma ve Parolalar → SecTrail Authenticator ✅
- Android: Ayarlar → Parolalar ve hesaplar → SecTrail Authenticator ✅
Yedekleme Sorunları
Google Hesabına Giriş Yapılamıyor
- İnternet bağlantısını kontrol edin
- Google Play Services'in güncel olduğundan emin olun (Android)
- Farklı bir Google hesabı ile deneyin
Yedek Geri Yüklenemiyor
- Yedeği oluşturduğunuz aynı Google hesabı ile giriş yaptığınızdan emin olun
- Yedek dosyası bozulmuşsa geri yükleme yapılmaz; bu durumda hesapların yeniden kaydedilmesi gerekir
Yedekten geri yükleme yaptığınızda hesaplarınız gelir, ancak passkey'ler gelmez. Passkey'ler cihaza bağlıdır ve yeni cihazda yeniden kaydedilmelidir.
Cihaz Kaybı veya Çalınması
Kimlik doğrulama uygulamasının yüklü olduğu cihaz kaybolduysa veya çalındıysa derhal aşağıdaki adımları uygulayın:
- BT ekibinize haber verin — kullanıcının cihaz kaydı yönetim panelinden silinmelidir
- Şifrenizi değiştirin — cihaz hâlâ bildirim alabiliyor olabilir
- Bildirim geçmişini inceleyin (mümkünse) — yetkisiz giriş denemesi olup olmadığını kontrol edin
Yönetici Tarafında Yapılması Gerekenler
- Kullanıcının mobil cihaz kaydını yönetim panelinden silin
- Kullanıcının aktif SSO oturumlarını sonlandırın
- İzleme (Monitoring) kayıtlarından şüpheli aktivite olup olmadığını kontrol edin
İlgili sayfalar: Kullanıcılar · İzleme
Sorun Çözülmediyse
Yukarıdaki adımlar sorununuzu çözmediyse destek ekibiyle iletişime geçin.
Destek Talebinde Paylaşılması Gereken Bilgiler
Talebinizi hızlandırmak için şu bilgileri ekleyin:
- Cihaz modeli ve işletim sistemi sürümü
- SecTrail Authenticator uygulama sürümü
- Sorunun tam belirtisi ve alınan hata mesajı
- Sorunun ne zaman başladığı
- Denenen çözüm adımları
Destek talebinde gizli anahtarınızı (Secret Key), PIN kodunuzu veya şifrenizi asla paylaşmayın. SecTrail destek ekibi bu bilgileri sizden istemez.
İlgili Sayfalar
- Genel Bakış: Uygulama yetenekleri
- Kurulum: Kurulum ve izinler
- Kayıt: Hesap kayıt süreci
- Uygulama Özellikleri: Tüm özelliklerin kullanımı