Bölüm 13: Kayıtlı Cihazlar ve Dev CLI Cihaz Yönetimi¶
İki Düzlem: Cihazlar ve Makineler¶
Arceris'in uç nokta varlığı v1.3.1'de iki düzlemde yönetilir ve admin panelde iki ayrı sayfaya karşılık gelir:
- Kayıtlı Cihazlar (
/admin/enrolled-devices) — kullanıcı başınaarceris-dev(helper) oturumları. Geliştiricilerin IDE'leri, terminal araçları ve CLI istemcileri burada listelenir. - Makineler (
/admin/machines) — makine kapsamlı kimlik: makine kendi olarak kaydolur (Kerberos üzerinden AD bilgisayar hesabıyla ya da tek kullanımlık kurulum token'ıyla) ve bu kimlik yalnız makine düzleminde geçerlidir; makine kimliğiyle kullanıcı, proxy ya da ajan token'ı üretilemez. Sayfa, makine kimliği özelliğinin kurulumda etkin olmasını gerektirir.
İki düzlem ilişkilidir: bir makinede birden fazla kullanıcı kaydı olabilir — Kayıtlı Cihazlar sayfasında "{n} bu makinede" rozeti bu ilişkiyi gösterir, Makineler sayfasında da makinenin altındaki kullanıcı kayıtları listelenir.
Kurulumun nasıl yapıldığı Bölüm 24'te anlatılır; bu bölüm kayıt sonrası görünürlük ve yönetimtedir.
Kayıtlı Cihazlar Sayfası¶
Aktif arceris-dev oturumlarının listesidir. İptal etmek trafiği anında keser ve yeniden kaydı zorunlu kılar. Tablo şu bilgileri gösterir:
| Kolon | İçerik |
|---|---|
| Cihaz / Kullanıcı / OS Kullanıcısı | Cihaz, Arceris hesabı ve işletim sistemi hesabı |
| Kimlik | Kayıt yöntemi (tarayıcı akışı, Kerberos, …) |
| Ajan | Helper sürümü |
| Kapsama | Ajanın son check-in'inde bildirdiği zorlama duruşu |
| IP Adresi | Görülen adres |
| Uyumluluk | Compliant / Non-Compliant / Unknown |
| Durum / Kaydedildi / Son Aktif / Son Check-in | Durum rozeti ve zamanlar |
Son Aktif ile Son Check-in farklı şeydir: Son Aktif, proxy üzerinden geçen son gerçek AI isteğidir; Son Check-in, arka plan daemon'unun yaptığı son kontroldür. "Henüz AI trafiği yok" rozeti, cihazın kayıtlı olduğunu ama henüz istek göndermediğini belirtir.
Sayfadaki diğer işaretler:
- Daemon çevrimdışı — check-in durduğunda yerel broker da kapalıdır; editör PreToolUse hook çağrıları politikaya ulaşamaz ve dosya erişim kuralları fail-open olur. Fare ile üzerine gelindiğinde son check-in tarihi görünür.
- "Kurumsal PAC devralındı" — bu makinenin önceki PAC adresi Arceris tarafından değiştirilmiştir; panelden bir Kurumsal PAC profili girilene kadar kurumsal proxy kuralları bu makinede uygulanmaz (Bölüm 6).
- Olası kopya — aynı donanım ipucu ve kullanıcıya sahip iki aktif kayıt; genelde yeniden kayıt hayalet satır bırakmıştır. Eski kayıt iptal edilmelidir.
- Kimlik yarılması (attribution) — Arceris kullanıcısı ile OS kullanıcısı eşleşmiyorsa bilgi amaçlı işaretlenir: Access Management, PII/moderasyon, model erişimi ve maliyet limitleri Arceris kullanıcısı için değerlendirilir; DLP, CLI/IDE trafiğinde OS kullanıcısını görür. İstenmiyorsa cihaz iptal edilip makinenin gerçek kullanıcısıyla yeniden kaydedilir.
Arama; kullanıcı adı, ana bilgisayar adı veya IP ile yapılır. Sayfanın üstünde filo genelinde ağ seviyesi zorlama özeti bulunur: kaç cihazın Arceris olmadan bir AI sağlayıcısına ulaşabildiği gösterilir — bildirim kapatılsa bile sayılar görünür kalır, yalnızca alarm susturulur.
Cihaz İptali¶
- Tek cihaz iptali: Satırdaki iptal, erişimi anında keser — çalışan
arceris-devsaniyeler içinde erişimini kaybeder ve yeniden kaydolmak zorundadır. Geri alınamaz. - Kullanıcı bazlı toplu iptal: Bir kullanıcının tüm cihazlarını tek işlemde iptal eder.
- Global iptal ("Tümünü İptal Et"): Filodaki tüm kayıtlı cihazları iptal eder; onay için REVOKE yazılması gerekir. Yalnızca acil güvenlik olaylarında kullanılmalıdır.
Tüm iptal işlemleri denetim günlüğüne yazılır (Bölüm 25).
Makineler Sayfası¶
Makine listesi şu kolonları içerir: Makine adı, Principal, Kayıt yolu (Kerberos (AD bilgisayar hesabı) / Kurulum token'ı), Ajan sürümü, Durum, Son check-in, Kimlik bilgisi bitişi, Aktif kayıt sayısı (bu makinedeki iptal edilmemiş kullanıcı kayıtları; "—" ölçülemedi demektir), Oturumlar ve İşlemler.
Durum rozetleri: Aktif, İptal edildi, Kimlik bilgisinin süresi doldu, Kimlik bilgisi yok, Kaldırıldı (ajan MSI'sı kaldırılmış), Kayıtlı değil.
Liste üstünde iki uyarı rozeti olabilir: "Kullanıcı kimliği yok (n)" ve "Kayıt takıldı (n)" — ilki, helper'ın geçerli bir Arceris kullanıcı kimliği olmadığını bildirdiği makinedir (bu kullanıcıların tarayıcısı ve araçları Arceris'e kimliksiz ulaşır; Model Erişimi * kurallarına göre karar verir), ikincisi sessiz kaydın Kerberos biletini beklediği ya da reddedildiği makinedir. "Kullanıcı kimliği yok" durumu ayrıca Ayarlar → Alerts & Health altında filo alarmı olarak da izlenebilir.
Makine Detayı¶
Satır açıldığında:
- Bu makinedeki kullanıcı kayıtları — Arceris kullanıcısı, OS kullanıcısı, yöntem, helper sürümü, helper check-in'i, trafik ve durum. İptal edilmiş kayıtlar 7 gün boyunca gösterilir. Servis check-in'i makinenin, helper check-in'i kullanıcı kaydının kontrol düzlemidir; Trafik yalnız gerçek AI isteklerinden gelir.
- Oturum ölçümü — makine servisi her açık kullanıcı oturumu için ölçer: o kullanıcının tarayıcı trafiği Arceris'e ulaşıyor mu? Satırda PAC kararı (taranıyor / TARANMIYOR / bilinmiyor / sistem proxy yok), helper durumu, broker'ın dinleme durumu, helper portunu tutan süreç (ör. "port PID 1234 tarafından tutuluyor") ve devralındı rozeti (servis, zaten çalışan bir helper'ı devralmışsa) görünür. Helper ölü olsa bile ölçüm devam eder.
- Kimlik satırı — "kullanıcı kimliği geçerli / yok / yeniden kayıt gerekli" ve nedeni: cihaz iptal edildi, kayıt süresi doldu, kimlik dosyası yok/okunamıyor, sessiz kayıt bileti bekliyor/reddedildi/kapalı, kullanıcı çıkış yapmış, profil temizliği dosyayı silmiş (sessiz kayıtta helper kendini yeniden başlatıp yeniden kaydolur)…
- Kurulum (enroll) satırı — kuruluyor / Kerberos bileti bekleniyor / reddedildi / kuruldu / başarısız ve nedenleri (realm izinli değil, kullanıcı tanımlı değil, OS hesap çakışması, sunucuda Kerberos kapalı…).
- Son hata serisi — makine servisinin restart'lar arası korunan son hata özeti (adım, hata sınıfı, deneme sayısı). Sunucuya ulaşamayan makine hata bildiremez; bu satır düzelme sonrası ilk başarılı check-in'de bildirilendir, anlık durum değildir. "N başarısız denemeden sonra düzeldi" rozeti 7 gün görünür.
- CA durumu — kök/ara sertifikanın makine depolarındaki hâli: kuruldu / güncel / BAŞARISIZ / kanal pinli değil.
Makine Duraklatma¶
Makine satırından veya detaydan "Arceris'i duraklat": süre seçimi 1 saat / 4 saat / 24 saat / devam ettirilene kadar, isteğe bağlı gerekçe (500 karakter; panelde ve denetim kaydında görünür, SIEM'e de iletilir).
- Teslim: ArcerisAgent servisi varsa oturum açmış kullanıcılara yaklaşık 1 dakikada iletilir; yoksa her kullanıcının bir sonraki check-in'inde (genellikle 5 dakika) uygulanır.
- Etki: Makinenin trafiği duraklatma süresince Arceris'ten geçmez; duraklamanın başında ve sonunda açık AI bağlantıları kesilir, araçlar (devam ettirmede Arceris üzerinden) yeniden bağlanır. Ağ seviyesinde (DNS/NAT/güvenlik duvarı) Arceris'e yönlendirilen trafik etkilenmez — güvenlik duvarı doğrudan sağlayıcı erişimini engelliyorsa, duraklatma süresince komut satırı araçları çalışmayabilir.
- İzleme: Rozet kimin, ne zaman duraklattığını ve gerekçeyi gösterir; "Şimdi devam ettir" ile erken bitirilebilir. Duraklatma, devam ettirme ve süre dolmaları denetim günlüğüne yazılır; süresiz duraklatmalar için günlük hatırlatma üretilir.
- Ajan duraklatmayı desteklemiyorsa (eski
arceris-dev) hiçbir şey değişmez — panel bunu açıkça söyler.
Komut Kuyruğu¶
Makine detayındaki Komutlar menüsünden, makinenin ArcerisAgent servisine komut kuyruklanır. Makine çevrimiçiyse komut bir sonraki check-in'de (≤ ~60 sn) teslim edilir; komutun geçerlilik süresi bir saattir.
| Komut | Ne yapar |
|---|---|
| Helper'ı yeniden başlat | Her oturumdaki helper zarifçe durur, servis saniyeler içinde yeniden başlatır; PAC yerinde kalır |
| Teşhis topla | Servis bir teşhis paketi yükler (günlükler + durum, kimlik bilgisi yok); makinedeki kullanıcılardan da daemon günlüğü yüklemesi istenir |
| CA'yı yenile | Gateway CA'sı pinli kanaldan çekilip makineye yazılır: kök → Güvenilen Kök, ara/Sub-CA → Ara CA deposu; uç (leaf) sertifika asla yazılmaz. Yalnız pinli kurulumda çalışır |
| Güncellemeyi zorla | Her oturumdaki helper hemen check-in yapar; onaylı güncelleme bekleme aralığını beklemeden alınır |
| Politikayı şimdi yenile | Helper hemen check-in yapar; değişen politika veya kurumsal PAC beklemeden uygulanır (ajan güncellemesi uygulamaz) |
Komut geçmişi; durumu (bekliyor / teslim edildi / tamamlandı / başarısız / süresi doldu / kısmi), teslim sayısını ve oturum bazlı sonuçları gösterir. "no_ack", helper'ın yanıtlamadığını (çok eski ya da çalışmıyor) belirtir. Teşhis paketleri listeden indirilebilir.
Kurulum Token'ları¶
Makineler sayfasının alt bölümü, domain dışı makineleri kaydetmek için tek kullanımlık, süreli (1–720 saat) kurulum token'larıdır: etiket, durum (Aktif / Kullanıldı / Süresi doldu / İptal edildi), bitiş, kullanan ve oluşturan bilgileriyle yönetilir. Token üretildiğinde bir kez gösterilir — hemen kopyalanmalıdır. Kurulum akışının tamamı Bölüm 24'te anlatılır. Toplu dağıtım Kerberos yolunun işidir; token'lar tekil, domain dışı makineler içindir.
Makine İptali ve Kimlik Sıfırlama¶
- İptal et: Makine kimlik bilgisini hemen kaybeder ve geri alınana kadar yeniden kaydolamaz. Dikkat: geri almak kimliği geri getirmez — Kerberos ile kaydolan makine bir sonraki Kerberos kaydında kendiliğinden döner; kurulum token'ı ile kaydolan makine yeni bir kurulum token'ı gerektirir.
- Kimliği sıfırla: Makine kimliğini ve tüm makine kimlik bilgilerini temizler; hostname, donanım ipucu ve makinedeki kullanıcı cihazları korunur. Kullanım senaryosu: bir AD bilgisayar hesabı, sahibi olmadığı bir makineyi "sahiplendi"ğinde — önce o hesabı AD'de devre dışı bırakın, sonra gerçek makineye bir kurulum token'ı verin. İptalden farklı olarak gerçek makine hemen yeniden kaydolabilir.
Her iki işlem de denetim günlüğüne yazılır.
Operasyonel Bağlam¶
Cihaz ve makine kaydının nasıl yapıldığı Bölüm 24'te, ajan sürümlerinin nasıl onaylanıp dağıtıldığı da oradaki Agent Güncelleme Dağıtımı'nda anlatılır. Kimlik değişimlerinin politikalara etkisi Bölüm 9'da, denetim satırları Bölüm 25'te ele alınır. Bu sayfaların görünür olması lisans paketine bağlı değildir; tüm planlarda açıktır.