Skip to main content

การจัดการจุดติดตั้ง

จุดติดตั้งคือเป้าหมายการปรับใช้ใบรับรองหนึ่งรายการในไฟล์กำหนดค่าของ 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

ขั้นตอนถัดไป​

เมื่อจุดติดตั้งพร้อมแล้ว โปรดกำหนดค่าวิธีการต่ออายุใบรับรอง ดู วิธีการต่ออายุใบรับรอง