การนำทาง
clmBot คือไคลเอ็นต์น้ำหนักเบาที่ติดตั้งอยู่บนเซิร์ฟเวอร์อินทราเน็ตของคุณ ใช้สำหรับดำเนินการติดตั้งและอัปเดตใบรับรอง SSL โดยอัตโนมัติ: ดึงใบรับรองล่าสุดจากคลาวด์ เขียนลงในจุดติดตั้งใบรับรองบนเซิร์ฟเวอร์ และรันสคริปต์ตามการกำหนดค่าเพื่อโหลดบริการมิดเดิลแวร์ใหม่
วิธีการทำงาน
กระบวนการอัปเดตใบรับรองของ clmBot มีดังนี้:
- ก่อนใบรับรองหมดอายุ คลาวด์จะออกใบรับรองใหม่โดยอัตโนมัติและสร้างใบรับรองใหม่
- clmBot รับใบรับรองล่าสุดผ่านการพุชจากคลาวด์หรือการดึงตามเวลา
- clmBot พยายามสำรองและแทนที่ไฟล์ใบรับรองภายในเซิร์ฟเวอร์ หากการสำรองล้มเหลวจะบันทึกข้อผิดพลาด แต่จะไม่ขัดขวางการอัปเดตในภายหลัง
- clmBot รันสคริปต์โหลดซ้ำตามการกำหนดค่า (
after_script) การมีผลหรือไม่ขึ้นอยู่กับผลลัพธ์การรันสคริปต์และสถานะของมิดเดิลแวร์
ตลอดกระบวนการไม่จำเป็นต้องล็อกอินเข้าเซิร์ฟเวอร์ด้วยตนเองเพื่อแทนที่ใบรับรอง และไม่เปิดเผยช่องทางการจัดการเซิร์ฟเวอร์สู่ภายนอก
วิธีการอัปเดตที่รองรับ
clmBot รองรับวิธีการอัปเดตใบรับรองสองแบบ ซึ่งสามารถเลือกใช้ต่างกันได้ในแต่ละเซิร์ฟเวอร์:
| วิธีการอัปเดต | โหมดการทำงาน | ข้อกำหนดพอร์ต | สถานการณ์ที่เหมาะสม |
|---|---|---|---|
| การพุชจากคลาวด์ | เริ่มการพุชจากคอนโซลผู้ดูแล ฝั่งบริการ clmBot บนเซิร์ฟเวอร์รับและอัปเดตใบรับรอง | ต้องเปิดพอร์ตขาเข้า 8862/tcp | นโยบายเครือข่ายอนุญาตให้เปิดพอร์ตขาเข้า และต้องการให้การอัปเดตมีผลทันที |
| การดึงตามเวลา | รัน clmBot ตามเวลาผ่าน crontab หรือ Windows Task Scheduler เพื่อตรวจสอบและดึงใบรับรองล่าสุด | ไม่ต้องเปิดพอร์ตขาเข้า ต้องเข้าถึงคลาวด์ขาออกเท่านั้น | เซิร์ฟเวอร์ที่ไม่สามารถเปิดพอร์ตขาเข้าได้ (แนะนำเป็นค่าเริ่มต้น) |
โปรดดู วิธีการอัปเดตใบรับรอง สำหรับรายละเอียดการกำหนดค่า
แพลตฟอร์มและมิดเดิลแวร์ที่รองรับ
ระบบปฏิบัติการที่รองรับ:
- Linux (amd64, arm64)
- macOS (amd64, arm64)
- Windows (amd64; Windows รุ่นเก่าใช้แพ็กเกจ legacy ที่เข้ากันได้)
มิดเดิลแวร์และรูปแบบใบรับรองที่รองรับ:
| มิดเดิลแวร์ | รูปแบบใบรับรอง | คำอธิบาย |
|---|---|---|
| nginx | PEM | ติดตั้งใบรับรอง, CA chain และคีย์ส่วนตัวแยกกัน |
| Apache HTTP Server | PEM | ติดตั้งใบรับรอง, CA chain และคีย์ส่วนตัวแยกกัน |
| Tomcat | PEM / JKS | รองรับใบรับรอง PEM หรือ JKS keystore |
| IIS | IIS | นำเข้า PFX ผ่านสคริปต์ในตัวและอัปเดตการผูกไซต์ ต้องใช้สิทธิ์ผู้ดูแลระบบ |
| Exchange | Exchange | รองรับเฉพาะการอัปเดต ไม่รองรับการค้นพบ การสอบถาม หรือ sync-server ต้องใช้สิทธิ์ผู้ดูแลระบบ |
| อื่นๆ (สคริปต์กำหนดเอง) | PFX เป็นต้น | รองรับทุกสถานการณ์ผ่าน after_script ที่กำหนดเอง |
วิธีเลือกเอกสาร
| สถานการณ์การใช้งาน | หน้าแนะนำ |
|---|---|
| ใช้งานครั้งแรก ต้องการติดตั้งอย่างรวดเร็วและอัปเดตใบรับรองให้เสร็จหนึ่งครั้ง | เริ่มต้นอย่างรวดเร็ว |
| ศึกษาการกำหนดค่าโดยละเอียดของวิธีการอัปเดตสองแบบ | วิธีการอัปเดตใบรับรอง |
| เพิ่มจุดติดตั้งด้วยตนเอง ซิงก์จุดติดตั้งจากคอนโซล ใช้หน้าเว็บการกำหนดค่าท้องถิ่น | การจัดการจุดติดตั้ง |
| ดูความหมายของฟิลด์ config.yaml และตัวแปรเทมเพลตสคริปต์ | เอกสารอ้างอิงการกำหนดค่า |
| ดูตัวอย่างการติดตั้งและโหลดใบรับรองซ้ำสำหรับมิดเดิลแวร์ เช่น nginx, Apache, Tomcat | ตัวอย่างการกำหนดค่า |
| จำกัดสิทธิ์การทำงานของ clmBot ในสภาพแวดล้อมโปรดักชัน และกำหนดค่า sudoers | ข้อกำหนดสิทธิ์การทำงาน |
| ลงทะเบียน clmBot เป็นบริการระบบ อัปเกรดเวอร์ชัน ดูบันทึก | การติดตั้งเป็นบริการและการอัปเกรด |
เริ่มต้นอย่างรวดเร็ว
หากคุณใช้งาน clmBot เป็นครั้งแรก แนะนำให้ทำตามขั้นตอนต่อไปนี้:
- สร้าง AccessKey / AccessSecret ในส่วนผู้ดูแลระบบ
- ดาวน์โหลด clmBot และอัปโหลดไปยังเซิร์ฟเวอร์
- รัน
loginเพื่อเชื่อมต่อระบบ และเปิดใช้งานโหนดในส่วนผู้ดูแลระบบ - รัน
discover-certificateเพื่อค้นหาใบรับรองบนเซิร์ฟเวอร์โดยอัตโนมัติ - กำหนดค่าวิธีการอัปเดต (พุชหรือดึงตามเวลาที่กำหนด)
โปรดดูขั้นตอนทั้งหมดได้ที่ เริ่มต้นอย่างรวดเร็ว