Ağ ön koşulları

Sanal makine var olmadan önce ağ ekibinin karara bağlaması gerekenler: cihaza hangi portlar ulaşacak, kurduğunuz kipte cihaz dışarıya neye erişecek ve kurumsal bir vekil sunucunun arkasında nasıl davranacak. Bunu önce çözün — engellenmiş bir yol, bir ISO kurulumunun yarıda durmasının açık ara en yaygın nedenidir.

Dış erişim tablosunu kendi dağıtım kipiniz için okuyun. Tablolar birikimli değildir ve kipin gerektirdiğinden fazlasını açmak, bir güvenlik duvarı değişikliğinin iki kez savunulmak zorunda kalmasının olağan nedenidir.

Gelen — cihaza ulaşması gerekenler

80 ve 443 üzerinde hangi sürecin yanıt verdiği cihazın nasıl teslim edildiğine bağlıdır: kaynak ve üretim compose dosyaları oraya bir Caddy ters vekili koyar; ISO'dan kurulmuş bir cihazın önünde ise compose projesinin dışında ayrı bir nginx kapsayıcısı bulunur. Portlar ve amaçları her iki durumda da aynıdır.

Bu tabloyu iki kural yönetir.

• Standart bir dağıtımda yalnızca 80 ve 443 açıktır. Diğer her şey ya geri döngü adresine bağlıdır ya da kapalıdır. ICAP dinleyicisi, varsayılanı 127.0.0.1 olan ICAP_PUBLISH ile adlandırılan arayüzde yayımlanır; onu yerel ağdaki bir ağ geçidine açmak bilinçli bir değişikliktir ve port o zaman ağ geçidinin adresine göre güvenlik duvarıyla sınırlandırılmalıdır.

• Satır içi vekil, ana makinenin ağ ad alanına bağlanır. İstemci adreslerinin kendileri olarak gelebilmesi için ana makine ağıyla çalışır; bu da ana makinede zaten kullanımda olan bir portun hata olarak bildirilmemesi anlamına gelir — kapsayıcı yine çalışıyor görünür. Portları ilk açılıştan önce gözden geçirin:

  ss -ltn '( sport = :80 or sport = :443 or sport = :1344 or sport = :3000 or sport = :8443 )'

  Burada bulunan bir çakışma, ilk açılıştan önce cihazın ortam dosyasına yazılan bir satırdır. Daha sonra bulunduğunda ise bir port değişikliği, yeniden üretilmiş bir vekil otomatik yapılandırma dosyası ve o dosyanın her uç noktaya yeniden gönderilmesi demektir.

Her kapsayıcının compose profilini ve beyan edilen bellek sınırını içeren servis bazlı tam tablo servisler, portlar ve profiller sayfasında üretilir. Bu portları değiştiren değişkenler — ICAP_PORT, ICAP_PUBLISH, ICAP_BIND, INLINE_PROXY_HTTPS_PORT, INLINE_PROXY_TPROXY_PORT, INLINE_PROXY_PUBLIC_PORT, USERID_AGENT_PORT — ortam değişkenleri sayfasındadır.

Dış erişim — her dağıtımda

Bu dördü, hava boşluklu olanlar dahil hangi kipi çalıştırırsanız çalıştırın geçerlidir; hava boşluklu kurulumda son ikisi kurum içidir, ilk ikisi ise hiç yoktur.

Lisanslama için dış erişim yoktur. Lisans, cihazın kurulum kimliğine bağlı, imzalı bir dosyadır. Bir etkinleştirme isteği dışa aktarır, bir .lic alır ve onu yüklersiniz. Süre dolumu yerel saatle yapılan bir karşılaştırmadır. Cihaz, çevrimiçi ya da hava boşluklu, hiçbir zaman bir lisans sunucusuna bağlanmaz.

CID222'nin kendisi hiçbir şeyi kendi merkezine bildirmez. Ağ geçidinde, panoda ya da tespit servislerinde çalışan hiçbir analitik, hata bildirimi veya kullanım bildirimi istemcisi yoktur. Bir istisnayı anmakta yarar var: kırmızı takım simülatörü kapsayıcısı, üstünde durduğu çerçevenin kendi telemetri modülünü içerir ve cihaz bunun için bir devre dışı bırakma ayarı yapmaz. Dış erişimi olmayan bir ağda bu sorun değildir; bağlı bir ağda bu olasılık sizin için önemliyse o kapsayıcının giden erişimini engelleyin.

Dış erişim — AI Gateway kipi

Kullanıcılar ve araçlar cihazı çağırır, cihaz da modeli çağırır. Tablonun tamamı budur.

Kipi hazır ilan etmeden önce cihazın üzerinden doğrulayın:

# Reaches the provider you configured. A 401 or 403 is a pass — it proves the path.
curl -sS -o /dev/null -w '%{http_code}\n' https://api.openai.com/v1/models
# A LAN model instead:
curl -sS -o /dev/null -w '%{http_code}\n' http://<model-host>:<port>/v1/models

Zaman aşımı, bir 000 ya da bir vekil hatası başarısızlıktır. 200 yanıtı veren bir engelleme sayfası ise başarı gibi görünen başarısızlıktır — inanmadan önce gövdeyi okuyun.

Dış erişim — güvenli web ağ geçidinin yanında satır içi denetim

Ağ geçidi cihaza doğru bağlanır; cihaz yeni hiçbir yere bağlanmaz. Güvenlik duvarı değişikliği en küçük olan ve uç noktalarda hiç iş çıkarmayan kip budur.

Burada saatler portlardan daha önemlidir: cihazı ve ağ geçidini aynı zaman kaynağına göre eşitleyin; aksi hâlde denetim olayları ile ağ geçidinin erişim günlüğü sonradan ilişkilendirilemez.

# On the appliance, and again on the gateway — the two must agree.
timedatectl status
# From the gateway's own shell, prove it can open the listener:
timeout 5 bash -c '</dev/tcp/<appliance-ip>/1344' && echo "1344 open" || echo "1344 blocked"

Dış erişim — cihazın kendi satır içi vekili

Burada tarayıcı trafiğini yeniden imzalayan şey cihazdır; dolayısıyla tarayıcıların eriştiği her siteye erişmesi gerekir.

# From the appliance. A 403 is a pass — anti-bot, not a blocked path.
curl -sS -o /dev/null -w '%{http_code}\n' https://chat.openai.com/ https://claude.ai/
# And confirm the names resolve to real addresses rather than a block page:
dig +short chat.openai.com claude.ai

Dış erişim — uç nokta ajanları ve tarayıcı eklentisi

İkisi de cihaz adına internete erişmez. İkisi de cihazla 443 üzerinden konuşur; dolayısıyla bu kip dış erişim değil, istemci filonuzdan gelen erişilebilirlik ekler. Cihazın dış dinamik listesini çeken bir güvenlik duvarı da aynı şeyi yapar: cihazdan çeker.

Dış erişim — dizin, SIEM ve diğer entegrasyonlar

Bunların hiçbiri ağınızın dışına çıkmaz. Hiç interneti olmayan bir cihaz da bir etki alanı denetleyicisine bağlanır ve bir toplayıcıya aktarım yapar.

Kurumsal vekil sunucu

Saha vekili her yolda desteklenir; ancak cihazın onu çıkarımla bulması beklenmez, kendisine verilmesi gerekir.

• Kurulum sihirbazı sırasında. Connectivity (bağlantı) adımı bir HTTPS vekil URL'si alır ve kalıcı olarak saklar; Finish (bitir) seçildiğinde uygulanır.
• ISO hazırlığı sırasında. Kurulum programına verilen bir vekil, ilk imaj indirilmeden önce Docker'ın kendi yapılandırmasına kopyalanır; çünkü Docker ne paket yöneticisinin yapılandırmasını ne de kabuk ortamını okur. Tümüyle gözetimsiz açılış girdisi hiç vekil sormaz; bu nedenle yalnızca vekil üzerinden çıkışa izin veren bir segmentte hazırlık durur ve yeniden başlatmadan önce vekili konsoldan siz ayarlarsınız.
• Sonrasında. Aynı değerler cihazın ortamında HTTP_PROXY, HTTPS_PROXY ve NO_PROXY olarak yaşar; ortam değişkenleri sayfasında belgelenmiştir.

Vekil üzerinden geçmemesi gereken her hedefi, sihirbazı bitirmeden önce NO_PROXY içine koyun: yerel ağdaki model uç noktanız, etki alanı denetleyicileriniz ve SIEM toplayıcınız. İnternet vekili üzerinden yönlendirilen bir yerel ağ uç noktası, ölü bir kimlik bilgisi gibi okunan biçimde başarısız olur.

# From the appliance, with the proxy in force. Both should answer.
https_proxy=<proxy-url> curl -sS -o /dev/null -w '%{http_code}\n' https://api.cid222.live/v2/
curl -sS -o /dev/null -w '%{http_code}\n' http://<model-host>:<port>/v1/models

Yol açıkken ilki 401 döndürür — erişilebilir ve kimlik bilgisi istiyor. Zaman aşımı ise engellenmiş bir yoldur.

TLS denetleyen vekil

Giden HTTPS'i kendi otoritesiyle yeniden imzalayan bir vekil çalışır ve sıradan vekilin istemediği tek bir şeyi ister: cihazın, dışarıya bağlantı açan her iki yerde de o otoriteye güvenmesi gerekir.

Hangi aşamada olduğunuza göre iki kurulum yeri:

• Kurulumdan önce. Sahanız için üretilen kurulum ortamı sertifikayı taşıyabilir; kurulum programı onu kayıt defterine bağlanmadan önce 0/8 aşamasında kurar. Aksi hâlde sertifikayı makinede /usr/local/share/ca-certificates içine koyun, update-ca-certificates çalıştırın ve yeniden başlatın.
• Kurulumdan sonra. Ayarlar → Sertifikalar seçin, vekilin düzenleyici CA'sını Outbound trust (TLS-inspecting networks) (giden güven — TLS denetleyen ağlar) altına yapıştırın ve Trust this CA for outbound connections (bu CA'ya giden bağlantılar için güven) seçeneğini işaretleyin. Ana makine onu, ağ geçidinin ve güncelleyicinin kullandığı güven depolarına ekler. Bu yalnızca giden yöndür ve cihazın 443 üzerinde sunduğu şeyi değiştirmez.

# Proves trust, not just reachability: a TLS error here is the missing CA.
curl -sS -o /dev/null -w '%{http_code}\n' https://api.cid222.live/v2/

Ad çözümlemesi

Cihaz, ağın kendisine verdiği çözümleyicileri kullanır. DNS'in çalışıp çalışmadığı tartışılmadan önce belirtmeye değer iki sonuç vardır.

• Kurulum programı kendi çözümlemesini belirli sınırlar içinde onarır. Çözümleyiciniz kayıt defteri için yanıt veremiyorsa, kurulum programı yalnızca o alan adını genel çözümleyicilere yönlendirir ve değişikliği kalıcı kılar. Bunlar da engelliyse, ortamın derlendiği adrese geri düşer ve bu sabitlemenin işe yaramadığı ortaya çıkarsa onu kaldırır.
• Bir tarayıcının DNS'in çalıştığını göstermesi, cihaz hakkında hiçbir şey kanıtlamaz. Tarayıcılar DNS-over-HTTPS ile çözümleme yapar ve sıradan DNS'i bozuk bir ağda çalışmayı sürdürür.

Zaman

Cihazın saatinin doğru olması üç bağımsız nedenle gereklidir: TLS henüz geçerli olmayan bir sertifikayı reddeder; lisans süresi, düzeltecek bir ağ zaman kaynağı olmadan yerel saatle karşılaştırılır; ve bir denetim kurulumu olaylarını üçüncü taraf bir ağ geçidinin günlükleriyle ilişkilendirir.

ISO'dan kurulmuş bir cihazda ilk açılış geçişi, kayıt defterine bağlanmadan önce sistemin zaman eşitleme servisini yeniden başlatır ve yakınsaması için 20 saniyeye kadar bekler; yakınsamazsa durmak yerine uyarır.

Yolun gerçekten açık olduğunu kanıtlamak

"Bu ağın tam internet erişimi var" cümlesi genellikle iyi niyetle söylenir ve genellikle cihazın kullandığından başka bir yolla ilgilidir. Aşağıdakilerin her biri, kurulum hâlâ başarısız olurken rutin biçimde geçer; bu nedenle kurulum programının ihtiyaç duyduğu şeyi tam olarak, cihazın üzerinde test edin:

1. Bir tarayıcının kayıt defterine erişmesi az şey kanıtlar. Tarayıcılar adları DNS-over-HTTPS ile çözer; bu yüzden sıradan DNS'i bozuk bir ağda çalışmayı sürdürürler — ve tarayıcı genellikle cihazdan başka bir makinededir.
2. Başarılı bir ping az şey kanıtlar. ICMP'yi sınar. İmaj indirmeleri 443 portu üzerinden TCP'dir ve ICMP'ye izin verip 443'ü engelleyen bir güvenlik duvarı sıradan bir yapılandırmadır.
3. Çalışan bir paket kurulumu az şey kanıtlar. Ubuntu yansıları 80 portu üzerinden sunulur; bu yüzden giden 443'ü tümüyle engelleyen bir ağda paket kurulumları başarılı olur.

Bunu gerçekten kanıtlayan üç test, sırasıyla ad çözümlemesini, TCP yolunu ve kimlik doğrulamalı indirmeyi ayrı ayrı ele alır. Bunları cihaz konsolundan çalıştırın:

# 1. Name resolution, from the appliance's own resolver
nslookup <registry-host>
 
# 2. The TCP path on 443, without DNS in the way
timeout 5 bash -c '</dev/tcp/<registry-ip>/443' && echo "443 open" || echo "443 blocked"
 
# 3. The authenticated pull path, end to end
sudo bash -c 'set -a; . /opt/cid/.env; set +a; printf "%s" "$REGISTRY_PULL_PASSWORD" \
  | docker login "$REGISTRY_PULL_HOST" -u "$REGISTRY_PULL_USER" --password-stdin'

Bunlar birbirinin yerine geçmez; çünkü her biri geçerken bir sonraki başarısız olabilir: çözümleme, engelleme sayfasıyla yanıt veren bir çözümleyiciye karşı başarılı olabilir; TCP yolu, kendi sertifikasını sunan TLS denetleyici bir cihaza açılabilir; oturum açma ise ortamın taşıdığı ama kayıt defterinin artık kabul etmediği kimlik bilgileri yüzünden yine reddedilebilir.

Hava boşluklu çalışma

İnternet erişimi olmayan bir cihaz, kısıtlanmış değil, desteklenen bir dağıtımdır.

• Kurulum — hava boşluklu kurulum ISO'sunu veya OVA'yı kullanın. İkisi de sürüm imajlarını taşır ve hiçbir şey indirmez.
• Kurulum sihirbazı — ilk açılış sihirbazı hiç ağ gerektirmez.
• Tespit — her tespit modeli derleme sırasında kendi imajına gömülür. PII, zararlı içerik, jailbreak ve enjeksiyon tespiti, dil algılama, belge ayrıştırma, maskeleme ve varsayılan OCR motorunun tümü hiç dış erişim olmadan çalışır.
• Lisanslama — etkinleştirme isteğini çıkarılabilir ortama aktarın, imzalı .lic dosyasını alın ve yükleyin. İki uçta da ağ devreye girmez.
• Güncellemeler — imzalı .cidupd paketini ağ dışından edinin ve yükleyin. Cihaz hiçbir zaman kendi başına bağlantı kurmaz.
• Sohbet — yalnızca cihazın gerçekten erişebildiği bir modele karşı çalışır; yalıtılmış bir ağda bu, kendi barındırdığınız ya da yerel ağdaki bir uç nokta demektir.

Çevrimdışıyken zayıflayan ve önceden bilinmesinde yarar olan üç şey vardır: en yüksek doğruluklu OCR motoru, kurduğunuz sürüm modelini imaja gömmediyse onu ilk kullanımda indirir; kırmızı takım simülatörünün kendine ait bir modele ihtiyacı vardır; bağlam özetleme ise OpenAI ve Anthropic bulutlarına koda gömülü adreslerden istek gönderir, bu yüzden yerel ağdaki bir modele yönlendirilemez ve yalıtılmış bir ağda başarısız olur.

İlgili sayfalar

• Kurulum yolunuzu seçin — bu tablonun izlediği dağıtım kipi.
• Gereksinimler ve boyutlandırma — ağın kendisine açıldığı ana makine.
• ISO'dan kurulum — bu dış erişim kurallarının ilk ve tek kez sınandığı yer.
• Servisler, portlar ve profiller — kapsayıcı bazlı üretilmiş port ve profil tablosu.