Skip to main content
CID222 Docs

Satır içi vekili dağıtma

CID222'nin kendi iletme vekilini açın, sertifika otoritesini dağıtın, tarayıcıları bir vekil otomatik yapılandırma dosyasıyla ona yönlendirin ve bir tespitin tetiklendiğini kanıtlayın.

  • Sürüm: 0.4
  • Özellik: icap
  • Rol: admin_user
  • Tür: görev

Model sağlayıcılarına giden tarayıcı trafiği için güvenli web ağ geçidini CID222 yapın. İletme vekili konteynerini başlatır, ürettiği sertifika otoritesini dağıtır, yönetilen tarayıcıları ona yönlendirir ve kişisel veri içeren bir istemin ağdan çıkmadan maskelendiğini ya da reddedildiğini doğrularsınız.

Neye ihtiyacım var?

Lisans
Herhangi biri
Rol
admin_user

Ön koşullar

  • Cihaz ilk açılış kurulum sihirbazını tamamladı ve panele oturum açabiliyorsunuz.
  • Cihazın ana makinesinde compose komutlarını siz ya da işletmeciniz çalıştırabiliyor.
  • Müşterinin kendine ait bir güvenli web ağ geçidi yok — varsa onun yerine onu bağlayın, bkz. ICAP ve üçüncü taraf ağ geçitleri.
  • Uç noktalar merkezî olarak yönetiliyor; yani bir sertifika otoritesi ve bir vekil ayarı bunlara gönderilebiliyor.
  • Cihazdaki TCP 8443, istemci alt ağlarından erişilebilir ve cihazın ana makinesinde boş.
  • Cihaz genelindeki denetim politikasını kaydetmek superadmin hesabını gerektirir.

Vekil, oturumun şifresini ilk başlangıçta ürettiği bir sertifika otoritesiyle çözer. Trafiğini yakaladığı her istemcinin o otoriteye güvenmesi gerekir; aksi hâlde tarayıcı bağlantıyı bir sertifika hatasıyla reddeder. Otoriteyi dağıtmak isteğe bağlı bir sıkılaştırma adımı değildir; dağıtımın kendisidir.

Warning

Belirli bir ana bilgisayar adını yalnızca tek bir noktada denetleyin. Müşteri aynı ana bilgisayar adlarını CID222'ye gönderen bir ağ geçidi de çalıştırıyorsa, bunu açmadan önce onu kapatın — iki kez denetlenen bir görsel yüklemesi reddedilir.

Vekili başlatın ve sertifika otoritesini yayımlayın

inline-proxy profilini başlatın

Cihazın ana makinesinde tercihe bağlı profili başlatın:

docker compose --profile inline-proxy up -d cid-inline-proxy

Konteyner başlar ve ilk günlük satırları sertifika otoritesini ve dinleme kiplerini bildirir:

[cid-inline-proxy] CA generated at /root/.mitmproxy/mitmproxy-ca-cert.pem
[cid-inline-proxy] HTTPS explicit proxy: regular/direct (listen :8443)
[cid-inline-proxy] starting mitmdump regular@8443 + transparent@8084

Otorite bir kez üretilir ve bir birimde saklanır; bu yüzden yeniden başlatma onu yeniden kullanır ve bunun yerine reusing existing CA bildirir.

Cihazın onu gördüğünü doğrulayın

Tespit ve Filtreleme → Tarayıcı Denetimi ekranını seçin ve Root CA certificate & PAC (kök CA sertifikası ve PAC) panelini okuyun.

Panel, otoritenin parmak izini CA fingerprint (SHA-256) (CA parmak izi) alanında gösterir. Konteyner çalışmıyorken bunun yerine Inline proxy is not running on this appliance (satır içi vekil bu cihazda çalışmıyor) yazar ve indirme düğmeleri devre dışı kalır.

Sertifika otoritesini indirin

Uç nokta yönetiminizin istediği biçimi seçin: cid222-root.crt, cid222-root.pem veya cid222-root.cer.

Dosya iner. .cer biçimi ikili DER'dir ve Windows'un beklediği budur; diğer ikisi PEM metnidir.

Parmak izini bant dışı denetleyin

Panelde gösterilen CA fingerprint (SHA-256) değerini, cihaz işletmecinizin size başka bir kanaldan verdiği parmak iziyle karşılaştırın.

Eşleşiyorlar. Eşleşmiyorlarsa durun — cihaza ait olmayan bir sertifika otoritesine her yönetilen uç noktayı güvendirmek üzeresiniz.

Sertifika otoritesini istemcilere dağıtın

Güvenilen kök olarak gönderin

Bir etki alanı denetleyicisinde, yönetilen uç noktalarınızı barındıran kuruluş birimine bağlı bir Grup İlkesi nesnesi oluşturun ya da düzenleyin ve indirdiğiniz dosyayı Computer Configuration → Policies → Windows Settings → Security Settings → Public Key Policies → Trusted Root Certification Authorities (bilgisayar yapılandırması → ilkeler → Windows ayarları → güvenlik ayarları → ortak anahtar ilkeleri → güvenilen kök sertifika otoriteleri) altından içe aktarın.

Sonraki ilke yenilemesinde otorite, her uç noktanın güvenilen kök deposunda görünür. Sınamak için bir makineyi hemen gpupdate /force ile yenileyin.

Kendi güven deposunu tutan tarayıcıları da kapsayın

Chrome, Edge ve Internet Explorer Windows kök deposunu okur. Firefox okumaz: sistem deposunu gözetmesi için security.enterprise_roots.enabled ilkesini ayarlayın.

Yapılandırılmamış bir Firefox, yakalanan her sitede sertifika uyarısı gösterir; bu adımın atlandığını böyle fark edersiniz.

Trafiği vekil üzerinden yönlendirin

Cihaz, https://<appliance-fqdn>/proxy.pac adresinde bir vekil otomatik yapılandırma betiği sunar. /wpad.dat, vekili kendiliğinden keşfeden istemciler için aynı betiği sunar. İkisi de kimlik doğrulamasızdır, çünkü bir istemci bunları henüz hiçbir kimlik bilgisi yokken alır ve ikisi de istemcide beş dakika önbelleklenir.

Betik, canlı denetim politikasından üretilir. Etkin her ana bilgisayar adı, kendisi ve alt alan adları için PROXY <appliance>:8443; DIRECT döndürür; her atlanan ana bilgisayar adı ve geri kalan her şey DIRECT döndürür. Betikteki cihaz adı, istemcinin onu almak için kullandığı ana bilgisayardır; böylece aynı URL adla da adresle de çalışır.

URL'yi yönetilen tarayıcılara Internet Settings (internet ayarları) ilke tercihiyle, User Configuration → Preferences → Control Panel Settings → Internet Settings (kullanıcı yapılandırması → tercihler → denetim masası ayarları → internet ayarları) altından gönderin: Use automatic configuration script (otomatik yapılandırma betiği kullan) seçeneğini açın ve Address (adres) alanına URL'yi yazın. Chrome ve Edge, Windows vekil ayarını izler.

Denetim politikasını ayarlayın

Politikayı açın

Tarayıcı Denetimi ekranında Policy configuration (politika yapılandırması) panelini okuyun.

Alanlar şunlardır: Enabled hostnames (etkin ana bilgisayar adları), Bypass hostnames (atlanan ana bilgisayar adları), Allowed ICAP peer IPs / CIDRs (izin verilen ICAP eş adresleri), Inspection timeout (ms) (denetim zaman aşımı), mTLS client subject DN (mTLS istemci konu DN'i), Fail closed (BLOCK) on timeout (zaman aşımında kapalı biçimde başarısız ol) ve Policy active (politika etkin).

Denetlenecek ana bilgisayar adlarını listeleyin

Enabled hostnames alanına her satıra bir ana bilgisayar adı yazın.

Kaydetmek, yerleşik varsayılan listenin yerine geçer; bu yüzden kapsanmasını istediğiniz her ana bilgisayarı taşımaya devam edin. Varsayılan liste konuşma uç noktalarıdır — chat.openai.com, chatgpt.com, claude.ai, gemini.google.com, chat.deepseek.com, chat.qwen.ai, poe.com, character.ai — ve yüklenen dosya baytlarını taşıyan ayrı ana bilgisayarlar: oaiusercontent.com, push.clients6.google.com ve a-cdn.claude.ai.

Hiçbir zaman okunmaması gerekenleri dışarıda bırakın

Bankacılık, bordro, insan kaynakları ve hukuk ana bilgisayar adlarını Bypass hostnames alanına yazın.

Atlanan bir ana bilgisayar, otomatik yapılandırma betiğinde DIRECT döndürür; yani o oturumların şifresi hiç çözülmez.

Denetim yavaşladığında ne olacağını seçin

Inspection timeout (ms) değerini ayarlayın ve Fail closed (BLOCK) on timeout seçeneğine karar verin.

Kapalı olması, hattın zamanında bitiremediği bir isteği reddeder; açık olması onu denetlenmeden iletir. Üçüncü bir seçenek ve arka planda yeniden deneme yoktur — denetim eşzamanlıdır.

Kaydedin

Policy active seçeneğini açın ve Save policy (politikayı kaydet) düğmesini seçin.

Panel Inspection policy updated (denetim politikası güncellendi) bildirir. Otomatik yapılandırma betiği yeni ana bilgisayar adlarını beş dakikalık istemci önbelleği içinde alır.

Note

Allowed ICAP peer IPs / CIDRs bu dağıtım için geçerli değildir. Bu alan, 1344 portundaki ICAP dinleyicisini arayan eşlere kapı tutar; satır içi vekil ise ağ geçidinin HTTP denetim uç noktasını cihazın kendisinden çağırır.

Gerçekte ne denetlenir

Vekil, etkin bir ana bilgisayardan gelen her şeyi denetlemez. Konuşma ve yükleme uç noktalarından oluşan katı bir izin listesiyle eşleşir — ChatGPT, OpenAI API, GitHub Copilot sohbeti, Claude, Gemini, DeepSeek, Qwen, Poe ve Character.ai'yi kapsayan on beş kural — ve o ana bilgisayarlardan gelen diğer her şeyi dokunmadan iletir. Tek bir sayfa yüklemesi betikler, yazı tipleri ve telemetri için düzinelerce istek üretir; bunların hiçbiri bir istem taşımaz ve bunları denetlemek hem gecikme hem yanlış pozitif üretmiştir.

İlk destek çağrısından önce söylenmeye değer üç sonuç vardır:

  • Listede olmayan bir sağlayıcı denetlenmez — ana bilgisayar adı vekile yönlendirilmiş olsa bile. Yeni ön yüzler için kural gerekir.
  • Büyük gövdeler engellenmez, atlanır. 512 KB üzerindeki metin gövdeleri ve 25 MB üzerindeki ikili gövdeler denetlenmeden iletilir.
  • Parçalanmış yüklemeler reddedilir. Parçalı ya da sürdürülebilir bir yükleme parça parça denetlenemez; bu yüzden CID_RESUMABLE_UPLOAD_POLICY varsayılanı block değerindedir ve tarayıcı başarısız bir yükleme görür. Bunu passthrough yapmak, dosyanın sağlayıcıya maskelenmeden ulaştığı eski davranışı geri getirir.

Doğrulama

  1. Yönetilen bir iş istasyonundan etkin ana bilgisayar adlarından birini açın. Sayfa sertifika uyarısı olmadan yüklenir ve tarayıcının bildirdiği sertifikayı, sağlayıcının kendisi değil CID222 vekil otoritesi düzenlemiştir.
  2. Politikada olmayan bir ana bilgisayar adına göz atın. Sertifikası gerçek olanıdır; bu da o sitenin şifresinin çözülmediğini kanıtlar.
  3. Aynı oturumda, tanınabilir bir test değeri içeren bir istem gönderin — örneğin 4111 1111 1111 1111 gibi sahte bir kart numarası. Kuralın eylemine bağlı olarak sağlayıcı değeri maskelenmiş alır ya da tarayıcı, X-Blocked-By: cid-core başlığını taşıyan Request blocked (istek engellendi) sayfasını gösterir.
  4. Tespit ve Filtreleme → Tüm Tespitler ekranını seçin ve kaynağı tarayıcı trafiğine göre süzün. Deneme saniyeler içinde MESSAGE_MASKED ya da MESSAGE_BLOCKED olarak; ana bilgisayar adı, kaynak adresi ve gerekçeleriyle birlikte görünür.
  5. Etkin bir sağlayıcıya, okunabilir kişisel veri içeren bir görsel yükleyin. FILE_UPLOAD_REDACTED olayı görünür ve model alanları karartılmış olarak tanımlar. Buradaki gerçek ölçüt modelin söyledikleridir — tarayıcıdaki küçük resim her zaman sizin yerel özgününüzdür.

Başarısız olursa

  • Tarayıcı yakalanan her sitede sertifika otoritesi hatası gösteriyor → otorite o makinenin güven deposunda değildir. certutil -store Root | findstr cid222 ile doğrulayın, sonra bir ilke yenilemesini zorlayın.
  • Otorite kurulu ve uyarılar sürüyor → cihaz sıfırlanmış ve otoriteyi yeniden üretmiştir. Paneldeki parmak izi artık dağıtılanla eşleşmez; yeniden indirip yeniden dağıtın.
  • Otomatik yapılandırma URL'sine erişiliyor ama hiçbir şey vekilden geçmiyor → vekil ayarı tarayıcıya ulaşmamıştır. İlke tercihinin uygulandığını ve betiğin duyurduğu port olan INLINE_PROXY_PUBLIC_PORT ile vekilin dinlediği port olan INLINE_PROXY_HTTPS_PORT değerlerinin eşleştiğini denetleyin. Bunlar farklı olduğunda tarayıcılar başka bir yere bağlanır ve hiçbir yerde hata görünmez.
  • Olaylar geliyor ama panel konteyneri çalışmıyor gösteriyor → Bir hizmet sağlıksız.
  • Yüklemeler maskeleme olayı olmadan başarısız oluyor → dosya baytlarını taşıyan ana bilgisayar Enabled hostnames listesinde yoktur. Yükleme ana bilgisayarları konuşma ana bilgisayarlarından ayrıdır.

Sonraki adımlar

  • ICAP ve üçüncü taraf ağ geçitleri — müşteri zaten bir güvenli web ağ geçidi çalıştırdığında geçerli olan seçenek ve laboratuvarda doğrulanmış sağlayıcıya sahip tek yol.
  • Yakalama topolojileri — bu dağıtımın neyi göremediği; bir güvenlik yetkilisine verilecek kadar açık biçimde.
  • Ağ önkoşulları — bu dağıtımın açtığı portlar ve bunları değiştiren değişkenler.

Son güncelleme

Bu sayfada