Apache HTTP Server

SecTrail CM, Apache HTTP Server'lara ajansız bağlantı kurarak SSL sertifikalarının otomatik dağıtımını ve yenilenmesini sağlar.

Bağlantı Gereksinimleri

Gereksinim	Detay	Açıklama
Protokol	SSH (Secure Shell)	Güvenli uzak bağlantı protokolü
Port	22	Standart SSH portu veya custom port
Kimlik Doğrulama	SSH Key veya Password	SSH anahtarı veya şifre ile kimlik doğrulama
Kullanıcı Yetkisi	Sınırlı sudo yetkisi	Bkz. En Az Yetkili Kullanıcı

Otomatik İşlemler

SecTrail CM, Apache HTTP Server üzerinde aşağıdaki işlemleri otomatik gerçekleştirir:

1. Sertifika ve Key Yükleme: SSL sertifikası, private key ve chain dosyasının güvenli transferi
2. Konfigürasyon Güncelleme: Apache VirtualHost SSL direktiflerinin güncellenmesi
3. Konfigürasyon Testi: Sözdizimi kontrolü ve doğrulama
4. Servis Yeniden Başlatma: Apache servisinin yeniden başlatılması (restart)

En Az Yetkili Kullanıcı

SecTrail CM kullanıcısına tam root yetkisi vermeniz gerekmez. Aşağıdaki iki adım yeterlidir.

1. sudo kuralı ekleyin (visudo -f /etc/sudoers.d/sectrail):

<user> ALL=(root) NOPASSWD: <apachectl> restart, <apachectl> -t -D DUMP_VHOSTS, /bin/cat <cert_dizini>/*

2. Sertifika dizinine yazma yetkisi verin:

setfacl -R -m u:<user>:rwx <cert_dizini>

• <user>: Device Users'ta tanımladığınız kullanıcı
• <apachectl>: apachectl dosyasının tam yolu (cihazın Custom Path alanıyla aynı olmalıdır)
• <cert_dizini>: Sertifika ve key dosyalarının bulunduğu dizin

Örnek (kullanıcı sectrail, apachectl /usr/sbin/apachectl, sertifikalar /etc/httpd/ssl):

sectrail ALL=(root) NOPASSWD: /usr/sbin/apachectl restart, /usr/sbin/apachectl -t -D DUMP_VHOSTS, /bin/cat /etc/httpd/ssl/*
setfacl -R -m u:sectrail:rwx /etc/httpd/ssl

Yapılandırma Adımları

1. Apache Linux Kullanıcı Oluşturma

Automation > Device Users bölümüne gidin ve Apache için kullanıcı oluşturun.

2. Apache Cihazını SecTrail CM'e Ekleme

Automation > Devices > Add New Device butonuna tıklayın ve aşağıdaki bilgileri girin:

• Name: Cihaz için tanımlayıcı isim verin
• Device Users: Adım 1'de oluşturduğunuz kullanıcıyı seçin
• IP: Apache sunucusunun IP adresini girin
• Device Type: Açılır menüden Apache Linux seçin
• Become Method: Yetki yükseltme yöntemini seçin
• Custom Path: Apache binary dosyasının yolunu girin (örn: /usr/sbin/apachectl)
• Execution Server: Dağıtım işlemlerini yürütmek için kullanılacak sunucu

Otomatik Keşif

Apache cihazı SecTrail CM'e eklendikten sonra, cihazda tanımlı tüm Virtual Host'ların IP adresleri ve portları otomatik olarak keşif periyoduna dahil edilir ve düzenli olarak taranır.

3. Cihaz Bilgilerini Görüntüleme

Cihaz eklendikten sonra Automation > Devices listesinde görüntülenecektir. Cihaz detaylarını görmek için satıra tıklayın:

• Port: Apache'nin dinlediği portlar (örn: *:443, *:444)
• Server Name: VirtualHost server name veya * (tüm hostlar)
• Configurations: Apache konfigürasyon dosyası yolu (örn: /etc/httpd/conf.d/cm-ssl.conf)
• Others: Mevcut SSL konfigürasyon detayları
• Deploy: Sertifika dağıtımı için

Sertifika Dağıtımı

Adım 1: Virtual Host ve Sertifika Seçimi

1. Automation > Devices bölümünden Apache cihazınızı seçin
2. Cihaz detaylarında, sertifika dağıtmak istediğiniz Virtual Host'u bulun
3. İlgili satırdaki Deploy butonuna tıklayın
4. Açılan Deploy Certificate penceresinde:
   • Virtual Servers: Hedef Virtual Host bilgisi görüntülenir (IP, port, server name)
   • Certificate: Açılır menüden dağıtmak istediğiniz sertifikayı seçin

Adım 2: Dağıtım İşlemini Başlatma

Deploy butonuna tıklayarak sertifika dağıtım işlemini başlatın.

Adım 3: İşlem Takibi

Dağıtım işlemi Automation > Processes bölümünden takip edilebilir:

İşlem Detayları

Dağıtım sırasında aşağıdaki adımlar gerçekleştirilir:

Adım	İşlem Açıklaması
1	Sertifika, key ve chain dosyaları sunucuya yüklenir
2	Mevcut sertifika dosyaları yedeklenir
3	Yeni sertifika konfigürasyonu uygulanır
4	Apache servisi yeniden başlatılır (restart)

Geri Alma İşlemi

Sertifika dağıtımı sonrasında sorun yaşanması durumunda Manual Rollback özelliği kullanılabilir.

Otomatik Geri Alma

Dağıtım işlemi sırasında herhangi bir adımda hata oluşması durumunda, sistem otomatik olarak geri alma işlemini gerçekleştirir ve tüm değişiklikler geri alınır.

Geri Alma Adımları

1. Automation > Processes bölümüne gidin
2. Geri almak istediğiniz işlemi bulun
3. Status sütununda Manual-Rollback seçeneğini kullanın
4. Onay verin

Geri Alma Sırasında Gerçekleşen İşlemler

Adım	İşlem
1	Yeni konfigürasyon kaldırılır
2	Yedeklenen sertifika dosyaları geri yüklenir
3	Yeni yüklenen sertifika, key ve chain dosyaları silinir
4	Apache servisi yeniden başlatılır (restart)