Siber Güvenlik

Wazuh Agent Kurulumu: Windows'a GPO, Linux'a apt

Wazuh agent kurulumu: fabrikada parolasız gelen kaydı parolaya bağlamak, Windows'a GPO başlangıç betiğiyle toplu dağıtım, Linux'a apt ve lab ölçümleri.

İlker Pehlivan

Wazuh agent, izlenecek makineye kurulan ve server’a ilk bağlandığında kendini kaydettiren küçük bir yazılımdır. Kurumdaki Windows bilgisayarlara GPO’daki bir başlangıç betiğiyle, Linux sunuculara apt ile kurulur. Kayıt fabrika ayarında parolasızdır, yani server’ın adresine ulaşabilen her makine agent olarak kaydolur. Bu yüzden kurulumun ilk işi agent’lara değil server’a dokunur ve kaydı bir parolaya bağlar.

Bu yazı, Wazuh server kurulduktan sonraki adımı anlatır: izlenecek makinelere agent kurmak. Lab’da Ubuntu 26.04 sunucusuna apt ile, Windows 11 istemcisine GPO ile kurdum ve her adımı ölçtüm: fabrika ayarındaki server’ın parola sormadan anahtar verdiği kayıt, parolasız agent’ın iki tarafta yazdığı ret satırı, Linux paketinin servisi başlatmadığı an, MSI’ın kayıt parolasını düz metin yazdığı log. Agent’ın ne olduğunu ve öteki parçalarla nasıl konuştuğunu Wazuh nedir yazısında anlattık. Doğrudan dağıtıma geçmek isterseniz GPO adımlarına atlayabilirsiniz.

Wazuh nedir yazımızda agent’ı arıza merkezine okumasını kendisi gönderen akıllı bir sayaca benzettik. Elektrik şirketi yeni bir mahalleye sayaç takarken montaj ekibi evleri tek tek dolaşır. Her sayaç ilk enerjiyi alınca kendini arıza merkezine tanıtır ve bir abone numarası alır.

Merkez her gelen tanıtımı kabul ederse, biri kendi yaptığı bir kutuyu duvara asıp sahte okuma gönderebilir. Bu yüzden merkez montaj ekibine bir tanıtma kodu verir ve kodu söylemeyen sayacı kaydetmez. Kod sayacın kapağına yazılmaz, çünkü kapağı herkes okur. Wazuh agent kurulumu da bu düzende kurulur.

Wazuh agent benzetmesi: yeni yapılmış evlerin sokağında montajcı en yakın evin kapısının yanına akıllı sayacı tornavidayla takıyor, yanında elinde kapalı dosya tutan meslektaşı, yerde açık alet kutusu, sokak boyunca sırasını bekleyen evlerin kapı yanlarında boş montaj plakaları, direklerde havai hat
Montaj ekibi mahalleyi ev ev dolaşır, tanıtma kodu kapakta değil ekibin dosyasında durur. Wazuh agent'ı da makinelere GPO ya da paket yöneticisiyle dağıtılır ve server'a kayıt parolasıyla tanıtılır.

Bu makale Siber Güvenlik ana hizmetimizin güvenlik izleme koluna, özellikle izlenecek makinelere Wazuh agent kurulmasına odaklanır.

Wazuh Agent Kurulumu Nasıl Olmalı?

Önce kısa cevap: server, agent’ları yalnız kayıt parolasıyla kabul eder ve parolayı server’daki bir dosyaya biz yazarız. Windows’a GPO’daki bir bilgisayar başlangıç betiği kurar, parola betiğin içinde değil yalnız bilgisayar hesaplarının okuyabildiği bir paylaşımda durur. Her agent kayıtta kendi grubuna (windows, linux) girer ve agent’ın sürümü server’ın sürümünü geçmez.

Bu düzeni beş Wazuh belgesi birlikte tarif ediyor (hepsi 4.14):

  1. Parolayla kayıt (Using password authentication): server’da use_password açılır. Önerilen yol, parolayı /var/ossec/etc/authd.pass dosyasına kendimizin yazmasıdır. Dosya 640 izinli ve root:wazuh sahipli olur. Agent da parolayı kendi authd.pass dosyasından okur.
  2. Windows paketi (Installing Wazuh agents on Windows endpoints): MSI sessiz kurulur, yönetici yetkisi ister. Agent C:\Program Files (x86)\ossec-agent altına kurulur, servisin adı WazuhSvc’dir.
  3. Windows kurulum değişkenleri (Deployment variables for Windows): WAZUH_MANAGER server’ın adresini, WAZUH_REGISTRATION_PASSWORD kayıt parolasını, WAZUH_AGENT_GROUP grubu verir. Belgeye göre parola agent’taki authd.pass dosyasına yazılır.
  4. Linux paketi (Installing Wazuh agents on Linux endpoints): WAZUH_MANAGER ortam değişkeniyle apt kurulur. Belgeye göre uyumluluk yalnız server’ın sürümü agent’ınkine eşit ya da ondan yeniyse garanti edilir.
  5. Agent grupları (Grouping agents): grubu atanmamış agent default grubuna düşer. Grup kayıtta verilebilir, ama server’da önceden açılmış olmalıdır.
KararBu yazıdaki seçimNeden
Kayıt kime açık?Yalnız parolayı bilen agent’aFabrika ayarında ağdaki her makine kaydolur
Parola nereden gelir?Server’da bizim yazdığımız authd.passRastgele parola her yeniden başlatmada değişir
Windows’a nasıl dağıtılır?GPO başlangıç betiği ve msiexecSoftware Installation MSI’a değişken veremez
Parola Windows’ta nerede durur?Yalnız Domain Computers’ın okuyabildiği paylaşımdaSYSVOL’daki betiği her kullanıcı okur
Grup?Kayıtta, WAZUH_AGENT_GROUP ileAgent ilk bağlantıda doğru yapılandırmayı alır
Sürüm?Linux’ta depo kapalı ve paket hold, Windows’ta betik sabit sürüm kurarAgent server’dan yeni olmamalı
İstemcide gelen kural?YokBağlantıyı her zaman agent açar

Kayıt ve Veri: 1515 ve 1514

Agent server’la iki ayrı portta konuşur ve iki bağlantıyı da kendisi açar. İlk açılışta server’ın 1515/TCP portuna bağlanır, adını ve grubunu söyler ve karşılığında bir anahtar alır. Bu işe kayıt (enrollment) denir. Anahtar agent’ta client.keys dosyasına yazılır. Sonra agent bütün veriyi bu anahtarla şifreleyip 1514/TCP üzerinden gönderir.

Kayıt bir kez olur. Agent yeniden başladığında anahtarı dosyadan okur ve doğrudan 1514’e bağlanır. Kayıt parolası yalnız 1515’teki ilk konuşmada sorulur. Server’daki bütün portların listesi Wazuh nedir yazısında, bu iki portun hangi ağa açıldığı Wazuh kurulumu yazısının ufw bölümünde duruyor.

Wazuh Agent Kaydını Parolaya Bağlamak

Agent kurulmadan önce server’da iki iş yapılır: kayıt parolası ve agent grupları. Bu sırayla hazırlanırsa ilk agent kurulduğu anda doğru grupta, parolayla kaydolur.

Fabrika Ayarında Kayıt Parolasız

Kayıt servisinin ayarı server’daki /var/ossec/etc/ossec.conf dosyasının <auth> bloğundadır. Kurulum asistanının bıraktığı blok:

siem01Bash
sudo sed -n '/<auth>/,/<\/auth>/p' /var/ossec/etc/ossec.conf
siem01Bash Çıktısı
  <auth>
    <disabled>no</disabled>
    <port>1515</port>
    <use_source_ip>no</use_source_ip>
    <purge>yes</purge>
    <use_password>no</use_password>
    <ciphers>HIGH:!ADH:!EXP:!MD5:!RC4:!3DES:!CAMELLIA:@STRENGTH</ciphers>
    <!-- <ssl_agent_ca></ssl_agent_ca> -->
    <ssl_verify_host>no</ssl_verify_host>
    <ssl_manager_cert>etc/sslmanager.cert</ssl_manager_cert>
    <ssl_manager_key>etc/sslmanager.key</ssl_manager_key>
    <ssl_auto_negotiate>no</ssl_auto_negotiate>
  </auth>

use_password değeri no. Bunun ne anlama geldiğini lab’da denedim. Wazuh agent paketi kurulu lnx02’den, agent’la gelen agent-auth aracıyla, hiçbir parola vermeden acik-kayit-deneme adlı bir agent kaydettirdim:

lnx02Bash
sudo /var/ossec/bin/agent-auth -m 192.168.1.47 -A acik-kayit-deneme
lnx02Bash Çıktısı
2026/11/05 13:10:54 agent-auth: INFO: Started (pid: 3829).
2026/11/05 13:10:54 agent-auth: INFO: Requesting a key from server: 192.168.1.47
2026/11/05 13:10:54 agent-auth: INFO: No authentication password provided
2026/11/05 13:10:54 agent-auth: INFO: Using agent name as: acik-kayit-deneme
2026/11/05 13:10:54 agent-auth: INFO: Waiting for server reply
2026/11/05 13:10:54 agent-auth: INFO: Valid key received

Server anahtarı verdi ve agent listesine ID: 001, Name: acik-kayit-deneme satırı düştü. Server’ın kendi log’u kayıt servisinin nasıl çalıştığını açıkça yazıyordu: Accepting connections on port 1515. No password required. Agent’ın adını kayıt yapan taraf seçer, yani bu yolla gelen bir makine istediği adı alabilir. Deneme kaydını sonra sildim.

Örnekteki arıza merkezinde bu, tanıtma kodu sormayan merkezdir. Duvara asılan her kutu kendini sayaç olarak tanıtır ve abone numarası alır.

use_password ve authd.pass

Kaydı parolaya bağlamak iki adımdır: <auth> bloğunda use_password değeri yes olur, parola da /var/ossec/etc/authd.pass dosyasına yazılır. Wazuh belgesi parolayı echo ile yazmayı gösteriyor, ama o yol parolayı kabuk geçmişine bırakır. Lab’da parolayı openssl ile ürettim ve doğrudan dosyaya yazdırdım, değer ekrana hiç basılmadı:

siem01Bash
sudo cp -a /var/ossec/etc/ossec.conf /var/ossec/etc/ossec.conf.yedek
sudo sed -i 's#<use_password>no</use_password>#<use_password>yes</use_password>#' /var/ossec/etc/ossec.conf
openssl rand -base64 24 | sudo tee /var/ossec/etc/authd.pass > /dev/null
sudo chmod 640 /var/ossec/etc/authd.pass
sudo chown root:wazuh /var/ossec/etc/authd.pass
sudo systemctl restart wazuh-manager
  1. openssl rand -base64 24: 24 rastgele bayt üretir ve 32 karakterlik bir metin olarak yazar. tee’nin çıktısı /dev/null’a gittiği için değer ekrana düşmez.
  2. chmod 640 ve chown root:wazuh: dosyayı yalnız root yazabilir, wazuh grubu okuyabilir. Kayıt servisi wazuh kullanıcısıyla çalışır, başka bir kullanıcı dosyayı açamaz.

Yeniden başlatmadan sonra server’ın log’u kayıt servisinin artık parolayı nereden okuduğunu söyler:

siem01Bash Çıktısı
2026/11/05 16:11:13 wazuh-authd: INFO: Started (pid: 4872).
2026/11/05 16:11:13 wazuh-authd: INFO: Accepting connections on port 1515. Using password specified on file: etc/authd.pass

Log’da parolanın kendisi geçmiyor. Bunu grep ile dosyanın değerini log’da arayarak ölçtüm: sıfır satır. Belgedeki ikinci yol, yani authd.pass olmadan use_password açmak, her yeniden başlatmada rastgele bir parola üretir ve onu ossec.log’a yazar. O parola her güncellemede değişir ve dağıtım betiği bir sonraki açılışta eski parolayla kalır. Bu yüzden parolayı biz yazarız.

Kayıt parolası bir agent’ın kimliği değildir, yalnız kayıt sırasında sorulur. Kayıttan sonra her agent kendi anahtarıyla konuşur. Parola sızarsa yenisi yazılır ve server yeniden başlatılır. Kayıtlı agent’lar bundan etkilenmez, yalnız bundan sonra kurulacak agent’lar yeni parolayı ister.

Agent Grupları: windows ve linux

Wazuh’ta grup, agent’lara merkezden yapılandırma göndermenin birimidir. Server her grup için bir agent.conf tutar ve o gruptaki agent’lar dosyayı kendiliğinden alır. Windows ve Linux agent’ları farklı log kaynaklarını ve farklı dizinleri izleyeceği için iki grup açılır:

siem01Bash
sudo /var/ossec/bin/agent_groups -a -g windows -q
sudo /var/ossec/bin/agent_groups -a -g linux -q
sudo /var/ossec/bin/agent_groups -l
siem01Bash Çıktısı
Group 'windows' created.
Group 'linux' created.
Groups (3):
  default (0)
  linux (0)
  windows (0)
Unassigned agents: 0.

Gruplar boş açılır. Hangi grubun neyi izleyeceği sonraki adımların işidir. Burada önemli olan, agent’ın kayıt anında doğru gruba girmesidir. Grup kayıttan sonra değişirse agent yeni grubun yapılandırmasını alıp yeniden başlar.

Wazuh Agent’ı Linux’a Kurmak

Linux’ta agent Wazuh’un kendi deposundan kurulur. Lab’da Ubuntu 26.04 çalışan lnx02’ye önce depoyu ekledim. Depo anahtarı imzayı doğrulamak için ayrı bir anahtarlığa alınır, depo satırı da o anahtarlığı gösterir:

lnx02Bash
curl -s https://packages.wazuh.com/key/GPG-KEY-WAZUH | sudo gpg --no-default-keyring --keyring gnupg-ring:/usr/share/keyrings/wazuh.gpg --import
sudo chmod 644 /usr/share/keyrings/wazuh.gpg
echo "deb [signed-by=/usr/share/keyrings/wazuh.gpg] https://packages.wazuh.com/4.x/apt/ stable main" | sudo tee -a /etc/apt/sources.list.d/wazuh.list
sudo apt-get update

Agent apt ile, iki ortam değişkeniyle ve server’la aynı sürüm sabitlenerek kurulur:

lnx02Bash
sudo WAZUH_MANAGER="192.168.1.47" WAZUH_AGENT_GROUP="linux" apt-get install -y wazuh-agent=4.14.9-1
  1. WAZUH_MANAGER: paket bu değeri agent’ın yapılandırmasına server adresi olarak yazar. Verilmezse agent’ın gideceği bir server olmaz.
  2. WAZUH_AGENT_GROUP: agent kayıtta bu grubu ister.
  3. =4.14.9-1: depodaki en yeni sürümü değil, server’ınkini kurar. Lab’da server 4.14.9’du ve depoda 4.14.9 ile 4.14.8 duruyordu.

Kurulumdan sonra /var/ossec/etc/ossec.conf dosyasının <client> bloğu iki değişkenin nereye gittiğini gösterir:

lnx02Yapılandırma
<client>
  <server>
    <address>192.168.1.47</address>
    <port>1514</port>
    <protocol>tcp</protocol>
  </server>
  <enrollment>
    <enabled>yes</enabled>
    <groups>linux</groups>
    <authorization_pass_path>etc/authd.pass</authorization_pass_path>
  </enrollment>
</client>

Paket Servisi Başlatmıyor

Kurulum hata vermeden biter, ama agent çalışmaz:

lnx02Bash
systemctl is-enabled wazuh-agent; systemctl is-active wazuh-agent
lnx02Bash Çıktısı
disabled
inactive

Paket servisi ne başlatır ne de açılışa ekler. Belge de kurulumdan sonra servisi elle etkinleştirmeyi söylüyor. Unutulursa agent kurulu görünür ama hiçbir zaman server’a bağlanmaz:

lnx02Bash
sudo systemctl daemon-reload
sudo systemctl enable --now wazuh-agent

Önce Parolasız: Server Kaydı Reddeder

Agent’ı server’da use_password açıldıktan sonra, ama agent’a parola dosyası koymadan başlattım. Agent kaydı denedi ve reddedildi. Agent’ın log’u, /var/ossec/logs/ossec.log:

lnx02Bash Çıktısı
2026/11/05 13:11:32 wazuh-agentd: INFO: No authentication password provided
2026/11/05 13:11:32 wazuh-agentd: ERROR: Invalid password. Unable to add agent (from manager)
2026/11/05 13:11:42 wazuh-agentd: INFO: No authentication password provided
2026/11/05 13:11:42 wazuh-agentd: ERROR: Invalid password. Unable to add agent (from manager)

Server aynı denemeleri kendi log’unda agent’ın adresiyle yazdı:

siem01Bash Çıktısı
2026/11/05 16:11:41 wazuh-authd: ERROR: Invalid password provided by 192.168.1.71. Closing connection.
2026/11/05 16:11:56 wazuh-authd: ERROR: Invalid password provided by 192.168.1.71. Closing connection.

İki log’un saatleri arasındaki üç saat bir fark değildir: lab’daki Ubuntu sunucusu log’u UTC ile, Wazuh sunucusu Türkiye saatiyle yazıyor. Agent pes etmez, birkaç saniyede bir yeniden dener. Kayıt parolası olmayan bir makinenin server’da bıraktığı iz de bu satırlardır: Invalid password provided by satırını sayan bir kural, ağda kaydolmaya çalışan yabancı bir makineyi gösterir.

Parola Dosyası ve Kabul

Agent parolayı kendi /var/ossec/etc/authd.pass dosyasından okur. Dosyaya server’daki authd.pass’in değeri yazılır, izni de belgedeki gibi 640 ve root:wazuh olur. İlk satır parolayı klavyeden okur. Değer ekrana basılmaz, komutun içinde geçmediği için kabuk geçmişine de düşmez:

lnx02Bash
read -rs -p 'Kayit parolasi: ' P; printf '%s\n' "$P" | sudo tee /var/ossec/etc/authd.pass > /dev/null; unset P
sudo chmod 640 /var/ossec/etc/authd.pass
sudo chown root:wazuh /var/ossec/etc/authd.pass
sudo systemctl restart wazuh-agent

Agent’ın log’unda kayıt bir saniyede bitti, bağlantı yirmi saniye sonra kuruldu:

lnx02Bash Çıktısı
2026/11/05 13:12:09 wazuh-agentd: INFO: Requesting a key from server: 192.168.1.47
2026/11/05 13:12:09 wazuh-agentd: INFO: Using password specified on file: etc/authd.pass
2026/11/05 13:12:09 wazuh-agentd: INFO: Using agent name as: lnx02
2026/11/05 13:12:09 wazuh-agentd: INFO: Waiting for server reply
2026/11/05 13:12:09 wazuh-agentd: INFO: Valid key received
2026/11/05 13:12:09 wazuh-agentd: INFO: Waiting 20 seconds before server connection
2026/11/05 13:12:29 wazuh-agentd: INFO: Trying to connect to server ([192.168.1.47]:1514/tcp).
2026/11/05 13:12:29 wazuh-agentd: INFO: (4102): Connected to the server ([192.168.1.47]:1514/tcp).

Yirmi saniyelik bekleme bir hata değildir. Server yeni anahtarı veri servisine birkaç saniyede okur, agent ona zaman tanır. Bu arada server’daki agent listesinde lnx02 Pending görünür, bağlantı kurulunca Active olur:

siem01Bash
sudo /var/ossec/bin/agent_control -l
siem01Bash Çıktısı
Wazuh agent_control. List of available agents:
   ID: 000, Name: siem01 (server), IP: 127.0.0.1, Active/Local
   ID: 001, Name: lnx02, IP: any, Active

Server’ın log’unda kayıt Agent key generated for 'lnx02' (requested by any) satırıyla geçti ve agent’ın grubu linux oldu. IP: any, agent’ın hangi adresten bağlanırsa bağlansın kabul edileceğini söyler. Bu davranış <auth> bloğundaki use_source_ip değerinin no olmasından gelir ve DHCP ile adres değiştiren istemciler için doğru olan da budur.

Kayıttan sonra /var/ossec/etc/ altındaki iki gizli dosyanın izinleri:

lnx02Bash Çıktısı
-rw-r----- 1 root  wazuh    33 Nov  5 13:12 authd.pass
-rw-r----- 1 wazuh wazuh    79 Nov  5 13:12 client.keys

client.keys agent’ın kalıcı anahtarıdır. Kayıt parolası ancak yeni bir kayıt için gerekir, ama authd.pass dosyası agent’ta kalırsa bir sonraki yeniden kurulum onu yine kullanır. Lab’da dosyayı yerinde bıraktım: iki dosyayı da yalnız root ve wazuh okuyabiliyor.

Agent Sürümünü Sabitlemek

Wazuh deposu açık kalırsa bir sonraki apt upgrade agent’ı server’dan yeni bir sürüme taşıyabilir, oysa belge uyumluluğu yalnız server’ın agent’tan yeni olduğu durumda garanti ediyor. Server tarafında aynı riski Wazuh kurulumu yazısında depoyu kapatarak gidermiştik. Agent’ta iki önlemi birlikte aldım: depo satırını yorum yaptım ve paketi hold’a aldım.

lnx02Bash
sudo sed -i "s/^deb /#deb /" /etc/apt/sources.list.d/wazuh.list
sudo apt-get update
sudo apt-mark hold wazuh-agent
dpkg -l wazuh-agent | tail -1
lnx02Bash Çıktısı
hi  wazuh-agent    4.14.9-1     amd64        Wazuh agent

Satırın başındaki hi, paketin kurulu (i) ve tutulu (h) olduğunu söyler. Yükseltme zamanı geldiğinde önce server yükseltilir, sonra agent’larda depo açılır ve apt-mark unhold ile paket serbest bırakılır.

Wazuh Windows Agent’ı GPO ile Toplu Dağıtmak

Windows’ta toplu dağıtım dört parçadan oluşur: MSI’ı ve kayıt parolasını tutan bir paylaşım, paylaşımdan kurulum yapan bir PowerShell betiği, betiği bilgisayar açılışında çalıştıran bir GPO ve GPO’nun bağlandığı OU.

Aynı yöntemi Zabbix agent dağıtımında da kullandık ve oradaki iki ölçüm burada da geçerli. Başlangıç betiği kullanıcı oturum açmadan, SYSTEM hesabıyla çalışır ve kullanıcının yönetici olması gerekmez. GPO’nun kendi yazılım dağıtımı (Software Installation) ise MSI’a komut satırı değişkeni veremez, nedenini orada anlattık. Wazuh’ta değişkenler server adresini, grubu ve kayıt parolasını taşır.

Wazuh agent'ın GPO ile dağıtımı. dc01'de iki yer var: SYSVOL'daki kurulum betiğini domain'deki her kullanıcı okur, MSI'ı ve kayıt parolasını tutan wazuh-agent$ paylaşımını yalnız bilgisayar hesapları okur. ankmuh01 açılırken başlangıç betiği SYSTEM hesabıyla çalışır, MSI'ı paylaşımdan sessiz kurar. Kurulan agent'ın parola ve anahtar dosyalarını yalnız SYSTEM ve yöneticiler okur. Agent siem01'e iki bağlantı açar: 1515'te kayıt olur ve kendi anahtarını alır, olayları 1514'ten bu anahtarla gönderir. Standart kullanıcı betiği okuyabilir, paylaşımı ve agent dosyalarını açamaz. dc01 ankmuh01 siem01 SYSVOL: kurulum betiği wazuh-agent$ paylaşımı Açılışta başlangıç betiği Kurulan agent 1515: kayıt 1514: olaylar okur: Authenticated Users MSI ve authd.pass okur: Domain Computers SYSTEM hesabıyla çalışır authd.pass, client.keys okur: SYSTEM, yöneticiler parola istenir, anahtar gelir agent'ın kendi anahtarıyla Parola betikte değil, yalnız bilgisayar hesaplarının okuduğu paylaşımda durur. Standart kullanıcı (ayse.demir) betiği okudu, paylaşımı ve agent dosyalarını açamadı. dc01'deki betiği herkes okur, MSI ve parolayı tutan paylaşımı yalnız bilgisayar hesapları okur. ankmuh01'de başlangıç betiği SYSTEM ile agent'ı kurar. Agent siem01'e 1515'te kaydolup anahtar alır, olayları 1514'ten gönderir. dc01 · SYSVOL: kurulum betiği dc01 · wazuh-agent$: MSI, authd.pass ankmuh01 · açılışta başlangıç betiği ankmuh01 · kurulan agent siem01 · 1515: kayıt siem01 · 1514: olaylar okur: Authenticated Users okur: Domain Computers SYSTEM hesabıyla, MSI'ı sessiz kurar authd.pass, client.keys: SYSTEM, yöneticiler parola sorulur, anahtar verilir agent'ın kendi anahtarıyla Parola betikte değil, paylaşımda durur. Standart kullanıcı betiği okudu, paylaşımı ve agent dosyalarını açamadı.
Dağıtımda parola iki yerde durur: paylaşımda ve kurulan agent'ın klasöründe. İkisini de standart kullanıcı açamaz, yalnız bilgisayarın kendi hesabı ve yöneticiler açar. Betiği herkes okur, bu yüzden parola betiğe yazılmaz. İki bağlantıyı da agent açar.

MSI’ı Doğrulamak

MSI Wazuh’un paket sunucusundan indirilir: https://packages.wazuh.com/4.x/windows/wazuh-agent-4.14.9-1.msi. Paylaşıma koymadan önce iki şey kontrol edilir: dosyanın hash’i Wazuh’un yayımladığıyla aynı mı, dosya Wazuh’un imzasını taşıyor mu? Kurumdaki her bilgisayar bu dosyayı SYSTEM yetkisiyle çalıştıracak.

Hash dosyası paketle aynı sunucuda, sürüme göre bir klasörde durur: https://packages.wazuh.com/4.x/checksums/wazuh/4.14.9/wazuh-agent-4.14.9-1.msi.sha512. Lab’da indirdiğim MSI’ın SHA512 hash’i bu dosyadakiyle aynıydı. Aynı klasörde .sha256 dosyası yok, adres 403 döndürüyor. Bu yüzden karşılaştırma SHA512 ile yapılır. PowerShell’de hash’i Get-FileHash cmdlet’i -Algorithm SHA512 ile, imzayı Get-AuthenticodeSignature verir. Lab’daki dosyanın imzası Valid çıktı: imzalayan CN="Wazuh, Inc", sertifikayı veren Microsoft’un kod imzalama otoritesi, sertifikanın bitiş tarihi (NotAfter) 10 Ekim 2026.

Bitiş tarihi geçmiş, ama imza yine geçerli. Sebebi imzanın zaman damgalı olmasıdır. Windows imzayı bugünün tarihine göre değil, imzalandığı ana göre doğrular ve o gün sertifika geçerliydi.

Paylaşım: MSI ve Parola Yalnız Bilgisayar Hesaplarına Açık

Başlangıç betiği ağa bilgisayarın kendi hesabıyla (ANKMUH01$) çıkar. Bu yüzden paylaşımı okuması gereken grup Domain Computers’tır. Lab’da paylaşımı dc01 üzerinde açtım, canlıda bir dosya sunucusu da olur. Yönetici PowerShell’de:

dc01PowerShellYönetici
$yol = 'C:\Dagitim\wazuh-agent'
New-Item -ItemType Directory -Path $yol -Force | Out-Null
New-SmbShare -Name 'wazuh-agent$' -Path $yol -ReadAccess 'SISTEMKUSU\Domain Computers' -FullAccess 'SISTEMKUSU\Domain Admins'
$dc = (Get-ADGroup 'Domain Computers').SID.Value
icacls $yol /inheritance:r /grant:r '*S-1-5-18:(OI)(CI)F' '*S-1-5-32-544:(OI)(CI)F' "*${dc}:(OI)(CI)RX"
  1. New-SmbShare: paylaşımı açar. Adın sonundaki $ paylaşımı ağ gezgininde gizler, bir güvenlik önlemi değildir.
  2. icacls ... /inheritance:r: klasörün devraldığı izinleri kaldırır ve üç girdi bırakır: SYSTEM ve yöneticiler tam yetki, Domain Computers okuma ve çalıştırma. Betik grubu adıyla değil, Get-ADGroup ile domain’den okuduğu SID’iyle verir.

Klasöre iki dosya konur: MSI ve server’daki authd.pass’in kopyası. İkisi de klasörün iznini devralır:

dc01PowerShell Çıktısı
C:\Dagitim\wazuh-agent\authd.pass SISTEMKUSU\Domain Computers:(I)(RX)
                                  BUILTIN\Administrators:(I)(F)
                                  NT AUTHORITY\SYSTEM:(I)(F)

Listede Authenticated Users yok, yani bir kullanıcı kendi hesabıyla bu dosyayı açamaz. SMB paylaşım izni ile klasör izninin nasıl birleştiğini ACL yazısında anlattık.

Başlangıç Betiği

Betik her açılışta çalışır. Agent kuruluysa ve sürümü yeterliyse hiçbir şey yapmadan çıkar. Değilse parolayı paylaşımdan belleğe okur, MSI’ı sessiz kurar, agent’taki authd.pass’in iznini daraltır ve servisin çalıştığından emin olur. Bir PowerShell betiği olarak wazuh-agent-kur.ps1 adıyla kaydedilir. Açıklama satırları Türkçe harf taşımaz, çünkü Windows PowerShell BOM’suz bir dosyayı ANSI kod sayfasıyla okur.

dc01PowerShell
# wazuh-agent-kur.ps1 : GPO bilgisayar baslangic betigi, Wazuh agent MSI dagitimi
# Betikte parola yok: kayit parolasi paylasimdaki authd.pass dosyasindan okunur.
$Surum = '4.14.9'
$Kaynak = '\\dc01.ad.sistemkusu.com\wazuh-agent$'
$Sunucu = '192.168.1.47'
$Grup = 'windows'
$Gunluk = 'C:\Windows\Temp\wazuh-agent-betik.log'
$MsiGunluk = 'C:\Windows\Temp\wazuh-agent-kurulum.log'
$Klasor = 'C:\Program Files (x86)\ossec-agent'

function Yaz($m) {
    Add-Content -Path $Gunluk -Value ("{0} {1}" -f (Get-Date -Format 'yyyy-MM-dd HH:mm:ss'), $m)
}

# 1. Kurulu mu, surum yeterli mi
$kayitlar = @(
    'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*',
    'HKLM:\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\*'
)
$kurulu = Get-ItemProperty $kayitlar -ErrorAction SilentlyContinue |
    Where-Object { $_.DisplayName -like 'Wazuh Agent*' } | Select-Object -First 1
if ($kurulu) {
    $v = $null
    try { $v = [version]$kurulu.DisplayVersion } catch { }
    if ($v -and ($v -ge [version]$Surum)) {
        Yaz ("Kurulu ({0}), atlandi" -f $kurulu.DisplayVersion)
        exit 0
    }
    Yaz ("Kurulu surum {0}, hedef {1}: kurulum denenecek" -f $kurulu.DisplayVersion, $Surum)
}

# 2. Paylasima erisim
$Msi = Join-Path $Kaynak ("wazuh-agent-{0}-1.msi" -f $Surum)
$ParolaDosya = Join-Path $Kaynak 'authd.pass'
if (-not (Test-Path $Msi) -or -not (Test-Path $ParolaDosya)) {
    Yaz ("Paylasima erisilemedi: {0}" -f $Kaynak)
    exit 1
}

# 3. Parolayi bellege oku (dosyaya ya da gunluge yazilmaz)
$parola = (Get-Content -Path $ParolaDosya -TotalCount 1).Trim()

# 4. Kurulum
$arg = '/i "{0}" /q /l*v "{1}" WAZUH_MANAGER={2} WAZUH_REGISTRATION_SERVER={2} WAZUH_REGISTRATION_PASSWORD="{3}" WAZUH_AGENT_GROUP={4}' -f $Msi, $MsiGunluk, $Sunucu, $parola, $Grup
$p = Start-Process -FilePath 'msiexec.exe' -ArgumentList $arg -Wait -PassThru
$parola = $null
Yaz ("msiexec cikis kodu: {0}" -f $p.ExitCode)

# 5. Servis durumu kurulumdan hemen sonra
$s = Get-Service -Name 'WazuhSvc' -ErrorAction SilentlyContinue
if ($s) { Yaz ("WazuhSvc durum: {0}, baslangic turu: {1}" -f $s.Status, $s.StartType) } else { Yaz 'WazuhSvc yok' }

# 6. authd.pass izinleri: daraltmadan once ve sonra
$AuthdPass = Join-Path $Klasor 'authd.pass'
if (Test-Path $AuthdPass) {
    Yaz 'authd.pass icacls (once):'
    (icacls $AuthdPass) | ForEach-Object { if ($_) { Yaz ("  " + $_) } }
    icacls $AuthdPass /inheritance:r /grant:r '*S-1-5-18:F' '*S-1-5-32-544:F' | Out-Null
    Yaz 'authd.pass icacls (sonra):'
    (icacls $AuthdPass) | ForEach-Object { if ($_) { Yaz ("  " + $_) } }
} else {
    Yaz 'authd.pass kurulum klasorunde yok'
}

# 7. Servis calismiyorsa baslat
$s = Get-Service -Name 'WazuhSvc' -ErrorAction SilentlyContinue
if ($s -and $s.Status -ne 'Running') {
    try { Start-Service -Name 'WazuhSvc' -ErrorAction Stop; Yaz 'Start-Service basarili' }
    catch { Yaz ("Start-Service hata: {0}" -f $_.Exception.Message) }
    $s = Get-Service -Name 'WazuhSvc' -ErrorAction SilentlyContinue
    if ($s) { Yaz ("WazuhSvc durum (son): {0}" -f $s.Status) }
}
exit $p.ExitCode
  1. Kurulu sürüm kontrolü: MSI 32 bitlik bir paket olduğu için kaydı 64 bitlik Windows’ta WOW6432Node altında durur. Betik iki yere de bakar. Sürüm yükseltmesi $Surum satırını değiştirmek ve yeni MSI’ı paylaşıma koymaktır.
  2. Parola bellekte: betik parolayı paylaşımdaki dosyadan okur, msiexec’e verir ve değişkeni boşaltır. Kendi log’una parolayı yazmaz.
  3. WAZUH_REGISTRATION_SERVER: belgeye göre boş bırakılırsa WAZUH_MANAGER kullanılır. Betikte açıkça yazdım, çünkü server ileride bir kümeye dönerse kayıt adresi ile veri adresi ayrılabilir.
  4. /l*v: MSI’ın ayrıntılı log’u. İlk dağıtım turunda hatanın nedenini o gösterir, ama bir bedeli var: aşağıda ölçtüm.

GPO: Bilgisayar Başlangıç Betiği

GPO, istemcilerin durduğu OU’ya bağlanır. Lab’da bu OU Tier 2 → Ankara → Bilgisayarlar. GPMC’de (Win + R → gpmc.msc) OU’ya sağ tıklayıp Create a GPO in this domain, and Link it here seçilir ve GPO’ya adlandırma standardımıza göre bir ad verilir: PC_WAZUH_AGENT. GPO yalnız bilgisayar ayarı taşıdığı için Details sekmesinde GPO Status User configuration settings disabled yapılır.

GPMC'de PC_WAZUH_AGENT GPO'sunun Scope sekmesi: bağlı olduğu yer Tier 2/Ankara/Bilgisayarlar OU'su, Security Filtering'de Authenticated Users
GPO yalnız istemcilerin durduğu OU'ya bağlı. Domain Controllers OU'su kapsamın dışında kalır.

Betik GPO düzenleyicide eklenir. GPMC’de PC_WAZUH_AGENT’a sağ tıklayıp Edit seçilir, ardından Computer Configuration → Policies → Windows Settings → Scripts (Startup/Shutdown) → Startup → Properties. Pencerede PowerShell Scripts sekmesine geçilir, Show Files ile açılan klasöre wazuh-agent-kur.ps1 kopyalanır, Add ile betik seçilir.

Startup Properties penceresinin PowerShell Scripts sekmesi: listede wazuh-agent-kur.ps1, parametre alanı boş
Betik PowerShell Scripts sekmesine eklenir. Parametre alanı boş kalır, çünkü kayıt parolası betiğe ya da GPO'ya yazılmaz.

GPMC betiğin kaydını GPO’nun SYSVOL’daki klasöründe psscripts.ini dosyasına yazar:

dc01INI
[Startup]
0CmdLine=wazuh-agent-kur.ps1
0Parameters=

Lab’da OU’da beş GPO vardı ve PC_WAZUH_AGENT altıncı sıraya bağlandı. Sıra burada önemli değil, çünkü öteki GPO’larla aynı ayara dokunmuyor.

Betiği Herkes Okur, Parolayı Yalnız Bilgisayar

Kayıt parolasının betiğe yazılmamasının sebebini lab’da ölçtüm. ankmuh01’de standart bir kullanıcıyla (ayse.demir) oturum açtım ve dört şeyi okumayı denedim:

  1. SYSVOL’daki betik: okundu, 73 satırın hepsi. GPO klasörlerinde Authenticated Users okuma iznine sahiptir, yani domain’deki her kullanıcı her GPO’nun betiğini okur. Betiğe yazılan bir kayıt parolası kurumdaki herkese verilmiş olur.
  2. wazuh-agent$ paylaşımı: Access is denied. Paylaşımı yalnız bilgisayar hesapları okuyor.
  3. İstemcideki authd.pass: Access is denied.
  4. İstemcideki client.keys ve ossec.conf: ikisinde de Access is denied. Kullanıcı agent klasörünün içindeki alt klasörlerin adlarını listeleyebildi, dosyaları açamadı.

İlk Açılış: Betik Ne Yazdı?

GPO bağlandıktan sonra istemcinin yeniden başlatılması yeter. Bilgisayar açılışta GPO’yu okur ve başlangıç betiğini oturum açma ekranı gelmeden çalıştırır. Açılıştan sonra yönetici komut isteminde:

ankmuh01CMDYönetici
gpresult /r /scope computer

Applied Group Policy Objects listesinde PC_WAZUH_AGENT görünmelidir. Betiğin kendi log’u C:\Windows\Temp\wazuh-agent-betik.log. Lab’daki istemcide ilk açılıştan ve sonraki bir açılıştan kalan satırlar:

ankmuh01Çıktı
2026-11-05 16:31:46 msiexec cikis kodu: 0
2026-11-05 16:31:47 WazuhSvc durum: Stopped, baslangic turu: Automatic
2026-11-05 16:31:47 authd.pass icacls (once):
2026-11-05 16:31:47   C:\Program Files (x86)\ossec-agent\authd.pass NT AUTHORITY\SYSTEM:(I)(F)
2026-11-05 16:31:47                                                 BUILTIN\Administrators:(I)(F)
2026-11-05 16:31:47 authd.pass icacls (sonra):
2026-11-05 16:31:47   C:\Program Files (x86)\ossec-agent\authd.pass BUILTIN\Administrators:(F)
2026-11-05 16:31:47                                                 NT AUTHORITY\SYSTEM:(F)
2026-11-05 16:31:48 Start-Service basarili
2026-11-05 16:31:48 WazuhSvc durum (son): Running
2026-11-05 16:42:35 Kurulu (4.14.9), atlandi

Satırlar üç şey söylüyor:

  1. Kurulum yarım dakika kadar sürdü. Makine açıldıktan yarım dakika kadar sonra msiexec sıfır koduyla çıktı.
  2. MSI servisi kurdu ama başlatmadı. Servis Automatic başlangıçla ama Stopped durumda bırakıldı, betiğin son adımı onu başlattı. Bu adım olmasaydı agent ancak bir sonraki açılışta çalışacaktı.
  3. authd.pass zaten dar geliyor. Daraltmadan önce de dosyayı yalnız SYSTEM ve yöneticiler okuyabiliyordu. Dosya bu izni agent klasöründen devralıyor: MSI klasörde Authenticated Users’a yalnız klasörün kendisi için okuma veriyor, içindeki dosyalara SYSTEM ve yöneticilerden başka kimse girmiyor. Betiğin daraltma adımı devralmayı kesip aynı iki satırı bırakıyor. Zarar vermiyor ve bir sonraki sürümün varsayılanı değişirse güvence oluyor, ama Zabbix’teki gibi zorunlu bir düzeltme değil.

Makinede güvenlik duvarında Wazuh adlı kural yoktu. MSI’ın yazdığı ossec.conf dosyasının <enrollment> bloğunda server adresi, grup ve parola dosyasının yolu duruyordu:

ankmuh01Yapılandırma
<enrollment>
  <enabled>yes</enabled>
  <manager_address>192.168.1.47</manager_address>
  <authorization_pass_path>authd.pass</authorization_pass_path>
  <groups>windows</groups>
</enrollment>

Server Kapalıyken Agent Ne Yapar?

Lab’ın ilk turunda Wazuh server’ı kapalıydı, agent kurulduğu anda bağlanacak bir yer bulamadı. Agent’ın log’u C:\Program Files (x86)\ossec-agent\ossec.log dosyasındadır ve kaydı yirmi saniye kadar arayla yeniden denedi:

ankmuh01Çıktı
2026/11/05 16:32:12 wazuh-agent: ERROR: (1208): Unable to connect to enrollment service at '[192.168.1.47]:1515'
2026/11/05 16:32:12 wazuh-agent: INFO: Requesting a key from server: 192.168.1.47
2026/11/05 16:32:33 wazuh-agent: ERROR: (1208): Unable to connect to enrollment service at '[192.168.1.47]:1515'
2026/11/05 16:32:38 wazuh-agent: INFO: Requesting a key from server: 192.168.1.47
2026/11/05 16:32:59 wazuh-agent: ERROR: (1208): Unable to connect to enrollment service at '[192.168.1.47]:1515'

Bu, server’a ulaşamayan bir agent’ın tipik görüntüsüdür: kurulum başarılı, servis çalışıyor, ama makine server’ın listesinde yok. Sebep server’ın kapalı olması, 1515’in güvenlik duvarında kapalı olması ya da adresin yanlış yazılması olabilir. Agent pes etmez, server ulaşılır olduğunda kaydı kendisi tamamlar.

Wazuh Agent Doğrulama: Kayıt ve İlk Veri

Server açıldıktan sonra ankmuh01’i yeniden başlattım. Agent, betiğin kurduğu yapılandırmayla ve kendi authd.pass dosyasıyla kaydını tamamladı. Agent’ın log’u:

ankmuh01Çıktı
2026/11/05 18:07:26 wazuh-agent: INFO: Requesting a key from server: 192.168.1.47
2026/11/05 18:07:26 wazuh-agent: INFO: Using password specified on file: authd.pass
2026/11/05 18:07:26 wazuh-agent: INFO: Using agent name as: ankmuh01
2026/11/05 18:07:26 wazuh-agent: INFO: Waiting for server reply
2026/11/05 18:07:26 wazuh-agent: INFO: Valid key received
2026/11/05 18:07:26 wazuh-agent: INFO: Waiting 20 seconds before server connection
2026/11/05 18:07:46 wazuh-agent: INFO: Trying to connect to server ([192.168.1.47]:1514/tcp).
2026/11/05 18:07:46 wazuh-agent: INFO: (4102): Connected to the server ([192.168.1.47]:1514/tcp).

Server aynı kaydı agent’ın adresiyle yazdı. İki makinenin saati aynı saat diliminde olduğu için satırlar bir saniye arayla örtüşüyor:

siem01Bash Çıktısı
2026/11/05 18:07:27 wazuh-authd: INFO: Received request for a new agent (ankmuh01) from: 192.168.1.117
2026/11/05 18:07:27 wazuh-authd: INFO: Agent key generated for 'ankmuh01' (requested by any)

Sanal makinenin açılmasından kayda kadar 37 saniye geçti. Agent’ın adı küçük harfle ankmuh01 geldi, Windows’un bilgisayar adı büyük harfle ANKMUH01 olduğu halde. Server’da agent’ın grubu ve listedeki durumu:

siem01Bash
sudo /var/ossec/bin/agent_control -l
sudo /var/ossec/bin/agent_groups -s -i 002
siem01Bash Çıktısı
Wazuh agent_control. List of available agents:
   ID: 000, Name: siem01 (server), IP: 127.0.0.1, Active/Local
   ID: 001, Name: lnx02, IP: any, Disconnected
   ID: 002, Name: ankmuh01, IP: any, Active

The agent 'ankmuh01' with ID '002' belongs to groups: windows.

lnx02’nin Disconnected görünmesi bir hata değil: o makine bu ölçüm sırasında kapalıydı. Kayıt bir kez yapıldığı için açıldığında yeniden kayıt istemez, client.keys’teki anahtarla doğrudan bağlanır.

Kayıttan kırk saniye sonra agent’ın log’una Agent is reloading due to shared configuration changes satırı düştü ve agent bir kez yeniden başladı. Sebep grup: agent windows grubunun yapılandırmasını server’dan ilk kez aldı ve onu uygulamak için kendini yeniden başlattı. Linux agent’ı da kayıttan sonra aynı satırı yazmıştı. Bu yeniden başlama her yeni agent’ta bir kez görülür.

Dashboard’da Agent Listesi

Dashboard’da agent’lar Endpoints ekranında listelenir. Üstteki üç halka agent’ları duruma, işletim sistemine ve gruba göre sayar, altındaki tabloda her agent’ın grubu, sürümü ve durumu durur.

Wazuh dashboard Endpoints ekranı: Agents (2), lnx02 linux grubunda disconnected, ankmuh01 windows grubunda active, ikisi de v4.14.9
Tablo, agent_control -l çıktısındaki bilgiyi gruplarla birlikte gösterir. Durum sütunu her sabah bakılacak yerdir.

Tablonun IP sütunu agent’ın son bağlandığı adresi gösterir (192.168.1.117), agent_control’deki any ise kaydın hangi adresten kabul edileceğidir. İki değer farklı şeyleri söyler.

Deploy New Agent Sihirbazı Parolayı Bilir

Endpoints ekranındaki Deploy new agent düğmesi, tek bir makine için kurulum komutu üreten bir sihirbaz açar. İşletim sistemi, server adresi, agent adı ve grup seçilince sihirbaz Windows için bir PowerShell satırı yazar: MSI’ı indirir ve bu yazıdaki değişkenlerle kurar.

Wazuh Deploy new agent sihirbazı: agent adı ankmuh01, grup windows, 4. adımdaki komutta WAZUH_REGISTRATION_PASSWORD yıldızlı, altında Show password anahtarı kapalı
Sihirbaz server'daki kayıt parolasını okuyup komuta koyar. Yıldızlar yalnız ekrandadır.

Komuttaki WAZUH_REGISTRATION_PASSWORD yıldızlı görünür ve altında Show password anahtarı vardır. Yani sihirbaz server’daki kayıt parolasını okuyup komuta kendisi koyar. Bunun iki sonucu var:

  1. Bu ekrana erişen her dashboard hesabı kayıt parolasını görebilir. Anahtarı açmak yeter. Dashboard hesaplarını kimin kullandığı, kayıt parolasını kimin bildiği demektir.
  2. Sihirbazın komutu tek makine içindir. Komut parolayı komut satırına yazar, PowerShell geçmişine ve ekran kayıtlarına düşer. Toplu dağıtımda parolayı paylaşımdan okuyan betik kullanılır.

Sihirbazın uyarısı da kaydedilmeye değer: agent adı benzersiz olmalı ve kayıttan sonra değiştirilemez. Adı değişen bir bilgisayar için yeni bir kayıt gerekir.

Kurulum Bitti, İzleme Başlıyor: Yeni Makine Kendiliğinden Kaydolur

Kurulumun asıl kazancı ertesi günlerde görünür. Muhasebeye yeni bir bilgisayar geldiğinde teknisyen onu domain’e katar ve Bilgisayarlar OU’suna taşır. Bilgisayar ilk yeniden başlatmada GPO’yu alır, betik agent’ı kurar, agent server’a parolayla kaydolur ve windows grubunun yapılandırmasını alır. Wazuh arayüzünü kimse açmaz.

Güvenlik izlemesine bakan kişi her sabah Endpoints ekranındaki durum halkasına bakar. Server bir agent’tan 15 dakika haber alamazsa onu disconnected sayar: bu süre server’daki agents_disconnection_time ayarının fabrika değeridir. disconnected bir istemci kapalı bir bilgisayar olabilir, ama aylardır kopuk bir sunucu izlenmeyen bir sunucudur. Kurumdan ayrılan bir bilgisayarın agent kaydı kendiliğinden silinmez. O kaydı dashboard’dan ya da server’da manage_agents ile silmek yöneticinin işidir.

İlk kazanç kayıtta bile görünür. Agent kaydolduğu anda Wazuh’un fabrika ayarındaki yetenekleri çalışmaya başlar: Windows’ta Application, Security ve System log’ları okunur, dosya bütünlüğü izlemesi C:\Windows altındaki kritik araçlara ve hosts dosyasına bakar, yapılandırma denetimi, kar amacı gütmeyen Center for Internet Security’nin (CIS) yazdığı bir policy’yi yükler. Lab’daki Windows 11 istemcide agent, kurulumdan dört saniye sonra cis_win11_enterprise.yml policy’sini yükleyip ilk taramayı başlattı. Bu yeteneklerin hangi sırayla ayarlanacağını Wazuh rehberinde adım adım sıraladık.

Wazuh Agent Kurulumunda Sık Yapılan Hatalar

  1. Agent kurulu ama server’ın listesinde yok. Linux’ta paket servisi başlatmaz: systemctl is-active wazuh-agent inactive diyorsa systemctl enable --now wazuh-agent eksiktir. Servis çalışıyorsa agent’ın log’unda Unable to connect to enrollment service arayın: server’a ya da 1515’e ulaşılamıyordur.

  2. Agent’ın log’unda Invalid password. Unable to add agent. Agent’ta authd.pass yok ya da değeri server’dakiyle aynı değil. Server’da aynı anda Invalid password provided by satırı agent’ın adresini verir.

  3. Agent default grubunda kaldı. WAZUH_AGENT_GROUP verilmemiş. Grup sonradan agent_groups -a -i {ID} -g windows ile atanır, agent yapılandırmayı alıp yeniden başlar.

  4. Bir apt upgrade agent’ı server’dan yeni sürüme taşıdı. Belge yalnız server’ın agent’la aynı sürümde ya da ondan yeni olduğu düzeni destekler. Lab’da yama farkında 4.14.9 server 4.14.10 agent’ı kabul etti ve ne alarm ne log satırı üretti, yani ters sürüm sessiz oluşur. Daha büyük bir sürüm farkı ölçülmedi. dpkg -l wazuh-agent satırı hi ile başlamıyorsa paket tutulu değildir. Ölçümü Wazuh güncellemesi yazımızda anlattık.

  5. Kayıt parolası betiğin içinde. SYSVOL’daki her betiği domain’deki her kullanıcı okur. Parola yalnız Domain Computers’ın okuyabildiği paylaşımda durur.

  6. Kayıt parolası dashboard’dan sızıyor. Deploy new agent sihirbazı parolayı komuta koyar, Show password onu gösterir. Bu ekrana erişen her dashboard hesabı parolayı bilir.

Sonuç: Wazuh Agent Kurulumu Kayıt Kapısını Kapatmakla Başlar

Wazuh agent’ı bir makineye kurmak tek bir komuttur, yüz makineye kurmak bir GPO ve bir betik ister. Kurulumu güvenli kılan şey ise kaydın kime açık olduğudur: fabrika ayarında herkese, parolayla yalnız parolayı bilen makineye.

Lab’da beş şey beklenenden farklı çıktı:

  1. Server, fabrika ayarında parola sormadan anahtar veriyor ve log’una bunu açıkça No password required diye yazıyor.
  2. Linux paketi servisi başlatmıyor, kurulum hatasız bittiği halde agent hiç bağlanmıyor.
  3. Windows MSI’ı servisi Automatic kuruyor ama başlatmıyor. Betiğin son adımı olmasa agent bir sonraki açılışı beklerdi.
  4. MSI’ın ayrıntılı log’u kayıt parolasını düz metin taşıyor, Zabbix MSI’ının maskelediği komut satırı satırında bile.
  5. Dashboard’un Deploy new agent sihirbazı kayıt parolasını biliyor ve Show password ile ekranda gösteriyor.

Girişteki benzetmeye dönersek: akıllı sayaç Wazuh agent’tır, abone numarası client.keys’teki anahtardır. Tanıtma kodu sormayan arıza merkezi fabrika ayarındaki use_password no ayarıdır, montaj ekibine verilen kod da kayıt parolasıdır. Mahalleyi tek günde dolaşan montaj ekibi GPO’nun başlangıç betiğidir. Kod sayacın kapağına yazılmaz, yani parola SYSVOL’daki betikte değil, yalnız bilgisayarların okuyabildiği paylaşımda durur.

Sırada agent’ların topladığını anlamlı kılmak var: Windows’ta hangi olayların Security log’una yazılacağını belirleyen audit policy ve ağ cihazlarından gelen syslog. Güvenlik izlemenin bir hizmet olarak nasıl yürüdüğünü SIEM hizmeti sayfamızda anlattık.

Wazuh Agent Hakkında Sık Sorulan Sorular

İki port, ikisinde de bağlantıyı agent açar. Agent ilk açılışta server'ın 1515/TCP portuna bağlanıp kaydını yapar ve bir anahtar alır. Sonra bütün veriyi 1514/TCP üzerinden gönderir. Agent'a dışarıdan bağlantı gelmez, bu yüzden istemcide gelen bağlantı kuralı gerekmez. Lab'da Windows MSI'ı güvenlik duvarına hiç kural yazmadı. Server'daki 55000 portu API içindir, parolalı kayıtta agent'lar ona bağlanmaz.
Server'ın adresine ulaşabilen her makine kendini agent olarak kaydettirir. Lab'da fabrika ayarındaki server, parola sormadan bir deneme agent'ına anahtar verdi ve log'una No password required yazdı. Kayıtlı sahte bir agent server'a istediği olayı gönderebilir ve agent listesini kirletir. Kaydı parolaya bağlamak server'da tek satır ve bir dosyadır, agent'lar kurulmadan önce yapılır.
Yöneticinin işi bir kez yapılır: paylaşımı, betiği ve GPO'yu hazırlamak bir iki saattir. Sonra her bilgisayar bir sonraki açılışında agent'ı kendisi kurar. Lab'daki istemcide makinenin açılmasından betiğin kurulumu bitirmesine kadar kırk saniye geçti. Asıl bekleme bilgisayarların yeniden başlatılmasıdır: sabah açılan makine o gün listededir.
İlker Pehlivan
Yazan

BT Danışmanı | Ağ, Sistem ve Güvenlik Yönetimi

İlker Pehlivan, karmaşık BT altyapılarını ölçeklenebilir ve güvenli sistemlere dönüştürür. Buradaki rehberleri kendi laboratuvarında kurup ölçerek yazar.

LinkedIn

Benzer Makaleler

Wazuh Rehberi: Kurulumdan Alarma Adım Adım SIEM

Wazuh rehberi: kurulumdan agent'a, Windows log'undan e-posta alarmına on dört adımlık sıra. Her adım hangi kurumda gerekir, fabrika ayarı ne, lab'da ne ölçtük.

16 dk okuma

SIEM Hizmeti: Yönetilen Güvenlik İzleme ve Müdahale

SIEM hizmeti: domain controller, firewall, VPN ve sunucu logları tek yerde toplanır, kurallarla okunur, şüpheli olayda aynı ekip müdahale eder. Kapsam ve fiyat.

10 dk okuma

Wazuh Active Response: Otomatik Engelleme ve Muafiyet

Wazuh active response: SSH ve Windows brute force kaynağını firewall-drop ve netsh ile süreli engellemek, white_list ve kural seçimi, lab ölçümüyle.

23 dk okuma

Wazuh Health Check: Servis, Indexer ve Kopan Agent

Wazuh health check: wazuh-control status, indexer kümesinin rengi, Filebeat, disk, kopan agent alarmı ve e-posta eşiği, günlük ve haftalık liste, lab ölçümüyle.

18 dk okuma

Wazuh Upgrade: Yedek, Sıra ve Agent Yükseltmesi

Wazuh upgrade adım adım: yedeğin içini doğrulamak, indeks snapshot'ı, indexer, manager, Filebeat ve dashboard sırası, kesinti ve eski agent'lar, lab ölçümüyle.

23 dk okuma

Wazuh Active Directory İzleme: DC Olayından Alarma

Wazuh ile Active Directory izleme: domain controller'a agent, hazır Windows kurallarının seviyeleri, kilit zinciri, frekans eşiği ve özel kural, lab ölçümüyle.

22 dk okuma