12.3 macOS dağıtımı

12.3.1 Paket mi, Terminal mi

Yöntem	Nasıl	Ne zaman
.pkg	Setup → Create installer (macOS .pkg). `AdaAgentSetup-<version>.pkg` ve `AdaAgentSetup.adacfg` dosyalarını aynı klasöre çıkarın, ardından pakete çift tıklayın. macOS bir yönetici parolası ister.	Kendi kurulumunu yapan kullanıcılar veya MDM
Terminal	macOS client (Terminal) komutu (bölüm 12.1.3)	Yöneticiler ve betikle yapılan kurulumlar

Paketin kurulum sonrası adımı .adacfg dosyasını okur, macos-client-setup.sh betiğini sunucudan indirir ve --with-agent ile çalıştırır. Günlüğü /var/log/ada-install.log dosyasındadır.

12.3.2 Ne nereye kurulur

Öğe	Konum / etiket
Uygulama paketi	`/Library/Application Support/AdaClassification/Ada Agent.app` (ikili dosya `Contents/MacOS/ada-agent`; menü çubuğu yardımcısı `Contents/Library/LoginItems/AdaMenuBar.app` içinde)
Root daemon	`com.ada.classification.daemon` — `/Library/LaunchDaemons/com.ada.classification.daemon.plist` (`ada-agent daemon`, root). Politika eşitleme, sinyal, komutlar, denetim kuyruğu, belirteç ve imzalama anahtarı ile kaldırma işlemlerini yürütür.
Dosya ajanı (kullanıcı başına)	`com.ada.classification.agent` — `/Library/LaunchAgents/com.ada.classification.agent.plist` (`ada-agent watch`, arka plan önceliği)
YZ işçisi (kullanıcı başına)	`com.ada.classification.aiworker` — `/Library/LaunchAgents/com.ada.classification.aiworker.plist` (`ada-agent ai-worker`, standart öncelik, 512 MB yığın (heap) sınırı)
Menü çubuğu yardımcısı (kullanıcı başına)	`com.ada.classification.menubar` — `/Library/LaunchAgents/com.ada.classification.menubar.plist`
Makine durumu	`/Library/Application Support/AdaClassification/State/` (yalnız root)
Kullanıcı verileri, günlükler	`~/Library/Application Support/AdaClassification/`, `~/Library/Logs/AdaClassification/`; daemon günlüğü `/Library/Logs/AdaClassification/ada-daemon.log`
Finder Hızlı Eylemi	`~/Library/Services/Classify with ADA.workflow` (bölge Türkçe olduğunda adı `ADA ile Sınıflandır`)
Başlatıcı uygulama	`~/Applications/Ada Pending Files.app` — menü çubuğu simgesi gizli olduğunda (örneğin çentiğin arkasında) bekleyen dosyalar listesini açar
Office web eklentileri	Manifestler `~/Library/Containers/com.microsoft.{Word,Excel,Powerpoint}/Data/Documents/wef/` içine yandan yüklenir. Kalıcı bir kopya saklanır ve Office kapsayıcısını sıfırlarsa yeniden yerleştirilir. Outlook yandan yüklenmez (bkz. bölüm 12.5).
İmzalama kimliği	“Ada Local Signing”, makine başına bir kez oluşturulur. Paket her kurulumda bu kimlikle yeniden imzalanır; böylece macOS gizlilik izinleri yükseltmelerden sonra korunur.

Dört hizmetin tamamı launchd KeepAlive ile çalışır. Ajan ve yardımcı birbirini izler; daemon, devreden çıkarılan (booted out) bir hizmeti geri yükler. Geri yükleme tamper_detected olarak denetlenir. İkili dosyalar, plist’ler ve makine durumu root’a aittir; bu nedenle standart bir kullanıcı bunları kaldıramaz.

12.3.3 Verilmesi gereken izinler

İzin	Gerekli olduğu iş	İzin yoksa	Nasıl
Ada Agent için Full Disk Access	Ev klasörünün dosya izlemesi (Desktop, Documents, Downloads gizlilik korumalıdır)	Hiçbir şey taranmaz. Ajan yine de sinyal gönderir, politikayı eşitler ve komutları yürütür. 20 sn sonra günlüğüne “File watching has NOT started after 20s — it is most likely waiting for macOS permission.” yazar. `ada-agent doctor`, `Full Disk Access [FAIL]` gösterir.	System Settings → Privacy & Security → Full Disk Access → Ada Agent’ı etkinleştirin. Bir makine filosu için MDM’den bir PPPC profili itin.
Menü çubuğu yardımcısı için Accessibility	label kipinde ekran filigranı (her pencerenin hangi belgeyi gösterdiğini okur)	Etikete bağlı filigran çizilmez. Always kipi izin gerektirmez.	Yardımcı her derlemede bir kez sorar. Privacy & Security → Accessibility altında açın. İmzasız derlemelerde kullanıcının bunu her güncellemeden sonra yeniden açması gerekir.
Finder extension onayı	Classify with ADA Hızlı Eylemi	Sağ tık girdisi görünmez	System Settings → General → Login Items & Extensions → Finder → eylemi etkinleştirin
“Ada Local Signing” için Anahtar Zinciri (Keychain) sorusu	Kurulumda yeniden imzalama	Sorular tekrarlanır	Bir kez Always Allow yanıtını verin
Desktop/Documents ve Yerel Ağ (Local Network) soruları	İlk erişim	—	Makine başına bir kez sorulur. Kalıcı imzalama kimliği sayesinde izinler yükseltmelerden sonra korunur.
Ekran Kaydı (Screen Recording), Bildirimler (Notifications)	Gerekli değil	—	Ada kendi açılır pencerelerini çizer ve ekranı hiçbir zaman yakalamaz

12.3.4 Yordam — tek Mac

Word, Excel ve PowerPoint’i önceden birer kez başlatın. Her uygulamanın kapsayıcısı ancak ilk açılıştan sonra oluşur; aksi takdirde kurulum o uygulama için “container not found” bildirir. Kurulum manifesti kuyruğa da alabilir; ajan onu daha sonra yerleştirir.
Terminal komutunu veya paketi çalıştırın.
Kurulum ACTION NEEDED: these Office apps are OPEN yazarsa uygulamalardan ⌘Q ile çıkın ve yeniden açın.
Full Disk Access iznini verin ve Hızlı Eylemi onaylayın (bölüm 12.3.3).
Durumu denetleyin: "/Library/Application Support/AdaClassification/Ada Agent.app/Contents/MacOS/ada-agent" status. Kapsamlı denetim için ada-agent doctor kullanın.