Ana içeriğe geç

Navigasyon

clmBot, iç ağ sunucunuzda dağıtılan hafif bir istemcidir; SSL sertifikalarının dağıtımını ve güncellenmesini otomatik olarak tamamlamak için kullanılır: buluttan en son sertifikayı alır, sunucudaki sertifika kurulum noktasına yazar ve yapılandırmaya göre ara katman hizmetini yeniden yüklemek için betiği çalıştırır.

Çalışma Şekli​

clmBot'un sertifika güncelleme süreci şu şekildedir:

  1. Sertifika süresi dolmadan önce bulut otomatik olarak sertifika yeniden imzalamasını tamamlar ve yeni bir sertifika oluşturur.
  2. clmBot, bulut anında iletimi veya zamanlanmış çekme yoluyla en son sertifikayı alır.
  3. clmBot, sunucudaki yerel sertifika dosyalarını yedeklemeyi ve değiştirmeyi dener; yedekleme başarısız olursa hata kaydedilir ancak sonraki güncellemeyi engellemez.
  4. clmBot, yapılandırmaya göre yeniden yükleme betiğini çalıştırır (after_script); etkili olup olmadığı, betiğin çalışma sonucuna ve ara katman durumuna bağlıdır.

Tüm süreç boyunca sertifika değiştirmek için sunucuya manuel olarak giriş yapmanız gerekmez ve sunucunun yönetim girişi dışarıya açılmaz.

Desteklenen Güncelleme Yöntemleri​

clmBot iki sertifika güncelleme yöntemini destekler; farklı sunucularda ayrı ayrı seçilebilir:

Güncelleme yöntemiÇalışma moduPort gereksinimiUygun senaryo
Bulut anında iletimiYönetim arka panelinden iletim başlatılır, sunucudaki clmBot hizmeti alır ve sertifikayı günceller8862/tcp gelen portunun açılması gerekirAğ politikası gelen portu açmaya izin veriyorsa, güncellemenin anında etkili olması isteniyorsa
Zamanlanmış çekmecrontab veya Windows zamanlanmış görev aracılığıyla clmBot zamanlanmış olarak çalıştırılır, en son sertifikayı kontrol eder ve çekerGelen portun açılması gerekmez, yalnızca buluta giden erişim gerekirGelen portun açılamadığı sunucular (önerilen varsayılan yöntem)

Ayrıntılı yapılandırma yöntemleri için bkz. Sertifika güncelleme yöntemleri.

Desteklenen Platformlar ve Ara Katmanlar​

Desteklenen işletim sistemleri:

  • Linux (amd64, arm64)
  • macOS (amd64, arm64)
  • Windows (amd64; eski Windows için legacy uyumluluk paketi)

Desteklenen ara katmanlar ve sertifika biçimleri:

Ara katmanSertifika biçimiAçıklama
nginxPEMSertifika, CA zinciri, özel anahtar ayrı dağıtım
Apache HTTP ServerPEMSertifika, CA zinciri, özel anahtar ayrı dağıtım
TomcatPEM / JKSPEM sertifikasını veya JKS keystore'u destekler
IISIISYerleşik betik aracılığıyla PFX içe aktarılır ve site bağlaması güncellenir, yönetici yetkisi gerekir
ExchangeExchangeYalnızca güncelleme desteklenir; keşif, sorgulama veya sync-server desteklenmez, yönetici yetkisi gerekir
Diğer (özel betik)PFX vb.Özel after_script aracılığıyla her türlü senaryo desteklenir

Doküman Nasıl Seçilir​

Kullanım senaryosuÖnerilen sayfa
İlk kez kullanım, hızlı dağıtım ve tek seferlik sertifika güncellemesi yapılmak isteniyorHızlı başlangıç
İki güncelleme yönteminin ayrıntılı yapılandırması hakkında bilgi edinmekSertifika güncelleme yöntemleri
Kurulum noktalarını manuel eklemek, arka panelden kurulum noktalarını senkronize etmek, yerel Web yapılandırma sayfasını kullanmakKurulum noktası yönetimi
config.yaml alan anlamlarını ve script şablon değişkenlerini görüntülemeYapılandırma Referansı
nginx, Apache, Tomcat gibi ara katmanlarda sertifika kurulumu ve yeniden yükleme komut örneklerini görüntülemeYapılandırma Örnekleri
Üretim ortamında clmBot çalıştırma izinlerini kısıtlama ve sudoers yapılandırmaÇalıştırma İzin Gereksinimleri
clmBot'u sistem hizmeti olarak kaydetme, sürüm yükseltme ve günlükleri görüntülemeHizmetleştirme Dağıtımı ve Yükseltme

Hızlı Başlangıç​

clmBot'u ilk kez kullanıyorsanız, aşağıdaki yolu izlemeniz önerilir:

  1. Yönetim panelinde AccessKey / AccessSecret oluşturun.
  2. clmBot'u indirin ve sunucuya yükleyin.
  3. login komutunu çalıştırarak bağlantıyı tamamlayın ve paneldeki düğümü etkinleştirin.
  4. discover-certificate komutunu çalıştırarak sunucudaki sertifikaları otomatik olarak keşfedin.
  5. Güncelleme yöntemini yapılandırın (anında gönderim veya zamanlanmış çekme).

Tam adımlar için bkz. Hızlı Başlangıç。