Skip to main content

การนำทาง

clmBot คือไคลเอ็นต์น้ำหนักเบาที่ติดตั้งอยู่บนเซิร์ฟเวอร์อินทราเน็ตของคุณ ใช้สำหรับดำเนินการติดตั้งและอัปเดตใบรับรอง SSL โดยอัตโนมัติ: ดึงใบรับรองล่าสุดจากคลาวด์ เขียนลงในจุดติดตั้งใบรับรองบนเซิร์ฟเวอร์ และรันสคริปต์ตามการกำหนดค่าเพื่อโหลดบริการมิดเดิลแวร์ใหม่

วิธีการทำงาน​

กระบวนการอัปเดตใบรับรองของ clmBot มีดังนี้:

  1. ก่อนใบรับรองหมดอายุ คลาวด์จะออกใบรับรองใหม่โดยอัตโนมัติและสร้างใบรับรองใหม่
  2. clmBot รับใบรับรองล่าสุดผ่านการพุชจากคลาวด์หรือการดึงตามเวลา
  3. clmBot พยายามสำรองและแทนที่ไฟล์ใบรับรองภายในเซิร์ฟเวอร์ หากการสำรองล้มเหลวจะบันทึกข้อผิดพลาด แต่จะไม่ขัดขวางการอัปเดตในภายหลัง
  4. clmBot รันสคริปต์โหลดซ้ำตามการกำหนดค่า (after_script) การมีผลหรือไม่ขึ้นอยู่กับผลลัพธ์การรันสคริปต์และสถานะของมิดเดิลแวร์

ตลอดกระบวนการไม่จำเป็นต้องล็อกอินเข้าเซิร์ฟเวอร์ด้วยตนเองเพื่อแทนที่ใบรับรอง และไม่เปิดเผยช่องทางการจัดการเซิร์ฟเวอร์สู่ภายนอก

วิธีการอัปเดตที่รองรับ​

clmBot รองรับวิธีการอัปเดตใบรับรองสองแบบ ซึ่งสามารถเลือกใช้ต่างกันได้ในแต่ละเซิร์ฟเวอร์:

วิธีการอัปเดตโหมดการทำงานข้อกำหนดพอร์ตสถานการณ์ที่เหมาะสม
การพุชจากคลาวด์เริ่มการพุชจากคอนโซลผู้ดูแล ฝั่งบริการ clmBot บนเซิร์ฟเวอร์รับและอัปเดตใบรับรองต้องเปิดพอร์ตขาเข้า 8862/tcpนโยบายเครือข่ายอนุญาตให้เปิดพอร์ตขาเข้า และต้องการให้การอัปเดตมีผลทันที
การดึงตามเวลารัน clmBot ตามเวลาผ่าน crontab หรือ Windows Task Scheduler เพื่อตรวจสอบและดึงใบรับรองล่าสุดไม่ต้องเปิดพอร์ตขาเข้า ต้องเข้าถึงคลาวด์ขาออกเท่านั้นเซิร์ฟเวอร์ที่ไม่สามารถเปิดพอร์ตขาเข้าได้ (แนะนำเป็นค่าเริ่มต้น)

โปรดดู วิธีการอัปเดตใบรับรอง สำหรับรายละเอียดการกำหนดค่า

แพลตฟอร์มและมิดเดิลแวร์ที่รองรับ​

ระบบปฏิบัติการที่รองรับ:

  • Linux (amd64, arm64)
  • macOS (amd64, arm64)
  • Windows (amd64; Windows รุ่นเก่าใช้แพ็กเกจ legacy ที่เข้ากันได้)

มิดเดิลแวร์และรูปแบบใบรับรองที่รองรับ:

มิดเดิลแวร์รูปแบบใบรับรองคำอธิบาย
nginxPEMติดตั้งใบรับรอง, CA chain และคีย์ส่วนตัวแยกกัน
Apache HTTP ServerPEMติดตั้งใบรับรอง, CA chain และคีย์ส่วนตัวแยกกัน
TomcatPEM / JKSรองรับใบรับรอง PEM หรือ JKS keystore
IISIISนำเข้า PFX ผ่านสคริปต์ในตัวและอัปเดตการผูกไซต์ ต้องใช้สิทธิ์ผู้ดูแลระบบ
ExchangeExchangeรองรับเฉพาะการอัปเดต ไม่รองรับการค้นพบ การสอบถาม หรือ sync-server ต้องใช้สิทธิ์ผู้ดูแลระบบ
อื่นๆ (สคริปต์กำหนดเอง)PFX เป็นต้นรองรับทุกสถานการณ์ผ่าน after_script ที่กำหนดเอง

วิธีเลือกเอกสาร​

สถานการณ์การใช้งานหน้าแนะนำ
ใช้งานครั้งแรก ต้องการติดตั้งอย่างรวดเร็วและอัปเดตใบรับรองให้เสร็จหนึ่งครั้งเริ่มต้นอย่างรวดเร็ว
ศึกษาการกำหนดค่าโดยละเอียดของวิธีการอัปเดตสองแบบวิธีการอัปเดตใบรับรอง
เพิ่มจุดติดตั้งด้วยตนเอง ซิงก์จุดติดตั้งจากคอนโซล ใช้หน้าเว็บการกำหนดค่าท้องถิ่นการจัดการจุดติดตั้ง
ดูความหมายของฟิลด์ config.yaml และตัวแปรเทมเพลตสคริปต์เอกสารอ้างอิงการกำหนดค่า
ดูตัวอย่างการติดตั้งและโหลดใบรับรองซ้ำสำหรับมิดเดิลแวร์ เช่น nginx, Apache, Tomcatตัวอย่างการกำหนดค่า
จำกัดสิทธิ์การทำงานของ clmBot ในสภาพแวดล้อมโปรดักชัน และกำหนดค่า sudoersข้อกำหนดสิทธิ์การทำงาน
ลงทะเบียน clmBot เป็นบริการระบบ อัปเกรดเวอร์ชัน ดูบันทึกการติดตั้งเป็นบริการและการอัปเกรด

เริ่มต้นอย่างรวดเร็ว​

หากคุณใช้งาน clmBot เป็นครั้งแรก แนะนำให้ทำตามขั้นตอนต่อไปนี้:

  1. สร้าง AccessKey / AccessSecret ในส่วนผู้ดูแลระบบ
  2. ดาวน์โหลด clmBot และอัปโหลดไปยังเซิร์ฟเวอร์
  3. รัน login เพื่อเชื่อมต่อระบบ และเปิดใช้งานโหนดในส่วนผู้ดูแลระบบ
  4. รัน discover-certificate เพื่อค้นหาใบรับรองบนเซิร์ฟเวอร์โดยอัตโนมัติ
  5. กำหนดค่าวิธีการอัปเดต (พุชหรือดึงตามเวลาที่กำหนด)

โปรดดูขั้นตอนทั้งหมดได้ที่ เริ่มต้นอย่างรวดเร็ว