UniFi Entegrasyonu

Ubiquiti UniFi'da küçük bir yerel Connector köprüsüyle misafir WiFi — RADIUS yok, HTML yükleme yok. UniFi controller misafirleri Captivo'nun barındırdığı portala yönlendirir; misafir doğrulandıktan sonra Connector erişimi controller üzerinde açar.

UniFi, güvenlik duvarı entegrasyonlarından farklı çalışır: RADIUS yerine ağınızda küçük bir Connector aracı çalışır ve Captivo'yu UniFi controller'ınıza köprüler. Araç yalnızca dışarı doğru bağlanır — UniFi yönetici bilgileriniz ağınızda kalır, buluta gönderilmez.

Bu kurulumda oturum verisi oluşmaz. UniFi entegrasyonu misafirleri RADIUS accounting ile değil, Connector üzerinden controller'ın kendi API'siyle yetkilendirir. Oturum kaydı yazan bir mekanizma yoktur; bu yüzden Aktif Oturumlar boş kalır ve oturum tabanlı değerler (süre, veri kullanımı) üretilmez. Misafir kayıtları, girişler ve portalın kendisi normal çalışır. Canlı oturum takibi gerekiyorsa RADIUS tabanlı bir entegrasyon kullanın (pfSense, OPNsense, MikroTik, FortiGate).

Connector bir bulut (SaaS) özelliğidir. Şirket-içi (on-premise) kurulumlarda Connector'lar sayfası bulunmaz; bu rehber app.captivo.io içindir.

1Captivo'da bir Connector ekle

Ayarlar → Connector'lar → Connector Ekle'ye gidin. Bir ad verin, ürün olarak UniFi seçin ve oluşturun. Captivo tek kullanımlık bir eşleştirme kodu (15 dakika geçerli) ve eşleştirme kodu + portal adresi önceden doldurulmuş, çalıştırmaya hazır bir docker komutu gösterir.

2Connector'ı ağınızda çalıştırın

UniFi controller'ınızla AYNI ağda, Docker kurulu herhangi bir makinede paneldeki komutu çalıştırın. UNIFI_URL, UNIFI_USER, UNIFI_PASS ve UNIFI_SITE değerlerini controller'ınıza göre değiştirin (misafir yetkilendirme iznine sahip yerel bir controller hesabı kullanın). CAPTIVO_URL ve PAIR_CODE sizin için önceden doldurulur.

bash

docker run -d --name captivo-connector --restart unless-stopped \
  -v captivo-connector:/data \
  -e CAPTIVO_URL=https://app.captivo.io \
  -e PAIR_CODE=<paneldeki-kod> \
  -e UNIFI_URL=https://192.168.1.1 \
  -e UNIFI_USER=admin \
  -e UNIFI_PASS=PAROLANIZ \
  -e UNIFI_SITE=default \
  captivoio/connector:latest

Connector otomatik kaydolur ve Captivo'yu yoklamaya başlar. Birkaç saniye içinde Connector'lar sayfasında Çevrimiçi görünür. Hiçbir gelen port veya port yönlendirme gerekmez.

3UniFi misafir portalını Captivo'ya yönlendirin

UniFi Network → Ayarlar → Guest Hotspot/Portal bölümünde portalı etkinleştirin ve kimlik doğrulamayı 'External Portal Server' yapın. External Portal Server adresini barındırılan portal adresinize ayarlayın — https://app.captivo.io/p/<tenant-kısa-adınız> — bu adres Captivo eşleştirme penceresinde kopyalanabilir şekilde gösterilir.

4Ön-Yetkilendirme / Walled Garden — önemli

Aynı Guest Hotspot ayarlarında, portalın misafir giriş yapmadan önce yüklenip Captivo'ya erişebilmesi için Ön-Yetkilendirme / Walled Garden listesine *.captivo.io ekleyin.

'Portal açılıyor ama SMS gelmiyor' şikayetinin #1 sebebi budur. Portalın JavaScript'i doğrulama kodunu app.captivo.io'dan çeker; bu yüzden o domain giriş öncesi erişilebilir olmalı. SMS sağlayıcınızın domain'ini izin listesine eklemenize gerek yok — SMS'i Captivo kendi sunucularından gönderir.

5Misafir akışını test edin

Misafir WLAN'ına bir telefon bağlayın. UniFi onu markalı Captivo portalına yönlendirir; misafir SMS, voucher veya etkin diğer yöntemlerle doğrular; Captivo Connector'a sinyal verir, Connector cihazı UniFi controller üzerinde yetkilendirir — ve misafir çevrimiçi olur. Oturumlar ve kimlik kayıtları Captivo panelinde görünür.

Sorun giderme — Connector Çevrimdışı görünüyor: app.captivo.io'ya dışarı erişebildiğini ve UNIFI_URL/USER/PASS değerlerinin doğru olduğunu kontrol edin (konteyner loglarına bakın). Portal açılıyor ama SMS gelmiyor: *.captivo.io'yu walled garden'a ekleyin (adım 4). Misafir doğruluyor ama çevrimdışı kalıyor: Connector'ın Çevrimiçi olduğunu ve controller hesabının misafir yetkilendirebildiğini doğrulayın.

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