Skip to main content

Kurulum — Standard Edge (N100)

Bu rehber AnchorSpot Edge (N100) cihazının kurulumunu kapsar. Misafir yönlendirmesi ve erişim kontrolü N100 cihazında yapılır; giriş sayfası SiperOne bulutundan sunulur. İnternet kesilirse yetkilendirilmiş misafirler oturum süreleri dolana kadar bağlı kalır; yeni misafir girişi için bulut bağlantısı gerekir.

:::info Kurulum Desteği AnchorSpot Edge cihazının kurulumu ve yapılandırması satış/operatör ekibimizle birlikte yürütülür. Aşağıdaki adımlar bu sürecin konsoldaki karşılığını anlatır. :::

Donanım Genel Bakış​

BileşenDetay
İşlemciIntel N100
Bellek8 GB
DepolamaSSD
Ağ Arayüzleri2 × Gigabit Ethernet (WAN + LAN)
Fabrika İmajıDebian tabanlı; salt okunur kök dosya sistemi (dm-verity), LUKS2 şifreli veri bölümü, TPM 2.0, RAUC A/B güncelleme

:::info N100'ün Görevi N100 misafir ağının ağ geçididir: misafirlere IP adresi dağıtır (DHCP), giriş yapmamış cihazların HTTP isteklerini SiperOne giriş sayfasına yönlendirir, yetkilendirilen cihazlara internet erişimi açar ve 5651 bağlantı kaydını cihaz üzerinde oluşturur. :::

Fabrika İmajının Güvenlik Özellikleri​

Aşağıdaki özellikler SiperOne fabrika imajına aittir.

dm-verity — Salt Okunur Kök Dosya Sistemi​

Kök dosya sistemi salt okunurdur ve dm-verity ile korunur. Açılış sonrası öz-test dm-verity durumunu da denetler; bozulma tespit edilirse öz-test başarısız sayılır.

LUKS2 ve TPM 2.0 — Şifreli Veri Bölümü​

Cihazda yazılan veriler LUKS2 ile şifrelenmiş veri bölümünde saklanır. Bölümün anahtarı cihazın TPM 2.0 çipine (Secure Boot durumuna, PCR 7) bağlıdır ve cihaz açılışta bölümü otomatik açar. Secure Boot durumu değişirse otomatik açılış çalışmaz.

RAUC A/B Güncellemeleri​

Cihazda iki sistem bölümü (A ve B) bulunur. Güncelleme paketi imzaları doğrulandıktan sonra pasif bölüme yazılır; imzası doğrulanamayan paket kurulmaz. Yeni bölümle açılış sonrası öz-test başarısız olursa bir sonraki açılışta önceki bölüme dönülür.

Bölüm A (aktif) → imzalar doğrulanır → güncelleme B'ye yazılır → B ile açılış
                                                                    |
                                       Öz-test başarısız → A bölümüne geri dönüş

Adım 1: Fiziksel Kurulum​

  1. N100 cihazını uygun konuma yerleştirin (teknik oda, lobi dolabı veya rack).
  2. ETH0 (WAN) portuna modem veya WAN switch kablosunu takın.
  3. ETH1 (LAN) portuna misafir ağının switch'ini veya AP'sini bağlayın.
  4. Güç adaptörünü bağlayıp cihazı açın.

:::warning Access Point'ler Misafir ağında IP adreslerini N100 dağıtır (DHCP). Access point'lerinizin kendi DHCP sunucusunu kapatın ve AP'leri köprü (bridge) modunda çalıştırın. :::

Adım 2: Bootstrap Token Oluşturun​

  1. https://cloud.siperone.com adresinde hesabınıza giriş yapın.
  2. Hotspot Cihazları → Bootstrap Token'ları sayfasında + Yeni Token Oluştur'a tıklayın.
  3. Etiket (örn. lobi-edge-1) ve Geçerlilik süresi (gün) alanlarını doldurun. Varsayılan süre 30 gündür; en fazla 90 gün seçilebilir.
  4. Gösterilen manifest JSON'unu Manifest JSON Kopyala ile kaydedin. Token yalnız bu ekranda gösterilir; sayfa kapatılınca kaybolur.

Token tek kullanımlıktır; kullanılan token kayıt amacıyla listede kalır.

Adım 3: Manifesti Cihaza Aktarın​

Manifest dosyasını cihaza /etc/nac/bootstrap.json olarak yerleştirin (örn. USB ile). Cihaz açılışta bu dosyayı bulursa ilk kayıt servisini çalıştırır ve kendini buluta kaydeder.

Adım 4: Otomatik Kayıt​

Token doğrulandıktan sonra cihaz otomatik olarak:

  1. SiperOne'dan mTLS istemci sertifikasını alır.
  2. Yapılandırma paketini buluttan çeker.
  3. Misafir yönlendirme ve erişim kurallarını (nftables) uygular.
  4. 60 saniyede bir buluta durum bildirir.

Adım 5: Cihaz Durumunu Doğrulayın​

Konsolda Hotspot Cihazları → Edge Cihazları sayfasını açın ve cihazınızın Online göründüğünü, yapılandırma sapması (Config drift) olmadığını doğrulayın.

Ardından bir test cihazını Wi-Fi'a bağlayın ve bir HTTP adresi açın (örn. http://example.com): istek N100 tarafından SiperOne giriş sayfasına yönlendirilmelidir.

Adım 6: Kimlik Doğrulama, Marka ve Politikalar​

Tüm yapılandırma bulut konsolundan yapılır; cihaz değişiklikleri yaklaşık bir dakika içinde alır.

  • Captive Portal → Misafir Auth Metotları: kimlik doğrulama yöntemleri (SMS, WhatsApp, e-posta, sponsor onayı, kupon, AD/LDAP, SSO, SAML; isteğe bağlı TC Kimlik No alanı)
  • Captive Portal → Marka & Tema: portal düzeni, renkler, logo, başlık ve banner görselleri
  • Captive Portal → Hukuki Dokümanlar: aydınlatma metni, kullanım koşulları ve açık rıza metinleri
  • Captive Portal → Ön İzinli Adresler: misafirin giriş yapmadan erişebileceği adresler

:::info İnternet Kesintisinde İnternet kesilirse yetkilendirilmiş misafirler oturum süreleri dolana kadar bağlı kalır; yeni misafir girişi için bulut bağlantısı gerekir. :::

OTA Güncellemeleri​

Güncelleme sürümleri SiperOne tarafından yayınlanır. Fabrika imajında bir güncelleme şu akışla uygulanır:

Güncelleme Akışı​

1. Güncelleme paketi indirilir ve SHA-256 özeti doğrulanır
2. cosign imzası doğrulanır
3. RAUC, kendi imzasını da doğrulayarak paketi pasif bölüme (B) yazar
4. Cihaz yeniden başlar ve B bölümüyle açılır
5. Öz-test başarılıysa B bölümü kalıcı olarak işaretlenir
6. Öz-test başarısızsa bir sonraki açılışta A bölümüne dönülür

Sorun Giderme​

Cihaz Kaydolmuyor​

Belirti: Cihaz Edge Cihazları listesinde görünmüyor veya çevrimiçi olmuyor.

  1. WAN kablosu ETH0 portuna takılı mı?
  2. Manifest doğru yerde mi? Dosya cihazda /etc/nac/bootstrap.json olarak bulunmalıdır.
  3. Token geçerli mi? Token tek kullanımlıktır ve süresi dolmamış olmalıdır; gerekirse Bootstrap Token'ları sayfasından yeni bir token oluşturun.
  4. DNS çalışıyor mu? Manifest dosyasındaki bulut adresi (cloud_url) çözümlenebilmelidir.
  5. Güvenlik duvarı: Cihaz buluta DNS (53), NTP (123/udp) ve HTTPS (443) üzerinden bağlanır; ağınızda bu çıkışların açık olduğundan emin olun.

Cihaz Açılmıyor​

Belirti: Cihaz açılmıyor veya sürekli yeniden başlıyor.

Cihazı kapatın, güç adaptörünü çıkartın, 30 saniye bekleyin ve tekrar açın. Sorun devam ederse SiperOne destek ekibine başvurun — disk imajı USB üzerinden yeniden yazılabilir.

Misafirler Doğrulandıktan Sonra İnternete Çıkamıyor​

Belirti: Misafirler kimlik doğruladıktan sonra internete erişemiyor.

Hotspot Cihazları → Edge Cihazları sayfasında cihazın Online olduğunu kontrol edin; misafirin yetkisini Captive Portal → Misafir Yetkileri sayfasında görebilirsiniz. Sorun devam ederse SiperOne destek ekibine başvurun.

Sonraki Adım​