Ana içeriğe geç

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:

KomutAmaç
discover-certificateYerel makinedeki (ve Docker konteynerlerindeki) sertifikaları otomatik olarak tarar ve kurulum noktası olarak ekler
add-serverEtkileşimli olarak kurulum noktasını el ile ekler (yalnızca yerel yapılandırmaya yazar)
sync-serverYerel kurulum noktalarını buluta eşitler ve sertifika abonelik numarasını kalibre eder
setupYerel Web yapılandırma sayfasını başlatır, kurulum noktalarını tarayıcıda yönetir
query-certificateHer 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ükle
  • none: Yükleme
  • 1,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​

ParametreAçıklama
--yes / -ySeçimi atla, tüm kurulum noktalarını yükle
--selectYüklenecek sıra numarasını doğrudan belirtin (all, none veya 1,3-5), --yes ile birbirini dışlar
--skip-filter / -sSertifika 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 / -dDocker konteynerleri içindeki nginx, Apache, Tomcat yapılandırmalarını ek olarak tara (yalnızca Linux/macOS)
--scan-onlyYalnı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_CONTAINERS ortam 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.

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

Dikkat

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.