12.1 Agents → Setup

Agents → Setup, bir istemcinin ihtiyaç duyduğu her şeyin alındığı yerdir. Sunucu adresi önceden doldurulmuş kurulum komutlarını gösterir, kurumsal kurulum paketlerini oluşturur, ajan belirtecini görüntüler, elle indirmeleri sunar ve Microsoft 365 eklenti anahtarını yönetir. Sunucu adresi konsol URL’sindeki ana bilgisayar adından alınır; bu nedenle konsolu IP ile değil, DNS adıyla (örneğin ada.example.com) açın. IP kullanılırsa üretilen komutlara ve manifestlere IP yazılır ve istemcilerde TLS ad doğrulaması başarısız olur.

Sayfa tek sütunlu kartlardan oluşur. En üstteki Client setup yardım kutusu akışı özetler. Kartlar sırasıyla şunlardır:

12.1.1 Windows client (administrator PowerShell)

Kart şuna benzer bir komut gösterir:

curl.exe -k https://ada.example.com/windows-client-setup.ps1 -o "$env:TEMP\ada-setup.ps1"
Set-ExecutionPolicy -Scope Process Bypass -Force
$t = (New-TemporaryFile).FullName; Set-Content -LiteralPath $t -Value '<TOKEN>' -NoNewline
& "$env:TEMP\ada-setup.ps1" -Server ada.example.com -WithAgent -WithEnforcement -IngestTokenFile $t; Remove-Item -LiteralPath $t

Reveal veya Copy’ye tıklanana kadar belirteç <TOKEN — filled in by Reveal / Copy> olarak görünür. Copy, gerçek belirteci sunucudan alır, komutun tamamını panoya kopyalar ve bir setup_token_viewed denetim kaydı yazar. Komutu yükseltilmiş (yönetici olarak açılmış) bir PowerShell penceresine yapıştırın.

Belirteç hiçbir zaman komut satırında değil, özel bir geçici dosya içinde aktarılır. Süreç komut satırlarını herhangi bir yerel kullanıcı okuyabilir ve dağıtım araçları bunları günlüğe yazar.

Dosya izleme veya Office zorlaması olmadan temel bir kurulum için -WithAgent ve -WithEnforcement parametrelerini kaldırın.

12.1.2 Enterprise deployment (SCCM / Intune / GPO)

Bu kart, kuruluma özel kurulum paketleri oluşturur. Her sürümle birlikte genel bir kurulum paketi gelir. Düğmeye tıklandığında sunucu bu paketi, bu sunucunun güncel değerlerini içeren bir yapılandırma dosyasıyla birlikte paketler.

Windows .adacfg dosyası şunları taşır: - sunucu adresi - kök CA - politika imzalama açık anahtarı - ajan belirteci - Office manifestleri

Bu nedenle bir Windows istemcisinin kurulum sırasında sunucuya ulaşması gerekmez.

macOS .adacfg dosyası şunları taşır: - sunucu adresi - belirteç - imzalama anahtarı

macOS paketi ajanı daha sonra sunucudan indirir; bu yüzden Mac’in kurulum sırasında sunucuya ulaşabilmesi gerekir.

Her indirme: - yalnız yöneticilerle sınırlıdır - hiçbir zaman önbelleğe alınmaz (Cache-Control: no-store) - SHA-256 değerlerini içeren bir installer_created denetim kaydı yazar

Oluşturmanın ardından kart üç SHA-256 değeri gösterir:

Yordam (Windows, SCCM / Intune / GPO): 1. Create installer (Windows)’a tıklayın ve zip dosyasını kaydedin. 2. SHA-256 değerini kartta gösterilen değerle karşılaştırarak doğrulayın. 3. Her iki dosyayı da aynı klasöre çıkarın. AdaAgentSetup.adacfg dosyasının adını değiştirmeyin. Kurulum paketi onu kendi klasöründen okur. Dosya yoksa kurulum paketi yanlış sunucuya kurmak yerine “Configuration file NOT found next to the installer” iletisiyle durur. 4. Klasörü paketleyin: - Intune: bir Win32 uygulaması (klasörün .intunewin dosyası). - SCCM: içerik olarak bu klasörü kullanan bir uygulama. - GPO: bir bilgisayar başlangıç betiği.

Üçü de SYSTEM olarak çalışır. 5. Kurulum komutu: AdaAgentSetup-<version>.exe /S. 6. Algılama kuralı: - Kayıt defteri anahtarı HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\AdaClassification, değer DisplayVersion, 64 bit görünüm. - Bazı makineler PowerShell betiğiyle (Program Ekle/Kaldır kaydı yazmaz) kurulduysa veya yükseltildiyse, bunun yerine C:\Program Files\AdaClassification\service\Ada Agent Service.exe dosyasının sürümüne göre algılama yapın. 7. Dönüş kodları: 1618’i Retry (Yeniden dene) olarak eşleyin (Windows’un “hızlı yeniden deneme” kodudur).

Kurulum paketi komut satırı anahtarları:

12.1.3 macOS client (Terminal)

Kart şunu gösterir:

t=$(mktemp) && printf '%s' '<TOKEN>' > "$t"
curl -sk https://ada.example.com/macos-client-setup.sh | sudo INGEST_TOKEN_FILE="$t" bash -s -- ada.example.com --with-agent; rm -f "$t"

Komutu Terminal’de Mac’i kullanacak kullanıcı olarak çalıştırın (komut sudo kullanır). Root kabuğundan çalıştırmayın. Kurulum gerçek konsol kullanıcısını belirleyemezse durur.

12.1.4 Agent authentication

Kart belirteci açıklar ve maskelenmiş olarak gösterir. Şunlara tıklayın: - Göstermek için Reveal. - Yeniden maskelemek için Hide. - Panoya kopyalamak için Copy.

Bir sayfa ziyaretindeki ilk Reveal veya Copy işlemi gerçek değeri indirir ve setup_token_viewed kaydını yazar (kim ve hangi IP’den; belirteç değeri hiçbir zaman günlüğe yazılmaz).

Belirteç nasıl kullanılır: - Bu bir kayıt belirtecidir. Yeni bir ajan onu kayıt olmak için bir kez kullanır. Ajan ardından kendi anahtar çiftini üretir, bir yıllık bir sertifika alır ve sonraki her isteği kendi anahtarıyla imzalar (bölüm 13.3.9). - Kayıttan sonra yalnız yeniden kayıt ve tanılama yüklemesi için kullanılır. - Yenileme (rotation) sunucu tarafında yapılır: bash deploy/rotate-ingest-token.sh --grace 14. Tolerans süresi boyunca kart “A previous token is still accepted until …” (önceki belirteç … tarihine kadar kabul edilmeye devam eder) iletisini gösterir. - Yenileme yalnız yeni kurulumları etkiler. Daha önce kayıt olmuş ajanlar çalışmaya devam eder. - Hiç kayıt olmamış ajanlar varsa kart bunu belirtir. Bunlar bu sunucuya bağlanamayan 1.2 öncesi ajanlardır; yükseltilmeleri gerekir.

12.1.5 Next steps (on the client)

1. Tüm Office uygulamalarını tamamen kapatın ve yeniden açın.
2. Modül politikada etkinse COM eklentileri ve zorlama, Word, Excel veya Outlook açıldığında otomatik olarak yüklenir.
3. Web paneli, her kullanıcı ve her uygulama için bir kez eklenmelidir: Add-ins → More Add-ins → My Add-ins | Shared Folder → Ada Data Classification → Add. Bundan sonra şeritte kalıcı olarak durur.
4. Outlook on the web için aka.ms/olksideload üzerinden elle yandan yükleme yapın (yalnız test amaçlı; üretimde merkezi dağıtım kullanın).

12.1.6 Downloads

Export with a different address. Manifestler sunucunun kendi adresini içerir. İstemciler sunucuya başka bir adla ulaşıyorsa (genel FQDN, yük dengeleyici, NAT), o adresi buraya yazın: isteğe bağlı :port ile bir ana bilgisayar adı veya IP; şema veya yol olmadan. Geçersiz girişte “Enter a hostname or IP (an optional :port is allowed) — no scheme, no path.” iletisi gösterilir. Giriş geçerli olduğunda Word, Excel, PowerPoint, Outlook (Exchange Online) ve Outlook (şirket içi Exchange) için indirme bağlantıları görünür. Manifest içindeki her URL yeniden yazılır (görev bölmesi, komutlar, simgeler, AppDomain). Sunucuda hiçbir şey değişmez.

12.1.7 Production: M365 Centralized Deployment

Bir Microsoft 365 kiracınız varsa web eklentileri için önerilen yol budur. Katalog paylaşımı, sertifika veya istemci betiği gerekmez.

1. Microsoft 365 yönetim merkezini açın → Settings → Integrated apps → Upload custom apps.
2. Sonraki karttaki anahtarlı manifesti yükleyin (önerilen). Alternatif olarak kartta gösterilen düz manifest URL’sini verin:
   • https://ada.example.com/manifest-word.xml
   • https://ada.example.com/manifest-excel.xml
   • https://ada.example.com/manifest-ppt.xml
   • https://ada.example.com/manifest-outlook.xml
3. Kullanıcıları veya grupları atayın. Office eklentileri onlara iter. Microsoft’un yayılımı 24 saate kadar sürebilir.

12.1.8 Microsoft 365 add-in key

Microsoft 365’ten veya bir Exchange kuruluşundan dağıtılan eklentiler tüm kullanıcılar için tek bir manifest paylaşır. Bu manifest bir makinenin panel belirtecini taşıyamaz. Bunun yerine Microsoft 365 add-in key manifestin URL yoluna eklenir. Bu anahtarla sunucu eklentiye güvenir: - Outlook on the web, kullanıcının posta adresiyle eşleşen politika grubunu alır. - Eklenti, içerik kurallarının tamamını alır.

Anahtar olmadan eklenti anonim bir çağıran olarak değerlendirilir. Manifesti açabilen herkes anahtarı okuyabilir, ancak anahtar eklentinin zaten aldığının ötesinde hiçbir şeyi açığa çıkarmaz.

Kart durumları ve düğmeler:

Yordam: 1. Generate key’e (veya Rotate key’e) tıklayın. 2. Dağıttığınız her uygulama için anahtarlı manifesti indirin. 3. Microsoft 365 yönetim merkezinde, Settings → Integrated apps altında, dosyayı mevcut Ada uygulamasının güncellemesi olarak yükleyin. Tek bir posta kutusu için bunun yerine eklentiyi Outlook’ta kaldırıp dosyayı yeniden ekleyebilirsiniz. 4. Bir yenilemeden sonra 3. adımı 7 günlük süre içinde tekrarlayın.

12.1.9 No Microsoft 365? Outlook send protection still works

Web eklentisinde gönderim anı zorlaması, posta sunucunuz için doğru Outlook olayını gerektirir. Microsoft 365 zorunlu değildir. Her posta kutusu için tam olarak bir Outlook manifesti dağıtın:

Exchange Management Shell’den şirket içi dağıtım:

$Data = Get-Content -Path '.\manifest-outlook-onprem.xml' -Encoding Byte -ReadCount 0
New-App -OrganizationApp -FileData $Data -DefaultStateForUser Enabled

Sıkılaştırma: - Mac’ler: defaults write com.microsoft.outlook OnSendAddinsWaitForLoad -bool true (Jamf veya Intune ile itin). - Şirket içi OWA: ItemSend işleyicilerini yalnız posta kutusu politikası izin verdiğinde çalıştırır: Set-OwaMailboxPolicy <policy> -OnSendAddinsEnabled $true.