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

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

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

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

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

วิธีที่ง่ายที่สุดในการหมุนเวียนใบรับรองโดยไม่มี CA ที่กำหนดเองคือ ถอนการติดตั้งและ ติดตั้ง 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
    ดูหัวข้อ เริ่ม/หยุด/ตรวจสอบคอมโพเนนต์ทั้งหมด