Misafir, captive portal giriş sayfası yerine “Bağlantı kurulamadı” ya da “Bu portal için internet erişim grubu tanımlı değil” mesajı görüyorsa ekranda CP- ile başlayan bir hata kodu da gösterilir. Bu doküman her hata kodunun anlamını, nedenin cihaz günlüğünden nasıl bulunacağını ve çözüm adımlarını anlatır.
Doküman, SignLogger'ı yöneten sistem yöneticileri içindir. Captive portal ayarlarının tamamı için Captive Portal Yönetimi Kullanım Kılavuzu'na bakın.
Misafirin gördüğü ekran
Firewall misafiri portala yönlendirdiğinde SignLogger isteği tanımlı bir portalla eşleştiremezse misafire şu kart gösterilir:
Bağlantı kurulamadı — Şu anda internet bağlantınız açılamadı. Lütfen birkaç saniye sonra tekrar deneyin. Sorun sürerse aşağıdaki kodu görevliye iletin.
Hata kodu:
CP-107· Destek kodu:6064350a-9212-4a6f-a320-d3dc8e28d0e5
Güvenlik nedeniyle misafire ayrıntı gösterilmez; ayrıntı cihaz günlüğüne yazılır. Misafirden ekrandaki iki kodu da iletmesini isteyin.
Hata kodu ve destek kodu
- Hata kodu (
CP-101…CP-112): nedenin kısa ve kalıcı karşılığıdır. Aynı neden her zaman aynı kodu verir; numaralar sürümler arasında değişmez. Çoğu durumda aşağıdaki tablodan nedeni doğrudan bulabilirsiniz.CP-100tanımlanmamış bir nedeni gösterir; destek ekibine iletin. - Destek kodu: her istekte yeniden üretilen bir kimliktir, hatanın kendisi değildir. Aynı sorun iki kez yaşanırsa iki farklı destek kodu çıkar. Görevi, cihaz günlüğünde o isteğe ait satırı bulmanızı sağlamaktır.
Hata kodları özet tablosu
Portal eşleştirme denetimleri tablodaki sırayla yapılır; ilk başarısız olan denetimin kodu gösterilir.
| Hata kodu | Günlükteki neden | Ne oldu? | Nereye bakılmalı? |
|---|---|---|---|
CP-101 | database_connection_failed | Portal ayarları okunamadı. | Servisi yeniden başlatın; sürerse destek ekibi |
CP-102 | invalid_post_url | Firewall'un gönderdiği giriş adresi okunamıyor. | Firewall yönlendirme ayarı |
CP-103 | database_query_failed | Portal ayarları okunurken hata oluştu. | Servisi yeniden başlatın; sürerse destek ekibi |
CP-104 | ssid_not_found | İstekte gelen portal adıyla tanımlı bir portal yok. | Portal Adı |
CP-105 | missing_post_host | Firewall'un gönderdiği giriş adresinde firewall adresi yok. | Firewall yönlendirme ayarı |
CP-106 | invalid_user_ip | İstekteki misafir IP'si geçerli bir IPv4/IPv6 adresi değil. | Firewall yönlendirme ayarı |
CP-107 | firewall_host_mismatch | Portal bulundu, ama yönlendirmeyi yapan firewall'un adresi portalın Firewall IP ya da FQDN ayarıyla uyuşmuyor. | Firewall IP, FQDN |
CP-108 | guest_network_mismatch | Portal ve firewall eşleşti, ama misafirin IP'si portalın Guest Network aralığında değil. | Guest Network |
CP-109 | unexpected_lookup_failure | Tüm eşleşmeler sağlanıyor görünse de portal açılamadı. | Servisi yeniden başlatın; sürerse destek ekibi |
CP-110 | portal_user_group_missing | Portalda RADIUS grubu seçili değil. | RADIUS Grup |
CP-111 | portal_user_group_not_found | Portalda seçili grup sistemde yok (silinmiş ya da adı değişmiş). | RADIUS Grup |
CP-112 | portal_user_group_disabled | Portalda seçili grup devre dışı. | RADIUS Grup |
Nedeni cihaz günlüğünden bulma
Hata kodu nedeni çoğu zaman tek başına anlatır. Ayrıntı gerekirse cihaz konsolundan ya da SSH ile SignLogger CLI'a girin ve misafirin ilettiği destek kodunun ilk parçasıyla günlükte arama yapın:
get log service-filter captive-portal 500 6064350aÇıktıda şuna benzer bir satır görünür:
[PORTAL-TANI] istek_id=6064350a-… kod=CP-107 neden=firewall_host_mismatch ssid="Misafir" post="https://10.0.0.9:1003/fgtauth?…"
userIP="192.168.50.7" ssid_kaydı_var=true host_eşleşti=false guest_net_eşleşti=false aday=1 …| Alan | Anlamı |
|---|---|
kod | Ekranda görünen hata kodu |
neden | Neden (özet tablosundaki “Günlükteki neden” sütunu) |
ssid | İstekte gelen portal adı |
post | Firewall'un misafiri geri göndereceği giriş adresi; bu adresin sunucu kısmı firewall'un adresidir |
userIP | Misafir cihazının IP adresi |
ssid_kaydı_var | Bu adla tanımlı bir portal bulundu mu |
host_eşleşti | Firewall adresi portalın Firewall IP / FQDN ayarıyla eşleşti mi |
guest_net_eşleşti | Misafir IP'si portalın Guest Network aralığında mı |
aday | Bu adla bulunan portal sayısı |
Destek kodu günlükte bulunamıyorsa istek eski olabilir; satır sayısını artırın (ör. 2000) ya da misafirden yeniden denemesini ve yeni kodu iletmesini isteyin. Tüm captive portal tanı satırlarını görmek için desen olarak PORTAL-TANI yazabilirsiniz.
Not:
get log service-filterkomutu, hesabınızda servisleri ve günlükleri görüntüleme yetkisi gerektirir. Komutun ayrıntıları için SignLogger CLI Kullanım Kılavuzu'na bakın.
Çözüm adımları
Portal ayarları yönetim panelinde Captive Portal sayfasındadır.
CP-104 — Portal adı bulunamadı
- Günlükteki
ssiddeğerini portalın Portal Adı ile karşılaştırın. Büyük/küçük harf, boşluk ve Türkçe karakter farkı da uyuşmazlık sayılır. - Firewall'daki captive portal adresi portal bağlantısıyla aynı olmalıdır:
http://<cihaz adresi>:8080/<Portal Adı>. - Firewall'da portal adı değiştirildiyse ya da yeni bir SSID eklendiyse panelde de aynı adla bir portal tanımlayın.
CP-107 — Firewall adresi eşleşmedi
- Günlükteki
postadresinin sunucu kısmına bakın (ör.https://10.0.0.9:1003/…için10.0.0.9). Bu, misafiri yönlendiren firewall'un adresidir. - Portalın Firewall IP ayarı bu adresi içermelidir. Tek IP, CIDR aralığı ya da virgülle ayrılmış liste yazılabilir. Yüksek erişilebilirlik (HA) çiftinde iki üyenin adresini de ekleyin.
- Firewall IP adresi yerine alan adı gönderiyorsa bu ad portalın FQDN ayarıyla aynı olmalıdır.
- Firewall'un IP adresi değiştiyse (ör. yeni arayüz ya da yeni cihaz) Firewall IP ayarını güncelleyin.
CP-108 — Misafir ağı eşleşmedi
- Günlükteki
userIPdeğerinin portalın Guest Network aralıklarından birinde olduğunu doğrulayın (ör.192.168.50.7için192.168.50.0/24). Birden fazla misafir ağı varsa hepsini virgülle ekleyin. userIPbir vekil sunucunun ya da firewall'un kendi adresiyse, firewall misafirin gerçek adresini göndermiyordur; firewall'un captive portal yönlendirme ayarını kontrol edin.
CP-102, CP-105, CP-106 — Firewall yönlendirmesi hatalı
Firewall yönlendirmesi eksik ya da hatalı parametrelerle geliyor. Firewall'daki harici captive portal ayarında portal adresinin ve firewall türünün doğru seçildiğini, misafir IP'si ile giriş adresinin yönlendirmeye eklendiğini kontrol edin. Firewall'a özel ayarlar için Firewall Entegrasyonları dokümanlarına bakın. Firewall yazılımı yeni güncellendiyse yönlendirme biçimi değişmiş olabilir; destek ekibine başvurun.
CP-101, CP-103, CP-109 — Cihaz tarafında geçici sorun
Bunlar ayar hatası değildir; cihaz tarafında bir sorunu gösterir. Captive portal servisini yeniden başlatıp misafirden yeniden denemesini isteyin:
enable
execute restart captive-portalPortal ayarları doğru olduğu hâlde bu kodlar sık tekrarlanıyorsa önce cihazı güncel sürüme yükseltin. Sorun sürerse destek talebi için gerekenler bölümündeki bilgilerle destek ekibine başvurun.
CP-110, CP-111, CP-112 — Misafir kodu girdi ama bağlanamadı
SMS ve TC Kimlik doğrulama yöntemleri misafir için hesap açar ve hesabı portalın RADIUS Grup ayarındaki gruba ekler. İnternet erişim kuralları bu gruba bağlıdır; grubu olmayan misafirin girişi firewall tarafından reddedilir. Bu nedenle portalın grubu kullanılamıyorsa misafire SMS gönderilmez, doğrulama yapılmaz ve şu mesaj gösterilir: “Bu portal için internet erişim grubu tanımlı değil. Lütfen görevliye başvurun. Hata kodu: CP-11x”.
| Hata kodu | Çözüm |
|---|---|
CP-110 | Portalı düzenleyin ve RADIUS Grup alanından misafir grubunu seçin. |
CP-111 | Grubu yeniden oluşturun ya da portalda var olan bir grubu seçin. |
CP-112 | Grubu etkinleştirin. |
Günlükte bu durum şöyle görünür:
[PORTAL-TANI] kod=CP-110 neden=portal_user_group_missing ssid="Misafir" grup="" yöntem=sms — SMS gönderilmediGüncel sürümde panel, SMS, TC Kimlik ya da Form ile giriş açıkken grup seçilmeden portalın kaydedilmesine izin vermez.
Destek talebi için gerekenler
- Misafirin ilettiği hata kodu ve destek kodu
get log service-filter captive-portal 500 <destek kodunun ilk parçası>komutunun çıktısı- Portalın Portal Adı, Firewall IP, FQDN ve Guest Network ayarlarının ekran görüntüsü
- Firewall modeli ve yazılım sürümü
get system versionkomutunun çıktısı
Sıkça Sorulan Sorular
Captive portalda “Bağlantı kurulamadı” hatası ne anlama gelir?
Firewall misafiri SignLogger'a yönlendirmiş, ancak SignLogger bu isteği tanımlı bir portalla eşleştirememiştir. Ekrandaki CP- hata kodu nedeni gösterir; en sık görülenler portal adının uyuşmaması (CP-104), firewall adresinin portalın Firewall IP ayarında olmaması (CP-107) ve misafir IP'sinin Guest Network aralığı dışında kalmasıdır (CP-108).
CP-107 hatası nasıl çözülür?
Misafiri yönlendiren firewall'un adresini portalın Firewall IP ayarına ekleyin. Adresi, günlükteki post alanının sunucu kısmından öğrenebilirsiniz. HA çiftlerinde iki üyenin adresini de ekleyin; firewall alan adı gönderiyorsa FQDN ayarını kontrol edin.
Destek kodu neden her seferinde farklı?
Destek kodu her istek için yeniden üretilen bir kimliktir ve yalnızca günlükte o isteğe ait satırı bulmaya yarar. Hatanın nedenini hata kodu (CP-xxx) gösterir; aynı neden her zaman aynı hata kodunu verir.
Misafir SMS kodunu alamıyor ve CP-110 görüyor, ne yapmalıyım?
Portalda RADIUS grubu seçili değildir. Portalı düzenleyip RADIUS Grup alanından misafir grubunu seçin. Grup seçilmeden misafire SMS gönderilmez, çünkü gruba bağlı erişim kuralı olmadan firewall girişi reddeder.
CP-101 ya da CP-109 görüyorum, ayarlarım doğru mu?
Bu kodlar ayar hatası değil, cihaz tarafında geçici bir sorun gösterir. Captive portal servisini execute restart captive-portal komutuyla yeniden başlatın. Sık tekrarlanıyorsa cihazı güncel sürüme yükseltin ve sürerse destek ekibine başvurun.