DOKÜMANTASYON

OPNsense Entegrasyonu

OPNsense Captive Portal ile Captivo entegrasyonu

Gereksinimler: OPNsense 23.1+ ve aktif bir LAN/WLAN arayüzü
Aktif Oturumlar listesinin çalışması için: RADIUS accounting'i açın (1813 portu) VE cihazın periyodik accounting güncellemesi göndermesini sağlayın. Captivo bir oturumu, cihaz sinyal göndermeye devam ettiği sürece canlı sayar; yalnız başlangıç ve bitiş gönderiliyorsa hâlâ bağlı olan misafir 10 dakika sonra listeden düşer, cihazın kendi ekranında ise görünmeye devam eder. Ayar genelde Interim, Accounting Interim Update veya Update Interval adıyla geçer; bir dakika iyi bir değerdir.
Bant genişliği (bandwidth) limiti: OPNsense Captive Portal, RADIUS üzerinden gelen WISPr-Bandwidth-Max-Down/Upattribute'larını uygulamaz. Captivo profillerinde indirme/yükleme hızı belirleseniz bile OPNsense bu değerleri yok sayar.

Çözüm: Hız limitlemek için OPNsense tarafında iki yol var:
  • Services → Captive Portal → Zone → Edit → Bandwidth alanları
  • Firewall → Shaper ile traffic shaping kurulumu
pfSense kullanıyorsanız Captivo profillerindeki hız limitleri sorunsuz uygulanır; bu kısıtlama sadece OPNsense için geçerlidir.

1RADIUS Sunucu Tanımlama

Öncelikle Captivo RADIUS sunucusunu OPNsense'e tanımlayın:

  1. System → Access → Servers menüsüne gidin
  2. Add butonuna tıklayın
AlanDeğer
Descriptive nameCaptivo RADIUS
TypeRADIUS
Hostname or IPCaptivo RADIUS sunucu adresi
Shared secretCaptivo'dan kopyalayın
Authentication port1812
Accounting port1813
Captivo panelinde canlı oturumları görmek için zone üzerinde RADIUS accounting'i etkinleştirin (aynı sunucu, 1813 portu). Yalnızca kimlik doğrulama, kimliği kaydeder ama aktif oturum istatistiklerini üretmez.

2Captive Portal Zone Oluşturma

  1. Services → Captive Portal → Administration menüsüne gidin
  2. + butonuna tıklayarak yeni zone ekleyin
AyarDeğer
EnabledChecked
InterfacesGuest veya WiFi arayüzünüz
Authenticate usingCaptivo RADIUS (oluşturduğumuz)
Idle timeout15
Hard timeout480

3Template Ayarları

Captivo'da OPNsense şablonunu Ayarlar → Portal → Şablonlar sekmesinden indirin.

  1. Services → Captive Portal → Templates menüsüne gidin
  2. + butonuna tıklayarak yeni template ekleyin
  3. Captivo'dan indirdiğiniz dosyayı olduğu gibi yükleyin — zaten tam bir ZIP'tir
OPNsense indirmesi doğrudan yüklemeye hazır bir ZIP'tir; içinde index.html ile birlikte CSS ve varlıkları bulunur. Dosyayı açmayın veya yalnızca HTML'i yeniden zip'lemeyin — bu şablonu bozar. (Not: OPNsense tek ZIP kullanır; pfSense ise iki ayrı HTML dosyası.)

4Template'i Zone'a Bağlama

  1. Services → Captive Portal → Zones'a geri dönün
  2. Oluşturduğumuz zone'u düzenleyin
  3. Template alanında yüklediğiniz template'i seçin
  4. Save ve Apply

5Allowed Hosts

  1. Services → Captive Portal → Allowed Hostnames'e gidin
  2. Captivo sunucu domain'ini ekleyin
Bu adım misafirlerin doğrulama öncesinde Captivo sunucusuna erişebilmesini sağlar.

Sorun Giderme

Template yüklenmiyor
  • ZIP dosyasının içerisinde index.html olduğunu kontrol edin
  • ZIP dosyası 1MB'dan küçük olmalı
  • Dosya adında özel karakter kullanmayın
RADIUS bağlantısı kurulamıyor
  • Shared secret'i kontrol edin
  • Firewall'da 1812 ve 1813 portlarının açık olduğunu doğrulayın
  • OPNsense'den RADIUS sunucusuna ping atın

Ürün geneli sorunlar için: Portal açılmıyor · Giriş reddediliyor · Oturumlar görünmüyor

Bu yazı yardımcı oldu mu?