Kurulum Noktası Yönetimi
Kurulum noktaları, clmBot yapılandırma dosyasındaki bir sertifika dağıtım hedefidir ve sertifika biçimi (format), dosya yolu ve güncelleme betiğinden oluşur. Bir clmBot düğümü birden fazla kurulum noktasını yönetebilir.
clmBot aşağıdaki kurulum noktası yönetim komutlarını sağlar:
| Komut | Amaç |
|---|---|
discover-certificate | Yerel makinedeki (ve Docker konteynerlerindeki) sertifikaları otomatik olarak tarar ve kurulum noktası olarak ekler |
add-server | Etkileşimli olarak kurulum noktasını el ile ekler (yalnızca yerel yapılandırmaya yazar) |
sync-server | Yerel kurulum noktalarını buluta eşitler ve sertifika abonelik numarasını kalibre eder |
setup | Yerel Web yapılandırma sayfasını başlatır, kurulum noktalarını tarayıcıda yönetir |
query-certificate | Her kurulum noktasının mevcut dağıtılan sertifika bilgilerini salt okunur olarak görüntüler |
Sertifika kurulum noktalarının otomatik keşfi
discover-certificate komutunu çalıştırarak sunucuda dağıtılmış sertifikaları otomatik olarak tarayın:
./clm-bot-linux-amd64 discover-certificate
- Linux: nginx, Apache HTTP Server, Tomcat.
- Windows: IIS.
Komut çalıştırıldıktan sonra bulunan sertifika bilgileri tablo biçiminde listelenir (kaynak, tür, sertifika otoritesi, konu, yol, erişim noktası, seri numarası vb.). Yüklemek istediğiniz sertifikanın sıra numarasını girerek arka plan yönetimine eklemeyi onaylayın:
all: Tümünü yüklenone: Yükleme1,3-5: Sıra numarasına göre seç, aralık yazımı desteklenir
Yükleme başarılı olduktan sonra bu sertifikalar yönetim arka planında kurulum noktası olarak görünür ve clmBot, config.yaml içinde her kurulum noktası için ilgili yapılandırmayı oluşturur.
Kullanılabilir parametreler
| Parametre | Açıklama |
|---|---|
--yes / -y | Seçimi atla, tüm kurulum noktalarını yükle |
--select | Yüklenecek sıra numarasını doğrudan belirtin (all, none veya 1,3-5), --yes ile birbirini dışlar |
--skip-filter / -s | Sertifika alan adı (SAN) filtresini atlayın; varsayılan olarak yalnızca bulutta izin verilen alan adlarıyla eşleşen sertifikalar yüklenir |
--scan-docker / -d | Docker konteynerleri içindeki nginx, Apache, Tomcat yapılandırmalarını ek olarak tara (yalnızca Linux/macOS) |
--scan-only | Yalnızca tüm sertifika kurulum noktalarını tarayıp listeler; oturum açmaz, yükleme yapmaz; dağıtım öncesi önizleme için uygundur |
Docker konteyner senaryosu
--scan-docker kullanıldığında clmBot, makinede çalışan nginx, Apache ve Tomcat konteynerlerini tarar:
- Konteyner içindeki sertifika yolu ana makineye bağlanmış ve yazılabilir olmalıdır; aksi takdirde ilgili kurulum noktası yok sayılır.
- Kurulum noktasının erişim adresi, ana makinede yayımlanan IP ve port kullanılarak oluşturulur.
CLMBOT_NGINX_CONTAINERS,CLMBOT_APACHE_CONTAINERS,CLMBOT_TOMCAT_CONTAINERSortam değişkenleriyle taranacak konteyner adları belirtilebilir (birden çok konteyner adı noktalı virgülle ayrılır).
Manuel kurulum noktası ekleme
Bulut sertifikası sunucuda dağıtılmadığında veya otomatik tarama kurulum noktasını algılayamadığında manuel olarak kurulum noktası eklenebilir:
./clm-bot-linux-amd64 add-server 260101AABBCC pem
Birinci parametre sertifika abonelik numarası, ikinci parametre sertifika biçimidir (pem, pfx, jks, iis veya exchange). İsteme göre sırayla kurulum noktası ID'sini ve ilgili biçimdeki dosya yolu gibi bilgileri girin.
add-server yalnızca kurulum noktasını yerel config.yaml dosyasına yazar, buluta otomatik olarak yüklemez; bulutla eşitlemeniz gerekiyorsa ardından sync-server komutunu çalıştırın.
Kurulum Noktasını Buluta Eşitleme
sync-server Yerel yapılandırmadaki kurulum noktalarını buluta yükleyin ve buluttan dönen abonelik numarasını kullanarak yerel yapılandırmayı tamamlayın veya kalibre edin:
./clm-bot-linux-amd64 sync-server
Çalıştırdıktan sonra yerel kurulum noktalarını listeler ve yüklenecek öğeyi numaraya göre seçersiniz (aynı şekilde all, none, 1,3-5 desteklenir); ayrıca tümünü yüklemek için --yes veya doğrudan belirtmek için --select kullanabilirsiniz.
- Yerel abonelik numarası boşsa otomatik olarak tamamlanır; bulutla tutarsızsa çakışmalar listelenir ve yalnızca onayladıktan sonra üzerine yazılır.
- Exchange biçimindeki kurulum noktaları şu anda eşitlemeyi desteklemez.
Yerel Web Yapılandırma Sayfası
Komut satırına aşina değilseniz, yerel yapılandırma sayfasını başlatmak için setup kullanabilir ve tarayıcıda kurulum noktalarını ekleyebilir, düzenleyebilir ve silebilirsiniz:
./clm-bot-linux-amd64 setup
Yürütme sonrasında, rastgele bir token içeren bir erişim adresi çıktısı alınır (örneğin http://localhost:<端口>/setup?token=...), sunucunun yerel tarayıcısında açarak kurulum noktasını yönetebilirsiniz.
Yapılandırma sayfası yalnızca sunucunun yerel geri döngü adresini dinler ve diğer ana makinelerden erişilemez. Token içeren erişim adresini yetkisiz kişilerle paylaşmayın; kullanımı tamamladıktan sonra sayfayı durdurmak için Ctrl+C (veya istemlere göre işlem yapın) kullanın.
Belirli bir port belirtmek için -a parametresini kullanabilirsiniz (örneğin setup -a localhost:8900); eski tarayıcı ortamlarında saf HTML yapılandırma sayfasını kullanmak için --legacy ekleyebilirsiniz.
Kurulum noktası sertifika bilgilerini görüntüleme
query-certificate yalnızca okuma modunda her kurulum noktasında mevcut dağıtılan sertifika bilgilerini (konu, veren, seri numarası) görüntüler ve sertifika dosyalarını değiştirmez:
./clm-bot-linux-amd64 query-certificate
Varsayılan olarak tüm kurulum noktaları sorgulanır; kurulum noktası kimliğini belirtmek için -i parametresi kullanılabilir; örneğin query-certificate -i nginx_pem.
Sonraki Adım
Kurulum noktası hazır olduğunda lütfen sertifika yenileme yöntemini yapılandırın; bkz. Sertifika Yenileme Yöntemi.