BT Danışmanlık

GLPI Agent GPO ile Dağıtım: Başlangıç Betiği ve Parola

GLPI Agent GPO ile dağıtım: resmi VBS betiği açılışta MSI'ı kurar ve ayarı her açılışta yeniden yazar. Betik SYSVOL'de değil, kapalı paylaşımda durur.

İlker Pehlivan

GLPI Agent GPO ile dağıtım, agent’ı etki alanındaki Windows bilgisayarlara tek tek değil, bir Group Policy’nin bilgisayar başlangıç betiğiyle kurar. Betik GLPI Agent projesinin kendi dosyasıdır: glpi-agent-deployment.vbs. Bilgisayar açılırken SYSTEM hesabıyla çalışır ve MSI’ı bir paylaşımdan kurar. Kurulumla birlikte sunucu adresini, envanter kullanıcısını ve etiketi de verir. Agent zaten kuruluysa aynı ayarları her açılışta yeniden yazar.

Bu yazı GLPI rehberimizin 8. adımıdır. Ölçümler etki alanı denetleyicisi dc01, Windows 11 istemcisi ankmuh01 ve GLPI 12.0.1 sunucusu itsm01 üzerinde, GLPI Agent 1.21 ile yapıldı. Paylaşımı ve betiği hazır olan okur doğrudan dağıtım betiğine geçebilir.

GLPI agent yazımızda agent’ı tapu ve kadastro dairesinin sahaya çıkan kadastro ekibine, envanter parolasını da ekibin cebindeki kimlik kartına benzettik. Başlangıç betiği dairenin sabah görev emridir, Group Policy de emrin her sabah ekibe ulaşmasını sağlayan düzendir. Ekip her sabah emri okur. Emir ekibe hangi mahalleye gideceğini söyler ve kimlik kartını da verir. Emir dairenin ilan panosuna asılırsa kartın bir kopyasını panonun önünden geçen herkes alır. Bu yüzden emir panoya değil, yalnız ekiplerin açabildiği kilitli dolaba konur.

GLPI Agent GPO benzetmesi: tapu ve kadastro dairesinin şafakta uzun giriş koridoru, solda sokağa açık girişin yanında üzerine kağıtlar iğnelenmiş ilan panosu ve önünden geçip sokağa yürüyen yeşil paltolu biri, ortada boş koridor, sağda kilidinde pirinç anahtar duran meşe dolabın açık kapağının iç yüzünde kordonlu kimlik kartları, dolabın rafından katlanmış görev emrini alan mavi ceketli kadastrocu ve duvara yaslanmış ölçü sehpası
Görev emri başlangıç betiğidir, emirle birlikte verilen kimlik kartı envanter parolasıdır. İlan panosu SYSVOL'dür ve önünden geçen her kullanıcı okur. Bu yüzden parolayı taşıyan betik, yalnız bilgisayar hesaplarının okuyabildiği paylaşıma, yani kilitli dolaba konur.

GLPI Agent GPO ile Nasıl Dağıtılır?

Dağıtım beş adımlık bir zincirdir. İlk ikisi Group Policy’nin, son üçü dağıtım betiğinin işidir:

  1. GPO bilgisayarları seçer. GPO bilgisayarların durduğu OU’ya bağlanır. Güvenlik süzgeci de OU’daki hangi bilgisayarların onu uygulayacağını belirler.
  2. Bilgisayar açılırken betiği çalıştırır. Başlangıç betiği kullanıcı oturum açmadan, bilgisayarın SYSTEM hesabıyla çalışır. Ağa da bilgisayarın kendi hesabıyla çıkar, örneğin ANKMUH01$.
  3. Betik kurulu sürüme bakar. Kayıt defterindeki HKLM\SOFTWARE\GLPI-Agent\Installer\Version değerini kendi sürümüyle karşılaştırır. Agent yoksa ya da sürüm farklıysa MSI’ı kurar.
  4. Sürüm aynıysa ayarları yeniden yazar. Reconfigure ayarı Yes ise MSI’ı REINSTALL=feat_AGENT ile yeniden çalıştırır. Sunucu adresi, kullanıcı, parola ve etiket kayıt defterine yeniden yazılır.
  5. Agent envanteri gönderir. Agent servis olarak başlar ve envanteri etiketle birlikte GLPI’a gönderir.

Agent’ın kendisi, envanter kullanıcısı ve tek bilgisayara elle kurulum GLPI agent yazımızın konusudur. Bu yazı aynı kurulumu filoya yayan mekanizmayı anlatır. Etiketten konum atayan kurallar ise GLPI envanter kuralları yazısındadır.

GLPI Agent Dağıtımı Nasıl Olmalı?

Hedef durum beş kaynaktan çıkıyor:

  1. GLPI Agent kurulum belgesi (Large Installations): toplu kurulum için projenin glpi-agent-deployment.vbs betiği verilir. Belgeye göre betiği bir bilgisayar GPO’sunda başlangıçta çalıştırmak genellikle daha iyi sonuç verir, çünkü bazı kullanıcıların kurulum yetkisi yoktur. MSI’ın bulunduğu yere betiği çalıştıracak her bilgisayar erişebilmelidir.
  2. GLPI Agent Windows kurulum belgesi (Command-line parameters): REINSTALL=feat_AGENT yalnız agent’ın ayarını aynı kurulum paketiyle değiştirmek için kullanılır. Komut satırında verilen değer kurulu agent’ın değerinin önüne geçer. PASSWORD yalnız SERVER verildiğinde işe yarar. Özellik adları büyük küçük harfe duyarlıdır ve = işaretinin iki yanında boşluk olmaz.
  3. Dağıtım betiğinin kendi açıklamaları (glpi-agent-deployment.vbs, 1.21): MSI’ın yeri bir HTTP ya da HTTPS adresi ya da bir UNC yolu olabilir. SetupOptions içinde tırnak gereken değer tek tırnakla yazılır, çift tırnak UNC yollarında çalışmaz.
  4. Microsoft, betik hatası belgesi (Event ID 1130): başlangıç betiğini bilgisayar hesabı okur ve çalıştırır. Bilgisayarın dosyada Read and Execute izni olmalıdır. Betik bir ağ paylaşımındaysa paylaşımda Read izni de gerekir.
  5. Wazuh agent dağıtımındaki ölçümümüz (SYSVOL’ü kim okur): aynı etki alanında standart bir kullanıcı SYSVOL’deki GPO betiğini satır satır okudu. GPO klasörlerinde Authenticated Users okuma iznine sahiptir.
KararHedefNeden
Dağıtım yoluBilgisayar GPO’sunda başlangıç betiğiSYSTEM ile çalışır, kullanıcının kurulum yetkisi gerekmez
BetikGLPI Agent’ın glpi-agent-deployment.vbs’i, agent ile aynı sürümSürüm karşılaştırmasını ve yeniden yapılandırmayı betik yapar
Betiğin ve MSI’ın yeriYalnız Domain Computers’ın okuyabildiği bir paylaşımBetik envanter parolasını düz metin taşır. SYSVOL’ü her kullanıcı okur
KapsamÖnce pilot grup, güvenlik süzgeciyleHatalı bir betik tek bilgisayarda görünür, filoda değil
ReconfigureYesParola, etiket ya da sunucu değişikliği bir sonraki açılışta her bilgisayara yayılır
Envanter kullanıcısıYalnız envanter için, başka yerde kullanılmayan bir ad ve parolaParola betikte ve istemcinin kayıt defterinde düz metin durur
GPO’nun kullanıcı yarısıKapalı (User configuration settings disabled)GPO yalnız bilgisayar ayarı taşır, istemci boş yarıyı taramaz
Software InstallationKullanılmazMSI’a özellik veremez, ayarlar ancak bir .mst dosyasıyla gider

Software Installation’ın neden yetmediğini Microsoft’un belgesiyle Zabbix agent yazısında anlattık. GLPI Agent’ta da sunucu adresi, envanter kullanıcısı, parola ve etiket MSI’a özellik olarak verilir.

GLPI 11’den beri agent parola yerine bir OAuth istemci kimliği ve gizli anahtarıyla da kimlik doğrulayabiliyor. MSI’da bu iki değer OAUTH_CLIENT_ID ve OAUTH_CLIENT_SECRET özellikleridir ve MSI 1.10’dan beri vardır. Belgeye göre istemci GLPI’da Client credentials izniyle ve inventory kapsamıyla açılır. Bu yazıdaki ölçümler temel kimlik doğrulamasıyla yapıldı. OAuth’ta betikte yalnız iki özellik değişir: USER ve PASSWORD yerine OAUTH_CLIENT_ID ve OAUTH_CLIENT_SECRET yazılır. Gizli anahtar da parola gibi betikte durur, bu yüzden betiğin yeri için aşağıdaki kural onda da geçerlidir.

Ön Koşul: Envanter Kimliği, Etki Alanı ve MSI

Dağıtımdan önce dört şey hazırdır:

  1. GLPI envanter kabul ediyor. Envanter açık, agent kimlik doğrulaması Temel kimlik doğrulaması ve envanter kullanıcısı tanımlı. Üçü de rehberin 7. adımında kurulur.
  2. Bilgisayarlar bir OU’da duruyor. GPO bir OU’ya bağlanır, bu yüzden hedef bilgisayarlar dağınık değil, bir OU altında toplanmıştır. Lab’da bu OU Tier 2 → Ankara → Bilgisayarlar. GPO’nun yapısı, bağlanması ve kapsamı GPO yönetimi yazısının konusudur.
  3. Bilgisayarlar GLPI’ın sertifikasına güveniyor. Agent HTTPS ile bağlanır ve sertifikayı Windows’un deposundan doğrular. Etki alanındaki bilgisayarlar iç sertifika otoritesinin kök sertifikasını zaten taşır. Sertifikanın kendisi GLPI HTTPS yazısındadır.
  4. MSI ve betik aynı sürümde. GLPI-Agent-1.21-x64.msi GLPI Agent’ın GitHub sürüm sayfasından, glpi-agent-deployment.vbs aynı sürümün kaynak kodundaki contrib/windows klasöründen alınır. Betik kendi sürümünü kurulu sürümle karşılaştırdığı için iki dosyanın sürümü birbirini tutmalıdır.

GPO Pilot Grubu ve Güvenlik Süzgeci

GPO önce tek bir bilgisayara uygulanır. Lab’da Bilgisayarlar OU’sunda iki bilgisayar var: ankmuh01 ve ANKIT01. GPO OU’ya bağlı, ama yalnız GG_PC_ANK_GLPIPILOT grubundaki bilgisayarlara uygulanıyor. Grubun tek üyesi ankmuh01.

Group Policy Management. Solda Tier 2, Ankara altında 'Bilgisayarlar' OU'su seçili ve kırmızı çerçeveyle işaretli. Sağda Linked Group Policy Objects sekmesinde altı GPO: PC_ANK_LAPS, PC_ANK_LOOPBACK, USER_ANK_MUHPANEL, PC_ANK_GLPIAGENT, PC_ZABBIX_AGENT ve PC_WAZUH_AGENT. Link sırası 4 olan PC_ANK_GLPIAGENT satırı kırmızı çerçeveyle işaretli: Enforced No, Link Enabled Yes, GPO Status 'User configuration settings disabled'.
GPO, Ankara bilgisayarlarının OU'suna bağlı. Aynı OU'da LAPS, Zabbix ve Wazuh agent'larının GPO'ları da duruyor.

Pilot grubu, GPMC’de (gpmc.msc) Group Policy Objects altında GPO seçilince Scope sekmesinin Security Filtering bölümünde görünür. Fabrika ayarındaki Authenticated Users buradan çıkarılmış, yerine pilot grup eklenmiştir:

Group Policy Management, PC_ANK_GLPIAGENT GPO'sunun Scope sekmesi. Links bölümünde Bilgisayarlar satırı kırmızı çerçeveyle işaretli: Enforced No, Link Enabled Yes, yol ad.sistemkusu.com/Tier 2/Ankara. Security Filtering bölümünde tek satır kırmızı çerçeveyle işaretli: GG_PC_ANK_GLPIPILOT (SISTEMKUSU\GG_PC_ANK_GLPIPILOT). WMI Filtering none.
GPO OU'nun tamamına bağlı, ama yalnız pilot grubundaki bilgisayarlar onu uygular. OU'daki öbür bilgisayar agent'ı almaz.

Authenticated Users süzgeçten çıkarılınca okuma iznini kaybetmez. GPO’nun Delegation sekmesinde Authenticated Users için Read izni kalır, yalnız Apply izni kalkar. Bu ayrımın sebebini GPO yönetimi yazısının güvenlik süzgeci bölümünde anlattık.

Bilgisayar yeni grup üyeliğini açılışta alır. Bir bilgisayar pilot gruba eklendikten sonra GPO’yu ancak bir sonraki açılışta uygular. Pilot geçince kapsam iki yoldan biriyle genişler: OU’daki bilgisayarlar gruba eklenir ya da süzgece yeniden Authenticated Users konur. İkinci yolda OU’ya taşınan her yeni bilgisayar agent’ı kendiliğinden alır.

Betik ve MSI İçin Kapalı Paylaşım

Betik ve MSI, yalnız etki alanındaki bilgisayarların okuyabildiği bir paylaşımda durur. Kullanıcılar bu paylaşımı açamaz. Lab’da paylaşım etki alanı denetleyicisinde, C:\Dagitim\glpi-agent klasöründe açıldı. Aynı klasörün yanında Zabbix ve Wazuh agent’larının dağıtım klasörleri de duruyor.

Paylaşım ve klasör izinleri yönetici PowerShell’inde verilir:

dc01PowerShellYönetici
New-Item -ItemType Directory -Path C:\Dagitim\glpi-agent
New-SmbShare -Name 'glpi-agent$' -Path C:\Dagitim\glpi-agent -ReadAccess 'SISTEMKUSU\Domain Computers' -FullAccess 'SISTEMKUSU\Domain Admins'
icacls C:\Dagitim\glpi-agent /inheritance:r /grant:r 'SYSTEM:(OI)(CI)F' 'Administrators:(OI)(CI)F' 'SISTEMKUSU\Domain Computers:(OI)(CI)RX'

Paylaşım adının sonundaki $, paylaşımı ağ listesinde gizler. Bu bir erişim denetimi değildir, asıl koruma izinlerdir. icacls satırındaki /inheritance:r üst klasörden gelen izinleri keser, klasörde yalnız satırda verilen üç izin kalır. Paylaşımın izni Get-SmbShareAccess ile okunur:

dc01PowerShell Çıktısı
Name        AccountName                 AccessControlType AccessRight
----        -----------                 ----------------- -----------
glpi-agent$ SISTEMKUSU\Domain Admins                Allow        Full
glpi-agent$ SISTEMKUSU\Domain Computers             Allow        Read

Klasörün NTFS izinleri Properties → Security → Advanced penceresinde görünür. Domain Computers grubunda yalnız Read & execute vardır, devralınan izin yoktur:

Advanced Security Settings for glpi-agent penceresi, Name C:\Dagitim\glpi-agent, Owner SYSTEM. Permissions sekmesinde üç girdi: SYSTEM Full control, Domain Computers (SISTEMKUSU) Read & execute ve Administrators Full control. Üçünde de Inherited from None, Applies to 'This folder, subfolders and files'. Domain Computers satırı kırmızı çerçeveyle işaretli.
Klasörü bilgisayar hesapları okur ve çalıştırır. Kullanıcılar listede yoktur, devralınan izin de kalmamıştır.

MSI ve betik bu klasöre kopyalanır. MSI’ın SHA-256 hash’i, GitHub sürüm sayfasındaki digest değeriyle karşılaştırılır. Lab’da indirilen GLPI-Agent-1.21-x64.msi dosyasının hash’i 152bd777… ile başladı ve sürüm sayfasındaki değerle aynı çıktı. Paylaşımdaki MSI her bilgisayara SYSTEM yetkisiyle kurulacağı için bu karşılaştırma kopyalamadan önce yapılır.

Dağıtım Betiği: glpi-agent-deployment.vbs

Betiğin baş tarafı ayar bölümüdür. Aşağıdaki satırlar lab’daki betikten alındı, parola değeri gizlendi:

VB
SetupVersion = "1.21"
SetupLocation = "\\dc01.ad.sistemkusu.com\glpi-agent$"
SetupArchitecture = "Auto"
SetupOptions = "/quiet RUNNOW=1 ADD_FIREWALL_EXCEPTION=1 SERVER='https://glpi.ad.sistemkusu.com/' TAG=ank-muh USER=glpi-envanter PASSWORD=<password> /L*V C:\Windows\Temp\glpi-agent-gpo.log"
Reconfigure = "Yes"
Repair = "No"
Verbose = "No"
DeğişkenLab’daki değerNe yapar
SetupVersion1.21Kurulacak sürüm. Betik bunu kayıt defterindeki Installer\Version ile karşılaştırır
SetupLocationpaylaşımın UNC yoluMSI’ın yeri. HTTP ya da HTTPS adresi de olabilir
SetupArchitectureAutoİşletim sisteminin mimarisine göre paket adını seçer: GLPI-Agent-1.21-x64.msi
SetupOptionssessiz kurulum ve agent ayarlarımsiexec’e geçen her şey: sunucu, etiket, envanter kullanıcısı ve parola, log dosyası
ReconfigureYesSürüm aynıysa MSI’ı REINSTALL=feat_AGENT ile yeniden çalıştırır
RepairNoYes olsaydı sürüm aynıyken kurulumu onarırdı (msiexec /fa)
VerboseNoBaşlangıçta ekrana mesaj basılmaz

SetupOptions içindeki seçenekler MSI’ın kendi özellikleridir:

  1. /quiet: kurulum arayüz göstermeden çalışır.
  2. RUNNOW=1: agent’ı kurulumdan hemen sonra çalıştırır, ilk envanter bir sonraki bekleme süresini beklemez.
  3. ADD_FIREWALL_EXCEPTION=1: GLPI Agent’ı Windows Firewall’un istisna listesine ekler. Fabrika ayarında 0’dır.
  4. SERVER: GLPI’ın kök adresi, tek tırnak içinde.
  5. TAG: bilgisayarın etiketi. Konum kuralı bu değeri okur. Bu OU’nun etiketi ank-muh.
  6. USER ve PASSWORD: GLPI’daki envanter kullanıcısı ve parolası.
  7. /L*V: Windows Installer’ın ayrıntılı log’u. Dağıtımın teşhisi bu dosyadan yapılır.

Etiket OU’ya göre değiştiği için her OU kendi GPO’sunu ve kendi betik kopyasını alır. ank-muh etiketli betik İzmir’in OU’suna bağlanırsa İzmir bilgisayarları Ankara’nın muhasebesine yazılır.

Betiğin karar kısmı iki dal taşır. Agent kurulu değilse ya da sürümü farklıysa MSI’ı /i ile kurar. Sürüm aynıysa ve Reconfigure Yes ise SetupOptions’ın sonuna REINSTALL=feat_AGENT ekler ve MSI’ı yine çalıştırır. Bu ikinci dal her açılışta çalışır. Ölçümü her açılışta ayarları yeniden yazma bölümünde.

Betiği GPO’ya Başlangıç Betiği Olarak Eklemek

GPO, Group Policy Management’ta (Win + R → gpmc.msc) sağ tıklanıp Edit ile açılır. Betik Computer Configuration → Policies → Windows Settings → Scripts (Startup/Shutdown) → Startup altına eklenir. Add düğmesinin açtığı pencerede Script Name alanına betiğin paylaşımdaki tam UNC yolu yazılır: \\dc01.ad.sistemkusu.com\glpi-agent$\glpi-agent-deployment.vbs. Script Parameters boş kalır.

Pencerenin alanı dar olduğu için yolun başı kayar, eklenen satırın adı da listede kesik görünür. Yolun tamamı GPO’nun Settings sekmesinde okunur:

Group Policy Management, PC_ANK_GLPIAGENT GPO'sunun Settings sekmesi. Üstte Delegation tablosu: Authenticated Users Read, GG_PC_ANK_GLPIPILOT 'Read (from Security Filtering)'. Altta Computer Configuration (Enabled), Policies, Windows Settings, Scripts, Startup. Name sütununda \\dc01.ad.sistemkusu.com\glpi-agent$\glpi-agent-deployment.vbs satırı ve boş Parameters sütunu kırmızı çerçeveyle işaretli. En altta User Configuration (Enabled), 'No settings defined'.
Başlangıç betiği SYSVOL'deki bir dosya değil, paylaşımdaki betiğin tam yolu. GPO yalnız yolu taşır.

Betiğin SYSVOL’de bir kopyası kalmamalıdır, çünkü SYSVOL’ü etki alanındaki her kullanıcı okur. GPO’nun SYSVOL’deki Startup klasörü, Startup Properties penceresindeki Show Files düğmesiyle açılır. Lab’da betiğin eski bir kurulumdan kalan kopyası bu klasörden silindi ve klasör boş kaldı.

Aynı ekranın son satırı GPO’nun kullanıcı yarısının boş olduğunu gösteriyor. Bu yarı GPO’nun Details sekmesindeki GPO Status listesinden User configuration settings disabled seçilerek kapatılır:

Group Policy Management, PC_ANK_GLPIAGENT GPO'sunun Details sekmesi. Domain ad.sistemkusu.com, Owner Domain Admins, Modified 8.11.2026 11:05:30, User version 0 (AD), 0 (SYSVOL), Computer version 2 (AD), 2 (SYSVOL). GPO Status açılır listesinde 'User configuration settings disabled' seçili ve kırmızı çerçeveyle işaretli.
GPO yalnız bilgisayar ayarı taşıyor. Kullanıcı yarısı kapatılınca istemci bu GPO'yu oturum açılışında taramaz.

OU’ya bağlı GPO’lar listesinde GPO Status sütunu aynı değeri gösterir. Pilot grubu bölümündeki karede GLPI, Zabbix ve Wazuh agent’larının üç GPO’sunun da kullanıcı yarısı kapalı görünüyor.

GLPI Agent’ın İlk Açılışta Kurulumu

Uçtan uca kurulumu ölçmek için ankmuh01’deki agent önce msiexec /x ile kaldırıldı. Kayıt defteri anahtarı ve servis gitti, yalnız C:\Program Files\GLPI-Agent klasörü kaldı. Bilgisayar yeniden başlatıldı ve kimse oturum açmadı:

OlaySaatKaynak
Bilgisayar açıldı11:09:21LastBootUpTime
Başlangıç betiği başladı11:09:43GroupPolicy olay 4018
Başlangıç betiği bitti, 25 saniye11:10:09GroupPolicy olay 5018
MSI kurulumu11:10:09-11:10:58MSI log’u, MainEngineThread is returning 0

Açılıştan kurulumun sonuna iki dakikadan az zaman geçti. Olaylar Event Viewer’da (Win + R → eventvwr.msc) Applications and Services Logs → Microsoft → Windows → GroupPolicy → Operational altında okunur. 4018 betiğin başladığını, 5018 bittiğini ve süresini yazar. Betiği çalıştıran hesap olayda SISTEMKUSU\ANKMUH01$ olarak görünür.

Kurulumdan sonra HKLM\SOFTWARE\GLPI-Agent altında sunucu https://glpi.ad.sistemkusu.com/, etiket ank-muh, kullanıcı glpi-envanter ve Installer\Version değeri 1.21 duruyordu. glpi-agent servisi çalışıyor ve Automatic başlıyordu. gpresult /r /scope computer çıktısında GPO uygulananlar listesindeydi:

ankmuh01CMD Çıktısı
    Applied Group Policy Objects
    -----------------------------
        PC_ANK_LAPS
        PC_ANK_LOOPBACK
        PC_ANK_GLPIAGENT
        PC_ZABBIX_AGENT
        PC_WAZUH_AGENT
        PC_TIER2_YONETICI
        PC_TIER2_KISIT
        PC_TIER2_ICMP
        PC_TIER2_CIS
        Default Domain Policy
        PC_KERBEROS

Her Açılışta Ayarları Yeniden Yazar

Reconfigure = "Yes" iki sonuç doğurur. Betikteki değer değiştiğinde yeni değer bir sonraki açılışta her bilgisayara yayılır. Bir bilgisayarda kayıt defteri elle değiştirildiğinde de betikteki değer bir sonraki açılışta onun üstüne yazılır.

Yeniden yazmayı lab’da gerçek bir açılışla ölçtüm. ankmuh01’in kayıt defterindeki parolayı 24 karakterlik doğru değerden 16 karakterlik yanlış bir değere çektim ve bilgisayarı yeniden başlattım:

AdımSaatSonuç
Kayıt defterindeki parola elle değiştirildi11:16:5924 karakter → 16 karakter
Bilgisayar açıldı11:17:34
Başlangıç betiği11:17:55-11:18:20yarım dakika kadar
MSI, REINSTALL=feat_AGENT ile11:18:20-11:18:35MainEngineThread is returning 0
Kayıt defterindeki parola11:2224 karakter, betikteki değer

Sunucu, etiket ve kullanıcı değişmedi, agent servisi çalışmaya devam etti. Aynı sonucu MSI komutunu REINSTALL=feat_AGENT ile elle iki kez çalıştırarak da almıştım: kayıt defterindeki değer her seferinde betikteki değere eşitlendi. Yani agent’ın ayarlarının asıl yeri kayıt defteri değil, betiktir.

Bu davranışın pratik sonucu parola değişiminin sırasıdır. Örnekteki görev emrinin diliyle: kimlik kartı dairede yenilenir ama emir eski kartı yazmaya devam ederse ekip her sabah eski kartla çıkar. Parola GLPI’da değiştirildiğinde aynı gün betikteki PASSWORD değeri de değiştirilir. Bir bilgisayarın kayıt defterini elle düzeltmek kalıcı değildir: betik eski değeri taşıyorsa bir sonraki açılışta onu geri yazar.

Parola GLPI’da değiştikten sonra bilgisayar yeniden başlayana kadar agent eski parolayı gönderir. Bu arada agent’ın log’u authentication required, wrong credentials yazar ve envanter gitmez. Bilgisayar açıldığında betik yeni parolayı yazar ve envanter yeniden başlar.

GLPI Envanter Parolası Nerede Durur?

Envanter parolası dört yerde durur. Yönetici olmayan bir etki alanı kullanıcısıyla, ayse.demir hesabıyla, ankmuh01’de dördünü de okumayı denedim. İlk deneme betik SYSVOL’deyken, ikincisi betik paylaşıma taşındıktan sonra yapıldı:

YerBetik SYSVOL’deykenBetik paylaşımdayken
SYSVOL’deki betikOkundu, PASSWORD satırı düz metinDosya yok
Paylaşımdaki betikAccess is denied
Kayıt defteri, HKLM\SOFTWARE\GLPI-AgentOkundu, password değeri 24 karakterOkundu, password değeri 24 karakter
MSI log’u, C:\Windows\Temp\glpi-agent-gpo.logAccess is deniedAccess is denied

Paylaşıma taşımak tek bir açığı kapattı ama en büyüğünü kapattı. Betik SYSVOL’deyken etki alanının her kullanıcısı, herhangi bir bilgisayardan, parolayı tek dosyadan okuyabiliyordu. Taşındıktan sonra paylaşımı yalnız bilgisayar hesapları açabiliyor.

Kayıt defteri ise değişmedi. HKLM\SOFTWARE\GLPI-Agent anahtarında BUILTIN\Users grubunun ReadKey izni var. Agent’ın kurulu olduğu bir bilgisayarda oturum açan her kullanıcı parolayı buradan okur. Örnekteki dairenin diliyle: görev emri artık kilitli dolapta, ama kimlik kartı ekibin cebinde ve araca binen herkes onu görebilir. Bu, agent’ın parolayı kendi ayarı olarak sakladığı yerdir ve dağıtım yöntemi bunu değiştirmez.

Bu yüzden envanter kullanıcısı bir GLPI kullanıcısı değildir, yalnız envanter göndermeye yarayan bir ad ve paroladır ve başka hiçbir yerde kullanılmaz. Parolayı ele geçiren biri GLPI’a sahte envanter gönderebilir, ama onunla GLPI’da oturum açamaz. Parola sızdığında GLPI’da ve betikte değiştirilir, değişiklik bir sonraki açılışta her bilgisayara yayılır.

MSI log’unda da parola düz metin durur. Lab’daki ilk kurulumun log’unda parola değeri üç satırda açıkça yazıyordu: CMDLINE_PASSWORD özelliğinin iki geçişinde ve kayıt defterine yazılan değerde. PASSWORD özelliğinin kendisi yıldızlarla gizlenmişti. Log’u yalnız Administrators ve SYSTEM okuyabiliyor, her açılışta da yeniden yazılıyor. Log teşhisin tek kaynağı olduğu için pilot süresince tutulur. Dağıtım oturduktan sonra yerel yöneticilere güvenilmeyen bir ortamda /L*V seçeneği betikten çıkarılabilir.

Envanter GLPI’a Ulaştı mı?

Dağıtımın son kanıtı GLPI’dadır. Agent’ın yerel arayüzüne yapılan /now isteği envanteri hemen başlatır. ankmuh01’de agent’ın log’u (C:\Program Files\GLPI-Agent\logs\glpi-agent.log) şu satırlarla bitti:

ankmuh01Çıktı
[info] sending prolog request to server0
[info] server0 answer shows it supports GLPI Agent protocol
[info] running task Inventory: run event
[info] New inventory from ankmuh01-2026-10-22-04-16-49 for server0 (tag=ank-muh)

Satırın sonundaki tag=ank-muh betikteki etikettir. GLPI’da ankmuh01’in formunda Konum alanı Ankara > Muhasebe oldu. Konumu etiket kuralı yazdı:

GLPI, Varlıklar, Bilgisayarlar, ankmuh01 bilgisayar formu. Ad ankmuh01. Konum alanı 'Ankara > Muhasebe' ve kırmızı çerçeveyle işaretli. Sağda Tür VMware, Üretici VMware, Inc., Model VMware20,1. Altta Diğer kullanıcı adı t2.sistemkusu@SISTEMKUSU.
Etiket betikten geldi, konumu etiket kuralı yazdı. GPO'nun işi etiketi doğru bilgisayara vermekti.

Agent’ın /now isteğinden sonra GLPI’daki kayıt hemen değil, yaklaşık iki dakika sonra güncellendi. Konumun nasıl atandığı GLPI envanter kuralları yazısında anlatılıyor.

Sık Hatalar: Belirtiden Sebebe

BelirtiSebepÇözüm
MSI log’unda Note: 1: 2203 ve MainEngineThread is returning 1620Windows Installer paketi açamadı: paylaşımın sunucusu kapalı, ad çözülmüyor ya da bilgisayar hesabının okuma izni yokPaylaşıma bilgisayar hesabının Read, klasörde Read and Execute izni olduğunu ve sunucunun açık olduğunu doğrulayın
MSI log dosyası hiç oluşmadıBetik çalışmadı: bilgisayar güvenlik süzgecindeki grupta değil, grubu henüz almadı ya da GPO yanlış OU’ya bağlıgpresult /r /scope computer ile GPO’nun uygulanıp uygulanmadığına bakın, gruba yeni eklenen bilgisayarı yeniden başlatın
Agent’ın log’unda wrong credentialsGLPI’daki parola ile betikteki parola farklıBetikteki PASSWORD değerini düzeltin ve bilgisayarı yeniden başlatın. Kayıt defterini elle düzeltmek kalıcı değildir
Bilgisayarlar yanlış konuma yazılıyorBetik başka bir OU’nun etiketini taşıyorHer OU’nun GPO’su kendi etiketiyle kendi betik kopyasını çalıştırır
Kayıt defterindeki bir değer her açılışta eski haline dönüyorBu bir hata değil, Reconfigure = "Yes"Değişikliği betikte yapın
SetupOptions içindeki sunucu adresi yanlış okunuyorDeğer çift tırnakla yazıldıTırnak gereken değeri tek tırnakla yazın: SERVER='https://...'

GPO Dışında GLPI Agent Dağıtım Araçları

GPO’nun karşılığı olan her araç aynı MSI’ı aynı özelliklerle kurar. Configuration Manager, Intune ya da Ansible kullanan bir kurumda msiexec satırı değişmez, yalnız onu çalıştıran araç değişir. SERVER, TAG, USER ve PASSWORD yine MSI özelliği olarak verilir ve parola yine istemcinin kayıt defterinde durur. Bu araçlarda parolayı korumanın yolu da aracın kendi gizli değer saklama özelliğidir. Etki alanında başka bir yönetim aracı yoksa bu yazıdaki GPO yeterlidir.

Doğru Kurulduğunu Nasıl Anlarsınız?

Yedi kontrol:

  1. Betik SYSVOL’de değil: GPO’nun SYSVOL’deki Startup klasörü boş, başlangıç betiği paylaşımdaki tam UNC yolunu gösteriyor. Yönetici olmayan bir kullanıcı paylaşımı açmaya çalışınca Access is denied alıyor.
  2. Kapsam doğru: GPO’nun Scope sekmesinde link doğru OU’da, Security Filtering’de pilot grup ya da hedeflenen grup var.
  3. GPO uygulanıyor: istemcide gpresult /r /scope computer çıktısında GPO Applied Group Policy Objects altında görünüyor, GroupPolicy olaylarında 4018 ve 5018 var.
  4. Kurulum başarılı: MSI log’u MainEngineThread is returning 0 satırıyla bitiyor.
  5. Ayarlar yerinde: HKLM\SOFTWARE\GLPI-Agent altında server, tag ve user betikteki değerleri taşıyor.
  6. Envanter gidiyor: agent’ın log’unda New inventory ... (tag=...) satırı var, wrong credentials yok.
  7. GLPI’da kayıt doğru: bilgisayar GLPI’da tek kayıtla, etiketinin gösterdiği konumla görünüyor.

Sonuç: Görev Emri Kilitli Dolapta Durur

GLPI Agent’ı GPO ile dağıtmak bir saatlik iştir: bir paylaşım, bir betik kopyası, bir GPO ve bir pilot grup. Lab’da öne çıkan üç şey var:

  1. Betik yalnız kurulum yapmıyor, her açılışta MSI’ı yeniden çalıştırıp ayarları betiktekiyle eşitliyor. Parola ve etiket değişiklikleri bu yüzden yalnız betikte yapılır.
  2. Paylaşım kapalıyken betik hata vermeden durdu, iz yalnız istemcideki MSI log’unda kaldı.
  3. Envanter parolası betikte, kayıt defterinde ve MSI log’unda düz metin duruyor. Betiği paylaşıma taşımak etki alanının her kullanıcısına açık olan kopyayı kapattı. Kayıt defterindeki kopyayı ise o bilgisayarda oturum açan her kullanıcı okuyor, bu yüzden parola yalnız envanter işine ayrılıyor.

Girişteki benzetmeye dönersek: görev emri her sabah ekibe kimlik kartını yeniden veriyor, kart değişince emir de değişiyor ve emir ilan panosunda değil kilitli dolapta duruyor. Kart ise ekibin cebinde kalıyor, bu yüzden yalnız bir kapıyı açıyor. Envanter artık filodan geliyor. Sıradaki iş gelen her envanteri doğru konuma ve doğru kayda yazmak: rehberin 9. adımı etiket, konum ve kopya kayıt kurallarını kurar.

GLPI Agent GPO Dağıtımı Hakkında Sık Sorulan Sorular

Hayır. Bilgisayar başlangıç betiği kullanıcı oturum açmadan, bilgisayar açılırken SYSTEM hesabıyla çalışır ve MSI'ı bu hesapla kurar. GLPI Agent belgesi de betiğin bir bilgisayar GPO'sunda başlangıçta çalıştırılmasını önerir, çünkü bazı kullanıcıların kurulum yetkisi yoktur. Kullanıcı GPO'sunda logon betiği olarak çalışan aynı betik, standart kullanıcının oturumunda kurulum yapamaz.
Hayır. Yeni parola paylaşımdaki betiğin PASSWORD değerine yazılır. Betik Reconfigure Yes ayarıyla her açılışta MSI'ı REINSTALL=feat_AGENT ile yeniden çalıştırır ve kayıt defterindeki parolayı betiktekiyle değiştirir. Lab'da elle değiştirilen değer bu yolla betikteki değere döndü. Bilgisayar yeniden başlayana kadar agent eski parolayla istek gönderir ve GLPI onu reddeder.
Önce betiğin MSI log'una. Betikteki /L*V seçeneği log'u istemcide bir dosyaya yazar. Lab'da paylaşımın bulunduğu sunucu kapalıyken log 2203 notunu ve 1620 dönüş kodunu yazdı: Windows Installer paketi açamadı. Log dosyası hiç oluşmadıysa betik çalışmamıştır ve sebep GPO'nun kapsamındadır: güvenlik süzgecindeki grup, bilgisayarın grup üyeliği ve link.
MSI kurulur ama ayarsız kurulur. Software Installation pakete komut satırı özelliği veremez, sunucu adresi, envanter kullanıcısı, parola ve etiket ancak bir dönüşüm (.mst) dosyasıyla verilir ve o dosya her parola ya da sürüm değişiminde yeniden üretilir. GLPI Agent'ın kendi dağıtım betiği aynı değerleri tek satırda taşır ve sürüm değişimini de kendisi yönetir.
İ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

GLPI Rehberi: Kurulumdan Helpdesk'e Adım Adım

GLPI rehberi: kurulumdan Active Directory'ye, envanterden SLA'ya on üç adımlık sıra. Her adım hangi kurumda gerekir, fabrika ayarı ne, lab'da ne ölçtük.

22 dk okuma

BT Envanter Yönetimi: Sistem Seçimi ve Kurulum Hizmeti

Kurumunuza hangi envanter sistemi uyar? Açık kaynak, bulut ve kurumsal ITSM seçeneklerini ölçeğinize göre karşılaştırıyor, seçtiğiniz sistemi kuruyoruz.

8 dk okuma

GLPI Active Directory ve LDAP: LDAPS ile Bağlantı

GLPI Active Directory bağlantısı adım adım: LDAPS ve 636, salt okuma servis hesabı, DNS, içe aktarmadan önce daraltılan kapsam ve saatlik kullanıcı eşitlemesi.

14 dk okuma

GLPI Envanter Kuralları: Etiket, Konum ve Kopya Kayıt

GLPI envanter kuralları: agent etiketinden konum atayan kural, kuralın her envanterde çalışması, elle düzeltmenin kilidi ve kopya kaydı önleyen eşleştirme.

17 dk okuma

GLPI HTTPS: İç CA Sertifikası, Apache ve GLPI Adresi

GLPI HTTPS yapılandırması adım adım: iç CA'dan SAN'lı sertifika, Apache'de 443 ve yönlendirme, HSTS, GLPI uygulama adresi ve session.cookie_secure ayarı.

16 dk okuma

GLPI Mail to Ticket: E-postadan Destek Kaydı Açmak

GLPI mail to ticket kurulumu: rol adresi, IMAP alıcısı, iki arşiv klasörü, mailgate görevi, yanıtın aynı kayda bağlanması ve tanınmayan gönderen kararı.

19 dk okuma