AS216394 · WireShield

Dokümantasyon

Kurulum, bağlantı ve günlük operasyon rehberleri.

Portal sunucusu kurulumu (`wsportal`)

MSSP paneli ve müşteri portalı, internete açık ayrı bir sunucuda çalışan wsportal üzerinden sunulur. wsportal ince bir ters vekildir: genel HTTPS bağlantısını karşılar, istekleri süzer ve sınırlar, cihaza iletir.

  • Parolalar, oturumlar, 2FA, yetkiler, müşteri verisi ve denetim kaydı cihazda kalır. Portal sunucusunda veritabanı ve kullanıcı deposu yoktur; yalnız kendi istemci sertifikası ve genel HTTPS sertifikası bulunur.
  • Yönetici (admin) paneli portal üzerinden hiçbir zaman açılmaz. admin rolü portal bağlantılarından giriş yapamaz.
  • Portal sunucusu ile cihaz birbirini sertifika parmak izi sabitlemeli karşılıklı TLS (mTLS) ile doğrular. Cihazın portal portlarına yalnız portal sunucusunun IP adreslerinden bağlanılabilir.
  • Portal sunucusu çökerse yalnız MSSP/müşteri erişimi kesilir; koruma ve yönetici paneli etkilenmez.
İnternet ─ 443  ─┐                       ┌─ 9444 (müşteri portalı)  mTLS
İnternet ─ 8443 ─┴─ PORTAL SUNUCUSU ─────┤
                    (wsportal)           └─ 9445 (MSSP paneli)      yalnız portal sunucusunun IP'sinden
                                            CİHAZ (wsd)

Portal sunucusu gerekli mi? İsteğe bağlıdır.

  • Kendi ağınız (self-hosted): yalnız kendi ağınızı koruyorsanız gerekmez. Ekibiniz cihazın yönetim adresindeki panele admin, operatör ya da izleyici hesabıyla girer (operatör ve izleyici MSSP görünümünü görür). Yönetim adresi yalnız izinli yönetim ağlarından erişilebilir kalır.
  • Hizmet sağlayıcı (MSSP): müşterileriniz ya da NOC ekibiniz panellere internetten erişecekse kurun. Böylece cihazın yönetim adresi kapalı kalır; operatörler isterlerse ofisten yönetim adresine de girebilir.

2.1 Gereksinimler

  • Debian 13 sunucu (2 vCPU, 2–4 GB RAM yeterlidir), systemd.
  • Genel bir IP adresi ve isteğe bağlı DNS adları (ör. portal.example.com, mssp.example.com).
  • Portal sunucusundan cihazın yönetim adresine TCP 9444 (müşteri) ve 9445 (MSSP) erişimi.
  • Let's Encrypt kullanılacaksa: DNS adlarının bu sunucuyu göstermesi ve 80. portun internetten erişilebilmesi.
  • Paket: wsportal-<sürüm>-linux-amd64.tar.gz (cihaz sürümüyle aynı sürüm).

2.2 Paketin kurulması

tar xzf wsportal-<sürüm>-linux-amd64.tar.gz
cd wsportal-<sürüm>-linux-amd64
sudo ./install.sh

install.sh şunları yapar:

  1. Servis kullanıcısını, dizinleri ve systemd birimini kurar.
  2. İsteğe bağlı ana makine güvenlik duvarını kurar: 80/443/8443 internete açık, SSH yalnız yönetim ağınızdan, geri kalan her şey kapalı.
  3. Management network(s) allowed to SSH sorusuna SSH ile bağlandığınız adresi de içeren ağları yazın.
  4. Cloudflare proxy (turuncu bulut) kullanacaksanız ilgili soruya yes deyin; 443/8443 yalnız Cloudflare aralıklarına açılır, 80 kapalı kalır.
  5. Kurallar uygulandıktan sonra 60 saniye içinde yeni bir SSH oturumu açabildiğinizi onaylayın; onaylamazsanız kurallar kendiliğinden kaldırılır.
  6. wsportal setup sihirbazını başlatır.

Portal sunucusu terminali — install.sh güvenlik duvarı soruları ve 60 sn onay

Portal sunucusu terminali — install.sh güvenlik duvarı soruları ve 60 sn onay

2.3 wsportal setup ve cihazla eşleştirme

Sihirbaz beş adımdan oluşur.

1/5 Appliance connection

  • Appliance address (IP the portal server connects to): cihazın yönetim adresi (ör. 192.0.2.10).
  • Customer portal port on the appliance (0 = none): varsayılan 9444.
  • MSSP panel port on the appliance (0 = none): varsayılan 9445.

2/5 Public names

  • Public DNS name of this server (e.g. portal.example.com; empty = IP address only)
  • Public DNS name of the MSSP panel (varsayılan: aynı ad)

3/5 Pair with the appliance Sihirbaz bu sunucunun istemci sertifikası parmak izini gösterir. Şimdi cihazın yönetici panelinde:

  1. Ağ Ayarları → Portal ve Çoklu POP (Network Settings → Portal & Multi-PoP) sekmesini açın.
  2. Portal sunucusu (Portal server) kartında doldurun:
  3. Müşteri portalı portu (0 = kapalı): 9444
  4. MSSP paneli portu (0 = kapalı): 9445
  5. Portal sunucusu IP adresleri (satır başına bir): portal sunucusunun IP adresi (ör. 198.51.100.20)
  6. Portal istemci sertifikası parmak izleri (satır başına bir; 'wsportal setup' çıktısından): sihirbazın gösterdiği SHA256:… değeri
  7. Kaydet'e basın. Dinleyiciler cihaz yeniden başlatılmadan açılır; güvenlik duvarı izni kendiliğinden eklenir.
  8. Aynı karttaki Bu cihazın sertifika parmak izi (This appliance's certificate fingerprint) değerini Kopyala ile alın ve sihirbazdaki Appliance certificate fingerprint (from the panel) sorusuna yapıştırın.

Sihirbaz gerçek bir mTLS bağlantısıyla iki yönü de doğrular ve OK (the appliance accepted this server and its certificate matches) yazar. Hata olursa nedenini açıklar (port kapalı, parmak izi uyuşmuyor, istemci reddedildi).

Ağ Ayarları → Portal ve Çoklu POP → Portal sunucusu kartı — portlar, IP adresleri, istemci parmak izi, cihaz parmak izi ve Kopyala düğmesi

Ağ Ayarları → Portal ve Çoklu POP → Portal sunucusu kartı — portlar, IP adresleri, istemci parmak izi, cihaz parmak izi ve Kopyala düğmesi 4/5 HTTPS sertifikası

  • Get a free Let's Encrypt certificate for … ? sorusuna yes derseniz sertifika alınır ve bitişine 30 gün kala kendiliğinden yenilenir. E-mail for certificate expiry notices (optional) sorulur.
  • no derseniz kendinden imzalı sertifika kullanılır (tarayıcı uyarı verir); sonradan wsportal cert ile değiştirebilirsiniz (2.5).

5/5 Yapılandırma /etc/wsportal altına yazılır ve servis etkinleştirilip başlatılır.

Ayarları değiştirmek için sudo wsportal setup komutunu istediğiniz zaman yeniden çalıştırabilirsiniz. Etkileşimsiz kullanım için bayraklar: -appliance, -customer-port, -mssp-port, -portal-name, -mssp-name, -appliance-fp, -letsencrypt / -no-letsencrypt, -cloudflare / -no-cloudflare, -email, -yes.

2.4 Adresler

  • Müşteri portalı: https://<ad>/
  • MSSP paneli: https://<ad>:8443/ (yalnız MSSP paneli sunuluyorsa :443)

operator ve viewer rolündeki kullanıcılar MSSP paneline, tenant rolündeki kullanıcılar müşteri portalına girer.

Müşteri portalı giriş ekranı ("Welcome to the WireShield Customer Portal.")

Müşteri portalı giriş ekranı ("Welcome to the WireShield Customer Portal.")

2.5 Sertifika komutları

İşKomut
Sertifikayı gösterwsportal cert status
Let's Encryptwsportal cert letsencrypt -domain portal.example.com[,mssp.example.com] [-email you@example.com]
Kendi sertifikanızwsportal cert install -cert chain.pem -key key.pem (ya da -pfx dosya.pfx -password …)
Kendinden imzalıya dönwsportal cert self-signed

Çalışan servis değişikliği kendiliğinden alır (gerekirse systemctl reload wsportal).

2.6 Cloudflare proxy arkasında çalışma

Portal sunucusunun adresini gizlemek ve önüne Cloudflare korumasını koymak için:

  1. install.sh içinde Cloudflare sorusuna yes deyin (443/8443 yalnız Cloudflare aralıklarından; aralıklar wsportal cloudflare-ips ile görülür).
  2. wsportal setup içinde Do … use the Cloudflare proxy (orange cloud)? sorusuna yes deyin (ya da -cloudflare). Servis ziyaretçi adresini yalnız Cloudflare'den gelen bağlantılarda CF-Connecting-IP başlığından alır; doğrudan gelen istekleri 403 ile reddeder. Hız sınırları, giriş kilitleri ve denetim kaydı gerçek ziyaretçi adresini kullanır.
  3. Cloudflare'de SSL/TLS kipini Full (strict) yapın, adlar için bir Origin Certificate oluşturun ve kurun: wsportal cert install -cert origin.pem -key origin-key.pem.
  4. Cloudflare aralıklarını değiştirmek gerekirse /etc/wsportal/cloudflare-ips dosyasına satır başına bir CIDR yazıp systemctl restart wsportal çalıştırın (güvenlik duvarını da güncelleyin).

2.7 Yükseltme

Yeni paketi açın ve sudo ./install.sh çalıştırın. Yalnız ikili dosya değişir, servis yeniden başlar, yapılandırma korunur. Portal sunucusunu cihazlarla aynı sürüme yükseltin.

2.8 İşletim

DurumYapılacak
Cihaz sertifikası değiştiYeni parmak izini /etc/wsportal/appliance-pins dosyasına ekleyin (çalışana kadar eskisini silmeyin), systemctl reload wsportal.
Portal sunucusu ele geçirildiCihaz panelinde Portal sunucusu kartından parmak izini silin ve Kaydet; erişim ve açık bağlantılar hemen kesilir. Ya da Kapat (Disable) ile portal bağlantısını tamamen kapatın.
Günlüklerjournalctl -u wsportal (yöntem/yol/durum/istemci; parolalar, çerezler ve CSRF token'ları asla yazılmaz).
502 hatalarıCihaza ulaşılamıyor ya da parmak izi uyuşmuyor (günlüğe bakın).

Not: Cihazın web sertifikasını değiştirmek (Bölüm 5) portal bağlantısını etkilemez; portal sunucusu cihazın değişmeyen iç sertifikasını sabitler.

Bu rehberle ilgili sorunuz mu var?
Teknik ekibe sorun