การบำรุงรักษา mTLS ของ Apigee

หน้านี้อธิบายงานการบำรุงรักษา Apigee mTLS ที่ต้องดำเนินการเป็นประจำ

การหมุนเวียนใบรับรองในเครื่อง

ใบรับรองในเครื่อง ซึ่งติดตั้งบนโฮสต์ Apigee แต่ละรายการจะต้องแทนที่ด้วยใบรับรองใหม่ ทุกปี ซึ่งเรียกว่าการหมุนเวียนใบรับรอง การหมุนเวียนใบรับรองมี 2 วิธี ได้แก่ ขึ้นอยู่กับว่า คุณใช้ผู้ออกใบรับรองที่กำหนดเอง หรือ ใบรับรองที่ติดตั้งโดย Consul

การหมุนเวียนใบรับรองในเครื่องโดยไม่มีผู้ออกใบรับรองที่กำหนดเอง (CA)

วิธีที่ง่ายที่สุดในการหมุนเวียนใบรับรองโดยไม่ใช้ CA ที่กำหนดเองคือ uninstall และ ติดตั้งอีกครั้ง apigee-mtls การดำเนินการนี้จะนำใบรับรองเก่าทั้งหมดออกและสร้างใบรับรองใหม่ในเครื่อง ซึ่งคุณสามารถทำได้โดยใช้ช่วงพักน้อยที่สุดโดยเรียกใช้คำสั่งต่อไปนี้กับแต่ละโฮสต์ ทีละรายการ:

หมายเหตุ: จะถือว่าเป็นไฟล์ silent.conf เดียวกับที่ใช้สำหรับพร็อพเพอร์ตี้ คือการติดตั้งครั้งแรก

1. หยุดคอมโพเนนต์หลักของ Apigee ทั้งหมดดังนี้

   /opt/apigee/apigee-service/bin/apigee-all stop

   โปรดดู เริ่ม/หยุด/ตรวจสอบคอมโพเนนต์ทั้งหมด
2. หยุด apigee-mtls:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mtls stop

3. ถอนการติดตั้ง apigee-mtls:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mtls uninstall

4. ติดตั้ง apigee-mtls อีกครั้ง:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mtls install

5. เรียกใช้ apigee-mtls setup:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mtls setup -f /opt/silent.conf

6. รีสตาร์ท apigee-mtls:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mtls start

7. รีสตาร์ทคอมโพเนนต์หลักของ Apigee ทั้งหมดดังนี้

   /opt/apigee/apigee-service/bin/apigee-all start

   โปรดดู เริ่ม/หยุด/ตรวจสอบคอมโพเนนต์ทั้งหมด

การหมุนเวียนใบรับรองในพื้นที่กับผู้ออกใบรับรองที่กำหนดเอง (CA)

ในการหมุนเวียนใบรับรองในเครื่องด้วย CA ที่กำหนดเอง ให้ทำตามขั้นตอนต่อไปนี้

1. ทำตามขั้นตอนในหัวข้อใช้ใบรับรองที่กำหนดเอง เพื่อสร้างใบรับรองใหม่ที่คุณจะใช้
2. หยุดคอมโพเนนต์หลักของ Apigee ทั้งหมดดังนี้

   /opt/apigee/apigee-service/bin/apigee-all stop

   โปรดดู เริ่ม/หยุด/ตรวจสอบคอมโพเนนต์ทั้งหมด
3. หยุด apigee-mtls:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mtls stop

4. นำไฟล์ใบรับรองในเครื่องไฟล์เก่าออกดังนี้

   rm -f /opt/apigee/apigee-mtls/certs/local_cert.pem
   rm -f /opt/apigee/apigee-mtls/certs/local_key.pem
   rm -f /opt/apigee/apigee-mtls/source/certs/local_cert.pem
   rm -f /opt/apigee/apigee-mtls/source/certs/local_key.pem
   rm -rf /opt/apigee/data/apigee-mtls

5. คัดลอกคู่คีย์/ใบรับรองใหม่ที่สร้างขึ้นในขั้นตอนแรกลงในตำแหน่งต่อไปนี้ และ อัปเดตการอนุญาต:

   cp ${new_cert} /opt/apigee/apigee-mtls/certs/local_cert.pem
   
   chmod \
     --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
     /opt/apigee/apigee-mtls/certs/local_cert.pem
   
   chown \
     --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
     /opt/apigee/apigee-mtls/certs/local_cert.pem
   
   cp ${new_cert} /opt/apigee/apigee-mtls/source/certs/local_cert.pem
   
   chmod \
     --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
     /opt/apigee/apigee-mtls/source/certs/local_cert.pem
   
   chown \
     --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
     /opt/apigee/apigee-mtls/source/certs/local_cert.pem
   
   cp ${new_key} /opt/apigee/apigee-mtls/certs/local_key.pem
   
   chmod \
     --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
     /opt/apigee/apigee-mtls/source/certs/local_cert.pem
   
   chown \
     --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
     /opt/apigee/apigee-mtls/source/certs/local_cert.pem
   
   cp ${new_key} /opt/apigee/apigee-mtls/source/certs/local_key.pem
   
   chmod \
     --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
     /opt/apigee/apigee-mtls/source/certs/local_cert.pem
   
   chown \
     --reference=/opt/apigee/apigee-mtls/certs/ca_cert.pem \
     /opt/apigee/apigee-mtls/source/certs/local_cert.pem

6. รีสตาร์ท apigee-mtls:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mtls start

7. รีสตาร์ทคอมโพเนนต์หลักของ Apigee ทั้งหมดดังนี้

   /opt/apigee/apigee-service/bin/apigee-all start

   โปรดดู เริ่ม/หยุด/ตรวจสอบคอมโพเนนต์ทั้งหมด