BT Danışmanlık

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.

İlker Pehlivan

GLPI nedir yazımızda GLPI’yı bir tapu ve kadastro dairesine benzettik: bir defter neyin var olduğunu, ikinci defter o varlığın başına geleni tutar. Yeni bir ilçede böyle bir daire tek günde açılmaz. Önce bina ve kasa hazırlanır, sonra anahtarlar ve mühür dağıtılır. Ardından kadastro ekibi sahaya çıkar ve en son vatandaşın başvurduğu banko açılır. Sıra karışırsa daire çalışır görünür, ama ekibin ölçtüğü pafta deftere girmez ya da bankoya gelen başvuru kimseye ulaşmaz.

GLPI rehberi benzetmesi: açılış sabahında tapu ve kadastro dairesinin tonozlu taş salonu, solda kapısı açık, rafları henüz boş demir bantlı kasa, ortada üzerinde iki kapalı defter, bir mühür ve bir anahtarlık duran meşe banko, bankonun arkasında görevli ve bir sırasına rulo paftalar konmuş çekmece duvarı, sağda açık yan kapıdan omzunda ölçü sehpası, koltuğunun altında paftayla içeri giren kadastro ekibinden bir ölçücü
Açılış sabahında her şey kullanılacağı sırayla yerindedir. Kasa GLPI sunucusudur, anahtar ve mühür Active Directory ile profillerdir, sahadan gelen kadastro ekibi GLPI Agent'tır. Henüz kimsenin başvurmadığı banko helpdesk'tir ve en son açılır.

GLPI rehberi, açık kaynak BT varlık yönetimi ve helpdesk yazılımı GLPI’yı bir kurumda çalışır hale getirmenin adımlarını bu sırayla dizer: sunucu, kimlik, envanter, helpdesk ve işletme. GLPI üç parçadan oluşur. Web uygulaması tarayıcıdan açılan arayüzdür ve PHP ile çalışır. Veritabanı bütün kayıtları tutar, varlıkları da destek kayıtlarını da. GLPI Agent ise bilgisayarlara kurulan ve donanım ile yazılım envanterini sunucuya gönderen küçük bir servistir.

Bu rehber, BT envanter yönetimi sayfamızda anlattığımız envanter işinin GLPI tarafını sıraya koyar. Listeyi baştan sona uygulamanız gerekmez, kurumunuzda karşılığı olmayan adımı atlayın. Ölçümlerin kaynağı lab’daki GLPI 12.0.1 sunucusudur: Ubuntu 26.04, Apache 2.4.66, PHP 8.5.4 ve MariaDB 11.8.6. Arayüz Türkçe kuruldu, menü adları bu yüzden Türkçe arayüzdeki gibi yazıldı.

GLPI Kurulum ve Yapılandırma Sırası: Adım Adım Kontrol Listesi

Liste, adımların birbirine bağımlılığına göre sıralandı. Her adımın özeti aşağıda kendi bölümünde, ayrıntısı “Ayrıntılı yazı” sütunundaki yazıdadır.

#AdımKimde gerekirAyrıntılı yazı
1Kapsamı ve kaydın sahibini seçmekHer kurumdaGLPI nedir
2GLPI sürümü, kurulumu ve ilk ayarlarHer kurumdaGLPI kurulumu
3HTTPS ve GLPI adresiHer kurumdaGLPI HTTPS
4Active Directory bağlantısı ve LDAPSEtki alanı varsaGLPI Active Directory
5Profiller, yetki kuralı ve kapatılan hesapHer kurumdaGLPI yönetimi
6E-posta bildirimi ve SMTP relayHer kurumdaSMTP relay kurulumu
7Envanteri açmak ve agent kimlik doğrulamasıEnvanter tutulacaksaGLPI Agent
8Agent’ı Group Policy ile dağıtmakWindows ve etki alanı varsaGLPI Agent GPO ile dağıtım
9Etiket, konum ve kopya kayıtBirden çok lokasyon varsaGLPI envanter kuralları
10Kategori, öncelik, mesai takvimi ve SLAHelpdesk açılacaksaGLPI helpdesk ve SLA
11E-postayla destek kaydıKullanıcılar e-postayla başvuracaksaGLPI mail to ticket
12Zabbix alarmından destek kaydıZabbix kullanılıyorsaGLPI Zabbix entegrasyonu
13Yedek ve sürüm yükseltmeHer kurumdaGLPI upgrade

GLPI Kurulumunda Sıra Neden Önemli?

Adımları başka bir sırayla da uygulayabilirsiniz ve GLPI yine açılır. Ama bazı adımlar bir öncekine yaslanır. Sıra bozulunca GLPI çoğu zaman hata vermez, ayar sessizce eksik kalır. Lab’da ölçülen dört bağımlılık:

  • Web kökü, sihirbazdan önce public/ klasörüne verilir. Web kökü (DocumentRoot), Apache’nin tarayıcıya açtığı klasördür. GLPI 12’de tarayıcıya açılması gereken tek klasör budur. Arşivde config/ ve files/ klasörlerini koruyan bir .htaccess dosyası yoktur. Web kökü kod klasörünün kendisine verilirse arayüz açılmaz, ama yapılandırma ve veri dosyaları tarayıcıdan okunabilir.
  • Kök sertifika, LDAPS’ten ve agent’tan önce sunucuya konur. GLPI’nın Active Directory’ye 636 portundan bağlanması ve Linux agent’ın GLPI’ya HTTPS ile bağlanması aynı güvene dayanır. İç sertifika otoritesinin kök sertifikası işletim sisteminin deposunda yoksa ikisi de bağlanamaz ve hata mesajı sertifikayı anmaz.
  • Envanter kimliği, agent dağıtımından önce belirlenir. Agent’ın kullanıcı adı ve parolası Group Policy ile her bilgisayarın kayıt defterine yazılır. Parola sonradan GLPI’da değişirse eski parolayı taşıyan bilgisayarlar envanter gönderemez.
  • Yetki kuralı, kullanıcılar içe aktarılmadan önce sınanır. Kural hiçbir kullanıcıyla eşleşmezse içe aktarılan herkes yalnız en düşük profili alır. Hata mesajı çıkmaz, yöneticiler de kendi hesaplarıyla girdiklerinde yalnız kendi destek kayıtlarını görür.

Örnekteki dairede de ekip sahaya çıkabilir, ama kasanın anahtarı yoksa ölçtüğü paftayı bırakacak yer bulamaz.

1. Aşama: GLPI Sunucusu ve Kapsam

Sunucu kurulmadan önce iki karar verilir: GLPI’da neyin tutulacağı ve kaydın sahibinin kim olacağı. Sonra sürüm seçilir, sunucu kurulur ve fabrika ayarlarındaki açıklar kapatılır.

1. Kapsamı ve Kaydın Sahibini Seçmek

GLPI iki iş yapar: varlık envanteri ve helpdesk. İkisini aynı gün açmak gerekmez. Envanter önce açılırsa helpdesk ilk günden doğru bilgisayara bağlanan destek kayıtlarıyla başlar. Helpdesk önce açılırsa kayıtlar bir süre boş bir varlık listesine bağlanır.

Asıl karar kaydın sahibidir. Envanterde her cihazın bir sorumlusu ve bir konumu olur. Helpdesk’te ise her kaydı kimin üstleneceği ve ne kadar sürede üstleneceği yazılı olur. Bu sahiplik yazılı değilse GLPI tutarlı bir liste gösterir, ama listenin doğruluğunu kimse korumaz. Envanter yaklaşımlarının hangi kuruma uyduğunu envanter yönetimi sayfamızın karşılaştırma bölümünde, helpdesk’in süreç çerçevesini ITIL nedir yazımızda anlattık.

Doğru yapıldığını nasıl anlarsınız: bir sayfalık bir liste vardır. Listede envantere girecek cihaz türleri, lokasyonlar, helpdesk’in açılış tarihi ve destek kaydını üstlenecek ekipler yazar.

2. GLPI Sürümü, Kurulumu ve İlk Ayarlar

Güncel kararlı sürüm 28 Ekim 2026’da çıkan GLPI 12.0.1’dir. Bu bir güvenlik sürümüdür. Sürüm notu bir kritik açığı, yani harici kimlik doğrulamanın atlatılmasını, altı yüksek ve bir orta önemli açıkla birlikte kapatıyor. Bu yüzden yeni kurulum 12.0.0 ile değil en az 12.0.1 ile yapılır. GLPI’nın 10.0 dalı 30 Eylül 2026’da çıkan 10.0.28 ile bitti ve artık düzeltme almıyor.

GLPI 12.0.1’in kaynak kodu PHP için 8.3 ile 8.5 arasını, veritabanı için en az MariaDB 10.11’i ya da MySQL 8.0’ı ister. Ubuntu 26.04’ün kendi depoları bu sınırların içindedir. Lab’da PHP 8.5.4, MariaDB 11.8.6 ve Apache 2.4.66 ek depo gerekmeden kuruldu. Sunucunun kendisi Ubuntu Server kurulumu yazımızdaki gibi kurulur.

Boyut, kullanıcı ve cihaz sayısına bağlıdır. Lab’daki sunucuda 2 vCPU ve 2 GB bellek vardı. Kurulumdan sonra boşta Apache’nin yedi süreci 311 MB, MariaDB 249 MB bellek kullandı ve sistemde 807 MB bellek boş kaldı. Uygulamanın kendisi diskte 489 MB yer tutar. Asıl büyüyen kalemler veritabanı ve kullanıcıların eklediği belgelerdir.

GLPI’nın arşivi tek klasör olarak açılır ve içinde kod, yapılandırma (config/) ve veri (files/) yan yana durur. Belgenin önerdiği yerleşim bu üçünü ayırır: kod /var/www/glpi, yapılandırma /etc/glpi, veri /var/lib/glpi altına gider. Web kökü ise yalnız /var/www/glpi/public olur.

Bu ayrımın neden gerektiği lab’da ölçüldü. Arşiv olduğu gibi açılıp web kökü kod klasörüne verildiğinde, tarayıcıdan şu dosyalar indirilebildi:

İstenen yolWeb kökü public/Web kökü kod klasörü, varsayılan yerleşim
/config/glpicrypt.key404200, 32 bayt
/config/oauth.pem404200, özel anahtar
/files/_log/php-errors.log404200
/files/_sessions/404200, klasör listesi
/vendor/composer/installed.json404200, kütüphane sürümleri

glpicrypt.key, GLPI’nın veritabanında sakladığı parolaları şifreleyen anahtardır: Active Directory servis hesabının ve SMTP hesabının parolası bunlara örnektir. oauth.pem ise GLPI’nın API’sinde kullandığı özel anahtardır. Veritabanı parolasını taşıyan config_db.php indirilemedi, çünkü Apache onu PHP olarak çalıştırdı. Yapılandırma ve veri /etc/glpi ile /var/lib/glpi altına taşındığında, web kökü yanlış verilse bile bu dosyalar indirilemedi. Ama vendor/ ve bin/ altındaki dosyalar yine okunabildi. Tek tam koruma public/ web köküdür.

Paketlerde iki ayrıntı vardır. Kurulum sihirbazı php8.5-intl olmadan hiç açılmaz, Apache 500 hatası verir. Sihirbaz açılınca gerisini gereksinim ekranı adıyla sayar: zorunlu olarak xml, curl, gd, mbstring ve bcmath, önerilen olarak ldap, bz2 ve zip. Ekranın başlığı hata varken de “SINAMA BAŞARILI” yazar, bu yüzden satırların kendisine bakılır.

İkinci ayrıntı Ubuntu 26.04’e özgüdür. Apache servisi /etc klasörünü salt okunur görür, sihirbaz da /etc/glpi altına yazamaz ve dosya izinleri doğru olsa bile yazma izni hatası verir. Sihirbaz süresince Apache’ye yalnız bu klasör için yazma izni verilir, kurulum bitince izin geri alınır.

Sihirbaz bitince iki fabrika ayarı kapatılır: dört varsayılan hesap açıktır ve zamanlanmış görevlerin çoğu yalnız biri arayüzü açtığında çalışır.

Varsayılan hesaplar. Sihirbaz dört hesap açar: yönetici glpi, teknisyen tech, kullanıcı normal ve yalnız kayıt açabilen post-only. Dördünün parolası kullanıcı adıyla aynıdır. Panodaki uyarı bandı parolası değişmemiş aktif hesapları sayar ve her kapatılan hesapla bir ad kısalır. Lab’da glpi hesabı kapatıldığında parolası hala glpi olduğu halde bant kayboldu. Yani bant yalnız aktif hesaplara bakar. Önerilen yol, kendi yönetici hesabınızı açıp dört hesabı kapatmaktır. Komut satırında bin/console user:disable ile kapatılır, silinmez.

Zamanlanmış görevler. GLPI’nın otomatik işlemleri, yani bildirim kuyruğu, e-posta toplama ve SLA hesabı gibi işler, belgeye göre her dakika web sunucusu kullanıcısının crontab’ından çalışır. Root ile çalıştırılan görev durur:

itsm01Bash Çıktısı
	WARNING: running as root is discouraged.
	You should run the script as the same user that your web server runs as to avoid file permissions being ruined.
	Use --allow-superuser option to bypass this limitation.

Kurulumdan sonra 50 otomatik işlemin 31’i “GLPI” kipindeydi. Bu kipteki görev ancak biri arayüzde bir sayfa açınca çalışır. Hepsi Yapılandırma > Otomatik işlemler listesinde toplu işlemle “CLI” kipine alınır. Komutlar, ekranlar ve izinler GLPI kurulumu yazısında.

Doğru kurulduğunu nasıl anlarsınız: gereksinim ekranında hiçbir satır kırmızı ya da sarı değildir. /config/glpicrypt.key ve /files/ adresleri tarayıcıda 404 döndürür. Sunucuda php bin/console system:check_requirements komutu zorunlu ve önerilen her satırı “Tamam” gösterir. Panoda uyarı bandı yoktur, dört varsayılan hesap “Kullanımdan kaldırıldı” durumundadır ve otomatik işlemler listesinde “GLPI” kipinde görev kalmamıştır.

3. HTTPS ve GLPI Adresi

Sihirbazın bitirdiği GLPI’ya HTTP ile bağlanılır. Parolalar, oturum çerezi ve destek kayıtlarına eklenen belgeler ağda açık gider.

HTTPS. Sertifika kurumun iç sertifika otoritesinden alınır, iç otorite yoksa AD Sertifika Servisleri kurulumu yazımızda kurduk. Sertifikanın alternatif adlarına GLPI’nın kısa takma adı ve sunucunun kendi adı birlikte yazılır. Adreste IP yazmak sertifika hatası verir, çünkü sertifikada IP yoktur.

HTTPS açıldıktan sonra iki ayar elle değişir. Yapılandırma > Genel altındaki GLPI adresi sihirbazdan http:// ile kalır ve bildirim e-postalarındaki linkler bu adresi kullanır. PHP’nin session.cookie_secure ayarı da açılır, açılmazsa panoda bunu isteyen bir uyarı görünür. Sertifika isteği, Apache ayarı ve ölçümler GLPI HTTPS yazısında.

Doğru kurulduğunu nasıl anlarsınız: HTTP adresi HTTPS’e yönlenir, tarayıcı sertifika uyarısı vermez ve panoda session.cookie_secure uyarısı yoktur.

2. Aşama: Kimlik ve Yetki

Sunucu hazır olunca kimin gireceği ve neyi göreceği yazılır: Active Directory bağlantısı, profiller ve bildirimlerin gideceği yol.

4. Active Directory Bağlantısı ve LDAPS

GLPI kullanıcıları Active Directory’den alır ve girişte parolayı Active Directory’ye sordurur. Bağlantı için yalnız okuma yetkisi olan bir servis hesabı açılır. GLPI’nın kendi parolası olan bir yerel yönetici hesabı da kalır, çünkü Active Directory’ye ulaşılamadığında arayüze girmenin tek yolu odur.

Bağlantı 389 portundan şifresiz denendiğinde lab’daki Windows Server 2025 domain controller’ı bağlantıyı reddetti ve GLPI’nın sınama sekmesi Strong(er) authentication required(8) yazdı. Sebep, domain controller’ın şifresiz bağlantıda imzalı oturum istemesidir. Bu davranışı LDAP signing ve channel binding yazısında anlattık. Doğru yol 636 portu ve ldaps:// adresidir. Protokol farkı LDAP ve LDAPS nedir yazımızda.

LDAPS’te ikinci tuzak sertifikadır. GLPI sunucusu iç sertifika otoritesinin kök sertifikasını tanımıyorken sınama Can't contact LDAP server(-1) hatasını verdi. Hata ağ sorunu gibi okunur, ama aynı anda TCP bağlantısı başarılıydı. Kök sertifika Ubuntu’nun deposuna konunca aynı ayar “Kimlik doğrulandı” yazdı ve 12 kayıt buldu.

GLPI’nın Active Directory ön ayarı kullanıcı süzgecine kapatılmış hesapları dışarıda bırakan koşulu kendisi yazar. Kapsamı ise yazmaz: lab’da bu süzgeç bütün domain’den 21 hesap getirdi ve 11’i servis ya da yönetici hesabıydı. Temel DN kullanıcı OU’suna daraltılınca 10 gerçek kullanıcı kaldı. Kapsam ilk içe aktarmadan önce daraltılır. Bağlantı formu ve LDAPS ölçümleri GLPI Active Directory yazısında.

Doğru kurulduğunu nasıl anlarsınız: sınama sekmesi “Kimlik doğrulandı” yazar, bir deneme kullanıcısı kendi Active Directory parolasıyla GLPI’ya girer ve bağlantı adresi ldaps:// ile başlar.

5. Profiller, Yetki Kuralı ve Kapatılan Hesap

GLPI’da yetki profille verilir. Kurulum sekiz profil getirir: Self-Service, Observer, Admin, Super-Admin, Hotliner, Technician, Supervisor ve Read-Only. Yeni gelen her kullanıcı fabrika ayarında Self-Service alır, yani yalnız kendi destek kayıtlarını açar ve görür.

Active Directory grubundan profile geçiş, Yönetim > Kurallar > Yetki atama kuralları altında bir kuralla yapılır. Kuralın ölçütü kullanıcının (LDAP) MemberOf özniteliğinde grubun adının geçmesidir, işlemi profil ve birimdir.

Kural ekranında bir tuzak var. Ölçütün koşulu seçildiğinde desen alanı yeniden çizilir ve önceden yazılan değer kaybolur. Lab’da kurallar bu yüzden boş desenle kaydedildi ve hiçbir kullanıcıyla eşleşmedi. Önce koşul seçilir, sonra desen yazılır ve kayıttan sonra ölçüt listesinde desen görülür. Kural düzeldiğinde yönetici grubu Super-Admin, teknik ekipler Technician aldı. Self-Service profili ise yanlarında kaldı: kural yeni profil ekler, varsayılanı kaldırmaz.

İşten ayrılan kullanıcı için ayrı bir ölçüm yapıldı. GLPI’da oturumu açıkken Active Directory’de kapatılan hesap, açık oturumda çalışmaya devam etti. Yeni giriş denemesi ise genel bir hatayla reddedildi: “Kullanıcı adı ya da parola hatalı”. Ardından yapılan eşitleme 21 değil 20 hesap işledi, çünkü süzgeç kapatılan hesabı görmüyordu. Hesap GLPI’da aktif kaldı.

Kimlik doğrulama ayarında silinen kullanıcı için “Kullanımdan kaldır” seçildiğinde bir sonraki eşitleme hesabı kapattı ve açık oturum ilk sayfa yenilemesinde düştü. Hemen kesmek için oturum, kullanıcının Oturumlar sekmesinden kapatılır. GLPI 12.0.1’de security:session:revoke --login hata verdi, --session-id çalıştı.

Password policy ve iki adımlı doğrulama GLPI 12’de Yapılandırma > Güvenlik altındadır. Fabrika ayarında ilkenin değerleri dolu (en az 8 karakter, büyük harf, rakam ve sembol), ama onları uygulayan anahtar kapalı ve yerel hesaba her parola verilebiliyor.

Telefon uygulamasının ürettiği tek kullanımlık kodla (TOTP) iki adımlı doğrulama GLPI 11’den beri yerleşiktir. Yönetici profilinin Güvenlik sekmesinden zorunlu kılınır. Lab’da “Bilgilerim hatırlansın” çereziyle yapılan giriş kodu sormadı, bu yüzden çerezin süresi de kısaltılır. İki adımlı doğrulamanın neyi koruduğunu 2FA nedir yazımızda anlattık. Yerel hesaplarda password policy’yi açmak ve iki adımlı doğrulamayı yönetici profiline zorunlu kılmak, ekranlarıyla GLPI yönetimi yazısının yerel hesaplar bölümünde anlatılıyor. Profil, kural ve ayrılan hesap ölçümleri GLPI yönetimi yazısında.

Doğru kurulduğunu nasıl anlarsınız: bir teknisyen Active Directory hesabıyla girdiğinde profil seçicisinde Technician görür ve teknik arayüz açılır, Self-Service portalı değil.

6. E-posta Bildirimi ve SMTP Relay

GLPI, destek kaydı açıldığında, üstlenildiğinde ve çözüldüğünde e-posta gönderir. Bildirimler fabrika ayarında kapalıdır. Yapılandırma > Bildirimler sayfasında önce Bildirimler kullanılsın açılıp kaydedilir, E-posta bildirimlerini aç seçeneği ancak bu kayıttan sonra seçilebilir. Gönderim de zamanlanmış görevlerden biridir: bildirim önce bir kuyruğa yazılır, otomatik işlem kuyruğu boşaltır. Lab’da bir destek kaydına eklenen takibin bildirimi kuyruğa yazıldı ve bir dakika içinde cron.php’nin sonraki turuyla gönderildi. Bu yüzden 2. adımdaki CLI kipi bildirimin de ön koşuludur.

Giden posta için GLPI’ya kimlik doğrulamalı bir hesap ya da kurum içindeki bir relay verilir. Kurum içindeki cihazların e-postasını tek bir noktadan Google Workspace’e taşıyan relay’i SMTP relay kurulumu yazısında kurduk. GLPI bu sunucuya kimlik doğrulamasız gönderir ve kişisel bir kutunun parolasını taşımaz.

Hesap yolunda E-posta gönderme yöntemi alanında SMTP seçilir. Formda ayrı bir şifreleme seçeneği yoktur: lab’da 587 portuna bağlanan GLPI, bağlantıyı STARTTLS ile şifreledi. Kimlik doğrulamalı bir Gmail hesabıyla Yöneticiye deneme e-postası gönder düğmesi “Başarılı” yazdı ve SMTP konuşmasının log’unu gösterdi. Relay yolu bu ölçümün dışında kaldı.

Doğru kurulduğunu nasıl anlarsınız: bildirim ayarlarındaki deneme e-postası gelir. Bir deneme destek kaydı açıldığında kullanıcıya giden e-postadaki link https:// ile başlar ve Yönetim > Bildirim kuyruğu listesinde gönderilmeyi bekleyen satır kalmaz.

3. Aşama: Envanter ve GLPI Agent

Kimlik yerine oturunca cihazlar gelir. Envanter sunucuda açılır, agent’ın kimliği belirlenir, sonra agent bilgisayarlara dağıtılır.

7. Envanteri Açmak ve Agent Kimlik Doğrulaması

Envanter GLPI 12’de fabrika ayarında kapalıdır. Lab’da kapalıyken agent’ın her isteği 403 aldı. Yönetim > Envanter sayfasının Yapılandırma sekmesinde Envanter kullanılıyor açılırken Yetki üst bilgisi alanında bir kimlik doğrulama yöntemi seçmek zorunludur. Yöntem seçilmeden kaydetmek reddedildi. Üç seçenek vardır: OAuth istemcisi, Temel kimlik doğrulaması ve Yok. Yok seçilirse ekran, ağa erişen her aracın kimliksiz envanter gönderebileceğini açıkça yazar.

Temel kimlik doğrulaması seçilince lab’da kimliksiz istek ve yanlış parola 401, doğru parola 200 aldı. Envanter için yalnız bu işe ayrılmış bir kullanıcı adı ve parola tanımlanır. Aynı sayfadaki Envanter sıklığı (saat) fabrika ayarında 24’tür, yani agent günde bir envanter gönderir. Bu parola her bilgisayarda düz metin durur (8. adım), başka hiçbir yerde kullanılmaz.

Linux agent kurulum betiğiyle kurulur ve sunucu adresi, kullanıcı ve etiket kurulumda verilir. Lab’da Ubuntu 26.04 sunucusunda agent 1.21, iç sertifika otoritesinin kök sertifikası yokken certificate verify failed hatasıyla bağlanamadı. Kök sertifika işletim sisteminin deposuna konunca agent’a ek ayar gerekmedi. Komutlar ve Windows, Linux, macOS kurulumu GLPI Agent yazısında.

Doğru kurulduğunu nasıl anlarsınız: Varlıklar > Bilgisayarlar listesinde agent’ın kurulduğu makine görünür, Yönetim > Envanter > Aracılar listesinde de agent’ın sürümü ve etiketi yazar.

8. Agent’ı Group Policy ile Dağıtmak

Etki alanındaki Windows bilgisayarlara agent bir bilgisayar GPO’sunun başlangıç betiğiyle dağıtılır. Betik GLPI Agent projesinin kendi glpi-agent-deployment.vbs dosyasıdır. Bilgisayar açılırken SYSTEM hesabıyla çalışır ve MSI’ı sunucu adresi, envanter kullanıcısı, parola ve etiketle kurar. GPO önce bir pilot gruba uygulanır, güvenlik süzgeci OU’daki öbür bilgisayarları dışarıda tutar.

Betik envanter parolasını düz metin taşır. Bu yüzden betik ve MSI SYSVOL’de değil, yalnız Domain Computers’ın okuyabildiği bir paylaşımda durur. Parola istemcide de HKLM\SOFTWARE\GLPI-Agent anahtarında düz metin REG_SZ değer olarak kalır. Envanter kullanıcısının GLPI’da envanter göndermekten başka yetkisi olmamasının sebebi budur.

Betik agent kuruluysa ayarları her açılışta yeniden yazar. Lab’da kayıt defterindeki parola her seferinde betikteki değere eşitlendi. Parola GLPI’da değiştiğinde betikteki değer de aynı gün değiştirilir. Kayıt defterini elle düzeltmek kalıcı değildir, betik eski değeri bir sonraki açılışta geri yazar. Eski parolayı taşıyan agent TLS bağlantısını kurar ama envanteri authentication required, wrong credentials hatasıyla gönderemez. Paylaşım, betiğin değişkenleri ve MSI log’uyla teşhis GLPI Agent GPO ile dağıtım yazısında.

Windows agent’ı da Linux’taki gibi iç sertifika otoritesine güvenir, çünkü etki alanındaki bilgisayarlar kök sertifikayı Group Policy ile zaten alır. Agent’ın yerel arayüzündeki /now adresi ise iki işletim sisteminde farklı davrandı. Windows’ta yerel istekle hemen envanter başlattı, Linux’ta fabrika ayarında 403 döndürdü.

Doğru kurulduğunu nasıl anlarsınız: istemcideki MSI log’u MainEngineThread is returning 0 ile biter ve agent’ın log’unda New inventory ... (tag=...) satırı görünür. Pilot grubundaki her bilgisayar bir sonraki açılıştan sonra listede durur, agent’ın log’unda wrong credentials satırı yoktur.

9. Etiket, Konum ve Kopya Kayıt

Birden çok lokasyonu olan kurumda agent’a lokasyonu söyleyen bir etiket verilir: Ankara muhasebe için ank-muh gibi. Yönetim > Kurallar > Konum kuralları altında her etiket için bir kural yazılır: ölçüt Aracı > Envanter etiketi, işlem Konum, Atama. Fabrika ayarında bu listede hiç kural yoktur, kural yazılana kadar gelen bilgisayarların konumu boş kalır.

Lab’da kural yalnız ilk envanterde değil her envanterde çalıştı ve konumu etiketin gösterdiği değere geri yazdı. Bu yüzden bilgisayar taşınınca GLPI’daki konum alanı değil, agent’ın etiketi değiştirilir. Konumu formdan elle değiştirmek alanı kilitler ve kural o bilgisayara bir daha yazamaz.

Kopya kaydı GLPI’nın hazır içe aktarma kuralları önler. Bilgisayar agent’ın cihaz kimliğinden değil, seri numarası ve UUID’sinden tanınır. Lab’da agent’ın kimlik dosyası silinip yeni kimlik üretildiğinde envanter aynı bilgisayara bağlandı ve GLPI eski agent kaydını kendisi sildi. GLPI sunucusu baştan kurulduğunda da Windows agent’ı yeni sunucuda tek bir bilgisayar kaydı açtı. Hazır içe aktarma kurallarına dokunulmaz. Kuralların formu ve kopya kayıt ölçümleri GLPI envanter kuralları yazısında.

Doğru kurulduğunu nasıl anlarsınız: Kural işleyiciyi sına her etiket için doğru konumu verir ve Varlıklar > Bilgisayarlar listesinde konumu boş bilgisayar kalmaz.

4. Aşama: Helpdesk

Envanter dolduktan sonra destek kayıtları açılır. Kayıtların sınıflandırılması ve süresi, kayıt gelmeye başlamadan önce yazılır.

10. Kategori, Öncelik, Mesai Takvimi ve SLA

Destek kaydının kategorisi, hangi ekibe gideceğini ve hangi raporda sayılacağını belirler. Kategori listesi kısa tutulur, çünkü kullanıcı uzun listede “Diğer”i seçer. GLPI önceliği önem derecesi ile etkinin birleşiminden hesaplar ve bu birleşim bir matriste yazılıdır. Matris kurumun önceliğe verdiği anlama göre bir kez ayarlanır.

Mesai takvimi SLA’dan önce gelir. GLPI SLA süresini takvime göre sayar: mesai saati dışında ve tatil günlerinde süre durur. Takvim yoksa cuma akşamı açılan bir kayıt hafta sonu boyunca gecikmiş sayılır.

GLPI’da SLA iki süre taşır. Biri üstlenme süresidir, yani kaydın bir teknisyene atanana kadar geçen süre (time to own). Diğeri çözüm süresidir (time to resolve). OLA aynı süreleri kurumun kendi ekipleri arasında tanımlar. Eskalasyon ise süre dolmadan önce bir seviyenin tetiklenmesidir: sorumluya hatırlatma, ekip liderine bildirim, önceliğin yükselmesi.

SLA’nın ne olduğunu ve sözleşmeye nasıl yazıldığını SLA nedir yazımızda, GLPI’daki tanımını GLPI helpdesk ve SLA yazısında anlattık. SLA hesabı da otomatik işlemlerle yürür, bu yüzden 2. adımdaki CLI kipi burada da ön koşuldur.

Doğru kurulduğunu nasıl anlarsınız: bir deneme kaydı açıldığında kaydın üstünde üstlenme ve çözüm için iki son tarih görünür. Mesai dışında açılan kaydın son tarihi bir sonraki mesai gününe kayar.

11. E-postayla Destek Kaydı

Kullanıcıların çoğu helpdesk’e e-postayla yazar. GLPI bir posta kutusunu IMAP ile okur ve her yeni iletiyi bir destek kaydına çevirir. Bu işi Yapılandırma → Alıcılar menüsündeki bileşen yapar. Kutuyu on dakikada bir mailgate otomatik işlemi okur. Okunacak kutu kişisel bir kutu olmaz, destek@ gibi bir rol adresidir. Kişisel kutuda bültenler ve toplantı davetleri de kayda dönüşür. Lab’da Precedence: bulk başlıklı bir bülten fabrika kurallarına takılmadan kayıt açtı.

Alıcıya biri işlenen, biri reddedilen iletiler için iki arşiv klasörü verilir. GLPI’nın kaynak kodu, klasör verilmemişse iletiyi kutudan siler. Microsoft 365 kutusu yalnız OAuth ile bağlanır ve bunun için oauthimap eklentisi gerekir. Gmail ve Google Workspace’te uygulama şifresi de kullanılabilir. Fabrika kuralları otomatik yanıtı ve GLPI’nın kendi bildirimini reddeder. Tanınmayan adresten gelen ileti fabrika ayarında kayıt açmaz. Alıcının formu, kuralları ve lab ölçümleri GLPI mail to ticket yazısında.

Doğru kurulduğunu nasıl anlarsınız: bir kullanıcının adresinden gönderilen ileti en geç on dakikada kayda dönüşür ve kutuda işlenen klasörüne taşınır. GLPI bildirimine verilen yanıt yeni kayıt açmaz, aynı kayda takip olarak eklenir.

12. Zabbix Alarmından Destek Kaydı

Zabbix kullanan kurumda bir alarmın GLPI’da destek kaydına dönüşmesi iki yolla yapılır: e-postayla ya da Zabbix’in hazır GLPI webhook’uyla. Webhook, bir olay olduğunda başka bir uygulamanın adresine istek gönderen bağlantıdır. Zabbix’inki GLPI’nın API’sine bağlanır. Lab’da webhook problem başına bir kayıt açtı ve Zabbix’teki severity değerini GLPI’nın Önem derecesi alanına çevirdi. Problemin güncellemesi aynı kayda takip olarak eklendi, kapanışı kaydı Çözülmüş durumuna aldı. E-posta yolunda kapanış ayrı bir kayıt açtı, önerilen yol webhook’tur.

GLPI tarafında API açılır ve Zabbix için bir OAuth istemcisi, Super-Admin olmayan bir profil ve o profili taşıyan bir kullanıcı tanımlanır. Zabbix sunucusu GLPI’nın kök sertifikasını tanımalıdır. Zabbix’in belgesi GLPI 12’yi sınadığı sürümler arasında saymıyor, lab’daki GLPI 12.0.1’de webhook çalıştı. Kayda dönüşecek alarmlar, bir insanın müdahale etmesi gereken High ve Disaster problemleridir. Zabbix’te bu, bildirimi gönderen eylemin (action) koşuluna yazılır.

Webhook bir kez dener. Lab’da GLPI’ya ulaşamayan problem sonradan da kayıt açmadı, güncellemesi ve kapanışı da düştü. Bu yüzden Zabbix’in Action log ekranındaki Failed satırları izlenir. Kurulum ve lab ölçümleri GLPI Zabbix entegrasyonu yazısında.

Doğru kurulduğunu nasıl anlarsınız: High bir deneme problemi GLPI’da tek bir kayıt açar, problem kapanınca aynı kayıt Çözülmüş olur. Average bir problem GLPI’ya hiçbir şey göndermez.

5. Aşama: İşletme

Kurulum bitince geriye GLPI’yı geri yüklenebilir ve güncel tutmak kalır.

13. Yedek ve Sürüm Yükseltme

Belgenin güncelleme sayfası sırayı şöyle yazıyor: önce veritabanının ve dosyaların yedeği, sonra eski kod klasörünün yerine yeni sürüm, sonra php bin/console db:update. Yedek yalnız boş bir veritabanına geri yüklenir. GLPI 11’den bu yana yeni kod algılanınca eklentilerin çalışması askıya alınır, ana sürüm yükseltmesinden sonra elle geri açılır.

  1. adımdaki yerleşimde yedek üç parçadır:

  2. Veritabanı: lab’da 447 tablo, döküm iki saniye.

  3. /etc/glpi klasörü: içindeki glpicrypt.key veritabanındaki parolaların şifre anahtarıdır. Lab’da yanlış anahtarla geri yüklenen GLPI hata vermeden açıldı, ama Active Directory bağlantısının parolası boş çözüldü.

  4. /var/lib/glpi klasörü: destek kayıtlarına eklenen belgeler ve eklentiler.

Lab’da GLPI 11.0.12’den 12.0.1’e db:update birkaç saniye sürdü ve ara sürümleri sırayla uyguladı. Yeni arşivde kurulumda elle yazılan inc/downstream.php yoktu, yedekten geri kondu. GLPI 10’dan gelen kurumda önce PHP sürümü değişir, çünkü GLPI 12 PHP 8.3 ile 8.5 arasını ister. İşletim sistemi yükseltmesi GLPI yükseltmesiyle aynı güne konmaz. Yedeğin genel ilkeleri yedekleme yazımızda, komutlar ve ölçümler GLPI upgrade yazısında.

Doğru yapıldığını nasıl anlarsınız: yedek bir kez boş bir veritabanına geri yüklenmiş ve şema denetimi orada “sorun yok” demiştir. Yedekte glpicrypt.key vardır, eklentilerin listesi de yükseltmeden önce yazılmıştır.

GLPI Best Practices: Belirtiden Sebebe Sık Yapılan Hatalar

Her satır, lab’da ölçülen ya da belgede yazan bir tuzaktır.

BelirtiSebepAyrıntı
Kurulum adresi 500 veriyor, PHP log’unda locale_is_right_to_leftphp8.5-intl paketi kurulmamışBu rehber, 2. adım
Sihirbaz /etc/glpi için yazma izni istiyor, izinler doğruUbuntu 26.04’te Apache servisi /etc’yi salt okunur görüyorBu rehber, 2. adım
/config/glpicrypt.key tarayıcıdan iniyorWeb kökü public/ değil, yapılandırma kodun içindeBu rehber, 2. adım
Panoda “varsayılan kullanıcı parolalarını değiştirin” bandıDört varsayılan hesaptan en az biri aktifBu rehber, 2. adım
Bildirimler ve SLA ancak biri arayüzü açınca ilerliyorOtomatik işlemler “GLPI” kipinde, crontab yokBu rehber, 2. adım
E-postadaki link http:// ile başlıyorGLPI adresi sihirbazdan kalmışBu rehber, 3. adım
LDAP sınaması Strong(er) authentication required(8)Bağlantı 389’dan şifresizLDAP signing
LDAPS sınaması Can't contact LDAP server(-1)Kök sertifika GLPI sunucusunun deposunda yokBu rehber, 4. adım
İçe aktarılan herkes yalnız Self-ServiceYetki kuralının deseni boş kaydedilmişBu rehber, 5. adım
Active Directory’de kapatılan kullanıcı GLPI’da hala içerideAçık oturum sürüyor, GLPI hesabı aktifBu rehber, 5. adım
Agent 403 alıyorEnvanter sunucuda kapalıBu rehber, 7. adım
Linux agent certificate verify failedKök sertifika işletim sisteminin deposunda yokBu rehber, 7. adım
Windows agent wrong credentialsGroup Policy’deki envanter parolası eskiBu rehber, 8. adım
Bültenler ve otomatik yanıtlar destek kaydı oluyorAlıcı kişisel bir kutuyu okuyorBu rehber, 11. adım

Sonuç: GLPI’nın Kurulumu Bir Gün Sürer, Doğruluğu Her Gün Korunur

GLPI’nın sunucusu yarım günde, Active Directory bağlantısı ve yetkiyle birlikte bir günde kurulur ve agent’lar bir sonraki açılışta kendiliğinden gelir. Ama fabrika ayarındaki GLPI, parolası kullanıcı adıyla aynı dört hesabı açık, otomatik işlemleri yarım çalışan ve web kökü yanlış verilirse anahtarlarını tarayıcıya açan bir sistemdir. Listenin ilk yarısı bu varsayılanları kapatır. İkinci yarısı ise bir kez yapılıp bitmez: kategoriler, SLA süreleri ve konum kuralları gelen kayıtlara bakılarak yeniden ayarlanır.

Girişteki benzetmeye dönersek: bina ve kasa sunucu ile public/ web köküdür. Anahtarlar ve mühür, Active Directory bağlantısı ve profillerdir. Kadastro ekibi agent’lardır ve envanter kimliği, dairenin yalnız kendi ekibinin ölçtüğü paftayı kabul etmesini sağlar. Banko helpdesk’tir, arşivin yedek defteri de veritabanı ile anahtar klasörünün yedeğidir. Dairenin değeri ise defterin doğruluğuna bağlıdır, o doğruluğu da her gün biri korur.

GLPI Rehberi Hakkında Sık Sorulan Sorular

Sunucu kurulumu yarım gün sürer. Lab'da Ubuntu 26.04'ün kurulumu yedi buçuk dakika sürdü. GLPI'nın paketlerinden izinlerin sıkılaştırılmasına kadarki kurulum, komutlar hazırken on dakika tuttu, komutları okuyarak ilerleyen biri bunun için bir saat ayırır. HTTPS ve kurulum sonrası ayarlar bir saat aldı. Active Directory bağlantısı ve yetki kuralları bir saatlik iştir. Uzun süren kısım envanterdir: agent'lar Group Policy ile dağıtılır ve her bilgisayar ilk envanterini bir sonraki açılışında ya da agent'ın bekleme süresi dolunca gönderir.
Hepsi değil. Kurulum, HTTPS, varsayılan hesapların kapatılması, zamanlanmış görevler, yedek ve sürüm takibi her kurumda yapılır. Active Directory adımları etki alanı olan kurumda, envanter adımları cihazları GLPI'da tutmak isteyen kurumda, helpdesk adımları destek kayıtlarını GLPI'da açmak isteyen kurumda gerekir. Kontrol listesinde her adımın yanında hangi durumda gerektiği yazıyor.
Evet, plan yapmanız gerekir. GLPI'nın 10.0 dalı 30 Eylül 2026'da çıkan 10.0.28 ile bitti ve artık düzeltme almıyor. Güncel kararlı sürüm 28 Ekim 2026'da çıkan 12.0.1'dir ve bir güvenlik sürümüdür: bir kritik ve altı yüksek önemli açığı kapatır. Yükseltmeden önce veritabanının ve GLPI'nın yapılandırma ve veri klasörlerinin yedeği alınır.
İ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

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 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.

18 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