Bölüm 34: Hızlı Referans

Ekran-Fonksiyon Eşleşmesi

İşlem	Yol / Ekran
Admin girişi	https://<HOST>:8443/login
Kullanıcı girişi	https://<HOST>:8443/user/login
Kullanıcı proxy token	User Profile → Proxy Token bölümü
Sistem ayarları	Ayarlar (/admin/settings) — Çalışma Zamanı, Host Ağı & Zaman, PII & NLP, Syslog, Uyarılar & Sağlık, Kurumsal PAC, Sertifikalar (Web TLS), Marka, Lisans, E-posta/SMTP, Sistem Bilgisi
Blok bildirimi (Deny UX)	Ayarlar → Çalışma Zamanı → Blok Bildirimi
Sağlayıcı ve model yönetimi	Sağlayıcılar & Modeller (/admin/providers) — Sağlayıcılar & Modeller + Model Fiyatlandırma sekmeleri
Model fiyatlandırması	Sağlayıcılar & Modeller → Model Fiyatlandırma sekmesi
LDAP yapılandırma	Kimlik (/admin/identity) → Active Directory / LDAP sekmesi
Kullanıcı yönetimi	Kullanıcı Yönetimi (/admin/users)
Kullanıcı/grup sağlayıcı anahtarı atama	Kullanıcı Yönetimi kullanıcı detayı + anahtar kasası (Bölüm 8, Bölüm 12)
Erişim kuralları	Erişim Yönetimi (/admin/access-management)
PII kuralları / PII grupları	PII Kuralları (/admin/rules)
Prompt Guard	Prompt Koruması (/admin/prompt-guard) — Kurallar + Desenler + Desen Grupları + Sınıflandırıcı Modelleri + Safety Topics sekmeleri
İçerik moderasyonu	İçerik Moderasyonu (/admin/content-moderation)
Model erişim kontrolü	Model Kuralları (/admin/model-rules)
Sistem prompt'ları	Sistem Komutları (/admin/system-prompts)
Path filtreleme	Path Filtreleri (/admin/path-filters, İçerik Filtreleme başlığı altında)
MIME filtreleme / tür kütüphanesi	MIME Filtreleri (/admin/mime-filters) — Kurallar + MIME Türleri + MIME Grupları sekmeleri
Dosya meta verisi filtreleme	Dosya Meta Veri Kuralları (/admin/file-metadata-rules) — ad, uzantı, boyut, tip uyuşmazlığı, EXIF/Purview etiketi (Bölüm 18)
OCR filtreleme / desen kütüphanesi	OCR Filtreleri (/admin/ocr-filters) — Kurallar + İçerik Desenleri + Desen Grupları sekmeleri
DLP / ICAP	DLP Kuralları (/admin/dlp-rules)
Kurumsal Veri Denetçisi	Kurumsal Veri Denetçisi (/admin/llm-judge-rules) + Denetçi Uç Noktaları (/admin/judge-endpoints) (Bölüm 20)
Oturum tehditleri	Oturum Tehditleri (/admin/session-threats) (Bölüm 21)
Shadow AI keşfi	Shadow AI (/admin/shadow-ai) (Bölüm 22, Bölüm 23)
Maliyet limit preset kütüphanesi	Maliyet Limitleri (/admin/cost-rules) (Bölüm 26)
Raporlar (zamanlanmış)	Raporlar (/admin/reports) — Enterprise; Güvenlik & Risk türü (eski Compliance türüyle birleşti)
Onay akışı	Onaylar (/admin/approvals) — Enterprise
Denetim kayıtları	Denetim Kayıtları (/admin/audit)
Kullanım analizi	Kullanım Analizi (/admin/analytics-usage)
Performans / aktif uyarılar	Performans (/admin/performance) — Aktif Uyarılar kartı (Bölüm 26)
AI varlık envanteri	AI Varlık Envanteri (/admin/ai-asset-inventory)
Kayıtlı cihaz yönetimi	Kayıtlı Cihazlar (/admin/enrolled-devices)
Makine kimliği / kurulum token'ları	Makineler (/admin/machines) (Bölüm 13)
Dev CLI kurulum rehberi	Geliştirici Araçları (/admin/developer-tools)
Runtime log seviyesi	Ayarlar → Çalışma Zamanı (Bölüm 33 — "Log Seviyesini Geçici Olarak Yükseltme")
Cost limit artırım talebi	User Profile → "Request Increase"

Portlar ve Giriş Kanalları

Port	Yüzey
:8443	Arceris Gateway — web arayüzü (admin + kullanıcı paneli) ve HTTPS API
:443	Şeffaf proxy (MITM) — tarayıcı AI trafiği
:3128	Explicit proxy (CONNECT + TLS-bump) — kayıtlı cihazların ajan/IDE trafiği

Kanal	Kimlik	Tipik istemci
Tarayıcı (şeffaf proxy)	Cihaz/kullanıcı oturumu, captive portal	Gemini, ChatGPT, claude.ai web arayüzleri
Ajanlar (explicit proxy)	Kayıtlı cihazın geliştirici araçları token'ı	Claude Code, Codex, Cursor, SDK'lar
Yerel kanal (/local/)	Kayıtlı cihaz kullanıcısı	Coding agent yerel trafiği, kurum içi model çağrıları
Birleşik gateway (/gateway/v1)	Gateway key (arceris_gw_*)	API istemcileri; kullanıcı panelindeki Chat

Dosya kontrolleri (MIME → dosya meta verisi → OCR), DLP/Kurumsal Veri Denetçisi ve PII denetimi tüm giriş yollarında aynı karar motorundan geçer; her kanal yalnızca kendi engelleme sunumunu (blok sayfası veya JSON hatası) çizer.

Dev CLI Komutları (arceris-dev)

Tam liste için arceris-dev help, tek komut için arceris-dev help <komut> (Bölüm 24):

Komut	Açıklama
setup --server <url>	Tek komutla onboarding: enroll + CA + daemon + araç entegrasyonu
uninstall	Tam sökme — hook'lar, daemon, PAC, CA, kimlik bilgileri (setup'ın tersi)
enroll --server <url>	Cihazı tarayıcı device-flow ile kaydeder (setup bunu kapsar)
run	Bir AI aracını proxy kimlik bilgileri hazır şekilde başlatır
daemon install / daemon uninstall	Per-user arka plan servisini kurar/kaldırır (--server, --system-proxy seçenekleri)
integrate	AI araçlarına yönetilen hook'ları kurar (ör. Claude Code MCP yakalama)
ca install-system / ca uninstall-system / ca refresh	Arceris kök CA'yı sistem güven deposuna kurar / kaldırır / yeniler
doctor	Kayıt, CA ve araç yönlendirmesini doğrulayan sağlık kontrolü
status	Kayıt durumunu ve broker sağlığını gösterir
daemon-info	Daemon + kayıt durumunu JSON basar (IDE eklentisi kullanır)
token	Geçerli proxy kimlik bilgilerini JSON basar (IDE eklentisi kullanır)
recipes	Desteklenen araçları ve proxy/CA ortam değişkenlerini listeler
logout	Sunucu kimlik bilgilerini iptal eder, yerel kaydı kaldırır
help, version	Komut yardımı ve sürüm bilgisi

Makine kaydı (Kerberos yoksa): arceris-agent install --install-token <token> — tek kullanımlık kurulum token'ı Makineler sayfasında üretilir; Windows MSI ile dağıtımda INSTALLTOKEN= özelliğiyle verilir (Bölüm 13, Bölüm 24).

Girdi Doğrulama Kuralları (v1.3.1)

Yönetim yazmalarının tamamını etkileyen doğrulama davranışları (Bölüm 11, Bölüm 12):

Durum	Davranış
JSON gövdesinde NUL karakteri (≤8 MiB)	400 — hata alanın adını verir; ham veritabanı hatası dönmez (#1554)
Adda kontrol karakteri / görünmez karakter (zero-width, text-direction)	Reddedilir; adlar en fazla 128, yerel grup açıklaması en fazla 1 024 karakter (#1554)
Kullanıcı hedefi hiçbir kullanıcıyı adlandırmıyorsa	400 — hatanın adında kullanıcının kimliği görünür (#1554)
Ayar güncellemesinde gönderilmeyen alan	Son kaydedilen değer korunur (kısmi güncelleme); açık boş/yanlış/0 temizler; aynı anahtar farklı büyük/küçük harfle iki kez gönderilirse reddedilir (#1554)
Açık "priority": 0	400 — öncelik 1–100 aralığındadır; negatif değer adıyla reddedilir; gönderilmeyen/null öncelik varsayılan 100'ü alır (#1204)
Geçersiz atama kapsamı (scope)	400 — geçerli değerler * (boş = tümü), api, transparent; önceden kaydedilmiş geçersiz kapsamlar panelde "Invalid scope … (matches no traffic)" olarak etiketlenir (#1480)

Runtime vs. Restart Gerektiren Ayarlar

Ayar	Ne Zaman Etkili?
Proxy Runtime (transparent, captive, port)	Anında (DB override)
Response Scanning	Anında
Cost Enforcement	Anında
Syslog / SIEM	Anında
PII Backend	Anında
Runtime Log Seviyesi	Anında (audit'li)
DLP kuralları / atamaları	~60 sn (kural önbelleği)
Alert eşikleri	Anında (sonraki Evaluate tick)
Host DNS	Save sonrası (host tarafına uygulanır)
Host NTP	Save sonrası (host tarafına uygulanır)
Web TLS sertifikası	Upload anında
Dağıtım düzeyindeki ayarlar (portlar, intercept listesi vb.)	Yalnızca yeniden başlatma sonrası; değişiklik için destek ekibiyle iletişin
Lisans anahtarı	Anında (Check Now ile doğrula)

Sık Karşılaşılan Durumlar

Durum	Ne anlama gelir / nereye bakmalı
Blok kullanıcıya nerede görünür?	Gemini/ChatGPT/claude.ai HTML 403 blok sayfası göstermez; bildirim kanalı Ayarlar → Çalışma Zamanı → Blok Bildirimi (Deny UX) ile seçilir: 403 blok sayfası (varsayılan) veya sağlayıcı bildirimi. API istemcileri sağlayıcının kendi JSON hatasını alır. Blok referans numarası sayfada, bildirimde, X-Arceris-Request-ID başlığında ve denetim kaydında aynıdır (Bölüm 22).
ANON kimdir?	İstek Olayları'nda kimliği çözülemeyen satır. Kimlik zinciri: oturum çerezi → kayıtlı cihaz relay'i → sunulan belirteç → IP oturumu → anonim. ANON etiketli bir Model ACL red kural sorunu değil kimlik sorunu olabilir; detaydaki Kimlik bloğu nedeni söyler (Bölüm 9, Bölüm 25).
approval_stale ne demek?	Ajan güncelleme onayı imzalı yapının tam baytlarına pinlidir; gateway yükselince baytlar değişir, eski onay askıya alınır ve panelde approval_stale görünür — güncelleme için yeni onay gerekir (Bölüm 24, Bölüm 28).
not_scanned_file_cap reddi	İleti, denetlenebilecek olandan daha fazla ek taşıyor (genel 128; OCR kuralı atananlarda 32). Sessizce kesmek yerine ileti reddedilir (Bölüm 19, Bölüm 33).
Helper other_instance	Helper'ın portu başka bir süreçte; çözüm adımları Bölüm 33'te.
/readyz "degraded"	Derin sağlık kontrollerinden biri başarısız; hangi alt kontrolun düştüğü Bölüm 33'te anlatılır.

Destek İçin Toplanacak Bilgiler

Destek talebi açmadan önce şu bilgileri hazırlayın:

1. Ürün sürümü: Sistem Bilgisi sekmesindeki sürüm/build bilgisi.
2. Lisans durumu: Ayarlar → Lisans kartındaki Plan, Active, Valid, Days Left değerleri.
3. Storage backend: Sistem Bilgisi sekmesindeki "Storage Backend" değeri.
4. Etkilenen yüzey: Hangi özelliğin (proxy, PII, LDAP, audit, DLP, session threat vb.) sorun yarattığı.
5. Son değişiklikler: Denetim Kayıtları üzerinden son yapılandırma değişikliklerinin listesi.
6. Hata davranışı: Ekran görüntüsü, tarayıcı konsol hatası, HTTP durum kodu.
7. İlgili log bağlamı: Denetim Kayıtları sayfasından ilgili zaman aralığındaki olaylar; gerekirse runtime log seviyesini geçici olarak debug'a yükseltin (Bölüm 33 — "Log Seviyesini Geçici Olarak Yükseltme").

Sık Kullanılan Terimler

Terim	Açıklama
Admin Arayüzü	:8443 portundaki yönetim paneli
Access Management (Erişim Yönetimi)	Kullanıcı/grup bazlı erişim kural atama sistemi
Prompt Guard (Prompt Koruması)	Prompt içeriğine dayalı tehdit algılama ve engelleme
Sınıflandırıcı Modelleri / Safety Topics	Prompt Guard içine entegre ML tabanlı konu sınıflandırıcılar
Model Kuralları	Model erişim kontrolü (allow/deny)
Sistem Komutları (System Prompts)	Model isteklerine otomatik eklenen yönerge metinleri
Path Filtreleri	Dosya yolu tabanlı erişim kısıtlama (write / read / none)
MIME ve Dosya Meta Verisi Filtreleri	Dosyayı türüne (imza bazlı) ve meta verisine (ad, uzantı, boyut, EXIF, Purview etiketi) göre yargılayan iki kural ailesi
OCR Filters	Görüntü içeriği tarama ve filtreleme
DLP / ICAP	ICAP üzerinden harici DLP sunucusuna istem denetimi
Kurumsal Veri Denetçisi	Operatörün kendi politika metnini kurumun kendi LLM'ine değerlendiren kontrol (llm_judge)
Session Threat Detection	Çok turlu saldırıları oturum bazında tespit eden motor
Transparent Proxy	HTTPS MITM ile trafiği kesen proxy modu
Explicit Proxy	İstemci tarafı yapılandırma gerektiren proxy modu (IDE/tool trafiği)
Dev CLI (arceris-dev)	IDE/CLI trafiğini Arceris'e bağlayan istemci komut satırı aracı
arceris-agent	Windows makine servisi; makine kapsamı kayıt, PAC sunumu, güncelleme
Captive Portal	Kimlik doğrulamasız kullanıcıları login'e yönlendiren akış
Sağlayıcılar & Modeller	AI sağlayıcı kaydı ve model katalog yönetimi sayfası
Kayıtlı Cihazlar	Dev CLI ile kayıt olmuş kullanıcı oturumlarının yönetimi
Makineler	Makine kapsamlı kimlik düzlemi (AD bilgisayar hesabı veya kurulum token'ı)
Maliyet Limitleri	Cost limit preset kütüphanesi (Access Management'a bağlanır)
Raporlar	Zamanlanmış/on-demand güvenlik raporları (Enterprise)
Birleşik Gateway	/gateway/v1 — API istemcilerinin tek giriş noktası (gateway key ile)
Yerel Kanal	/local/ — coding agent yerel trafiği ve kurum içi model çağrıları
Blok Bildirimi (Deny UX)	Blokların kullanıcıya nasıl gösterileceğini seçen ayar (403 sayfası / sağlayıcı bildirimi)
ACL-bound	Access Management üzerinden atanmış kural
Runtime Override	Yeniden başlatma gerektirmeden, panel üzerinden anında uygulanan ayar
Feature Gate	Lisans planına bağlı özellik açma/kapama mekanizması
Maker-Checker	Talebi oluşturan kişinin kendi talebini onaylayamaması kuralı
Effective Policy	Bir kullanıcıya gerçekte uygulanan tüm kuralların birleşik görünümü