การจัดการจุดติดตั้ง
จุดติดตั้งคือเป้าหมายการปรับใช้ใบรับรองหนึ่งรายการในไฟล์กำหนดค่าของ clmBot ซึ่งประกอบด้วยรูปแบบใบรับรอง (format) เส้นทางไฟล์ และสคริปต์อัปเดต โหนด clmBot หนึ่งโหนดสามารถจัดการจุดติดตั้งได้หลายจุด
clmBot มีคำสั่งจัดการจุดติดตั้งดังต่อไปนี้:
| คำสั่ง | วัตถุประสงค์ |
|---|---|
discover-certificate | สแกนใบรับรองในเครื่องนี้ (และคอนเทนเนอร์ Docker) โดยอัตโนมัติและเพิ่มเป็นจุดติดตั้ง |
add-server | เพิ่มจุดติดตั้งด้วยตนเองแบบโต้ตอบ (เขียนเฉพาะการกำหนดค่าในเครื่อง) |
sync-server | ซิงค์จุดติดตั้งในเครื่องไปยังคลาวด์ และปรับเทียบหมายเลขการสมัครรับใบรับรอง |
setup | เริ่มหน้าเว็บกำหนดค่าในเครื่อง เพื่อจัดการจุดติดตั้งในเบราว์เซอร์ |
query-certificate | ดูข้อมูลใบรับรองที่ปรับใช้อยู่ ณ ปัจจุบันของแต่ละจุดติดตั้งแบบอ่านอย่างเดียว |
การค้นหาจุดติดตั้งใบรับรองโดยอัตโนมัติ
รันคำสั่ง discover-certificate เพื่อสแกนใบรับรองที่ปรับใช้แล้วบนเซิร์ฟเวอร์โดยอัตโนมัติ:
./clm-bot-linux-amd64 discover-certificate
ขอบเขตการสแกน:
- Linux: nginx, Apache HTTP Server, Tomcat
- Windows: IIS
หลังจากคำสั่งทำงานเสร็จ จะแสดงข้อมูลใบรับรองที่พบในรูปแบบตาราง (แหล่งที่มา, ประเภท, ผู้ออกใบรับรอง, หัวข้อ, เส้นทาง, จุดเข้าถึง, หมายเลขซีเรียล ฯลฯ) ป้อนหมายเลขลำดับของใบรับรองที่ต้องการอัปโหลดเพื่อยืนยันการเพิ่มเข้าสู่ระบบจัดการหลังบ้าน:
all: อัปโหลดทั้งหมดnone: ไม่อัปโหลด1,3-5: เลือกตามหมายเลขลำดับ รองรับการเขียนแบบช่วง
หลังจากอัปโหลดสำเร็จ ใบรับรองเหล่านี้จะปรากฏเป็นจุดติดตั้งในระบบจัดการหลังบ้าน และ clmBot จะสร้างการกำหนดค่าที่สอดคล้องกันสำหรับแต่ละจุดติดตั้งใน config.yaml
พารามิเตอร์ที่ใช้ได้
| พารามิเตอร์ | คำอธิบาย |
|---|---|
--yes / -y | ข้ามการเลือก อัปโหลดจุดติดตั้งทั้งหมด |
--select | ระบุลำดับที่ต้องการอัปโหลดโดยตรง (all, none หรือ 1,3-5) ไม่สามารถใช้ร่วมกับ --yes ได้ |
--skip-filter / -s | ข้ามการกรองโดเมนของใบรับรอง (SAN) โดยค่าเริ่มต้นจะอัปโหลดเฉพาะใบรับรองที่ตรงกับโดเมนที่อนุญาตบนคลาวด์ |
--scan-docker / -d | สแกนการกำหนดค่า nginx, Apache, Tomcat เพิ่มเติมภายใน Docker container (เฉพาะ Linux/macOS) |
--scan-only | สแกนและแสดงจุดติดตั้งใบรับรองทั้งหมดเท่านั้น โดยไม่เข้าสู่ระบบและไม่อัปโหลด เหมาะสำหรับการตรวจสอบก่อนการติดตั้ง |
สถานการณ์ Docker container
เมื่อใช้ --scan-docker clmBot จะสแกน container ของ nginx, Apache, Tomcat ที่ทำงานอยู่บนเครื่อง:
- พาธของใบรับรองภายใน container ต้องถูกเมาต์ไปยังเครื่องโฮสต์แล้วและสามารถเขียนได้ มิฉะนั้นจุดติดตั้งนั้นจะถูกข้ามไป
- จุดเข้าถึงของจุดติดตั้งจะถูกสร้างโดยใช้ IP และพอร์ตที่เครื่องโฮสต์เผยแพร่ออกมา
- สามารถระบุชื่อ container ที่ต้องการสแกนผ่านตัวแปรสภาพแวดล้อม
CLMBOT_NGINX_CONTAINERS,CLMBOT_APACHE_CONTAINERS,CLMBOT_TOMCAT_CONTAINERS(แยกชื่อ container หลายรายการด้วยเครื่องหมายอัฒภาค)
การเพิ่มจุดติดตั้งด้วยตนเอง
เมื่อใบรับรองบนคลาวด์ไม่ได้ถูกติดตั้งบนเซิร์ฟเวอร์ หรือการสแกนอัตโนมัติไม่สามารถระบุได้ สามารถเพิ่มจุดติดตั้งด้วยตนเองได้:
./clm-bot-linux-amd64 add-server 260101AABBCC pem
พารามิเตอร์ตัวแรกคือหมายเลขการสมัครสมาชิกใบรับรอง พารามิเตอร์ตัวที่สองคือรูปแบบใบรับรอง (pem, pfx, jks, iis หรือ exchange) ป้อนข้อมูลตามคำแนะนำตามลำดับ เช่น ID จุดติดตั้ง และเส้นทางไฟล์ในรูปแบบที่เกี่ยวข้อง
add-server จะเขียนจุดติดตั้งลงใน config.yaml ภายในเครื่องเท่านั้น โดยจะไม่อัปโหลดไปยังคลาวด์โดยอัตโนมัติ หากต้องการซิงค์ไปยังคลาวด์ โปรดดำเนินการ sync-server ต่อ
ซิงค์จุดติดตั้งไปยังคลาวด์
sync-server อัปโหลดจุดติดตั้งจากการกำหนดค่าในเครื่องไปยังคลาวด์ และใช้หมายเลขการสมัครที่คลาวด์ส่งคืนมาเพื่อเสริมหรือปรับเทียบการกำหนดค่าในเครื่อง:
./clm-bot-linux-amd64 sync-server
หลังจากการดำเนินการ รายการจุดติดตั้งในเครื่องจะแสดงขึ้น ให้เลือกตามลำดับรายการที่ต้องการอัปโหลด (รองรับ all, none, 1,3-5 เช่นกัน) หรือใช้ --yes เพื่ออัปโหลดทั้งหมด หรือใช้ --select เพื่อระบุโดยตรง
- หากหมายเลขการสมัครภายในเครื่องว่างเปล่า ระบบจะเติมให้อัตโนมัติ หากไม่ตรงกับบนคลาวด์ ระบบจะแสดงรายการความขัดแย้ง และจะเขียนทับเมื่อยืนยันแล้วเท่านั้น
- จุดติดตั้งในรูปแบบ Exchange ยังไม่รองรับการซิงโครไนส์ในขณะนี้
หน้าเว็บกำหนดค่าในเครื่อง
เมื่อไม่คุ้นเคยกับบรรทัดคำสั่ง สามารถใช้ setup เพื่อเปิดหน้าตั้งค่าในเครื่อง แล้วเพิ่ม แก้ไข และลบจุดติดตั้งในเบราว์เซอร์ได้:
./clm-bot-linux-amd64 setup
หลังจากการทำงานจะแสดงที่อยู่สำหรับเข้าใช้งานพร้อมโทเค็นแบบสุ่ม (รูปแบบเช่น http://localhost:<端口>/setup?token=...) เปิดในเบราว์เซอร์ของเครื่องเซิร์ฟเวอร์เพื่อจัดการจุดติดตั้ง
หน้าการกำหนดค่าจะรับฟังเฉพาะ loopback address ของเครื่องเซิร์ฟเวอร์เท่านั้น ไม่สามารถเข้าถึงจากโฮสต์อื่นได้ อย่าเปิดเผยที่อยู่สำหรับเข้าใช้งานพร้อมโทเค็นแก่บุคคลที่ไม่เกี่ยวข้อง เมื่อใช้งานเสร็จให้กด Ctrl+C (หรือปฏิบัติตามคำแนะนำ) เพื่อหยุดหน้าเพจ
หากต้องการระบุพอร์ต สามารถใช้พารามิเตอร์ -a (เช่น setup -a localhost:8900) ในสภาพแวดล้อมเบราว์เซอร์รุ่นเก่าสามารถเพิ่ม --legacy เพื่อใช้หน้าการกำหนดค่าแบบ HTML ล้วน
ดูข้อมูลใบรับรองของจุดติดตั้ง
query-certificate ใช้สำหรับดูข้อมูลใบรับรองที่ติดตั้งอยู่ในแต่ละจุดติดตั้งแบบอ่านอย่างเดียว (หัวเรื่อง ผู้ออกใบรับรอง หมายเลขซีเรียล) โดยไม่แก้ไขไฟล์ใบรับรอง:
./clm-bot-linux-amd64 query-certificate
โดยค่าเริ่มต้นจะสอบถามจุดติดตั้งทั้งหมด สามารถใช้พารามิเตอร์ -i เพื่อระบุ ID ของจุดติดตั้ง เช่น query-certificate -i nginx_pem
ขั้นตอนถัดไป
เมื่อจุดติดตั้งพร้อมแล้ว โปรดกำหนดค่าวิธีการต่ออายุใบรับรอง ดู วิธีการต่ออายุใบรับรอง