תחזוקת Apigee mTLS

בדף הזה מתוארות משימות התחזוקה של Apigee mTLS שצריך לבצע באופן קבוע.

החלפת אישורים מקומיים

צריך להחליף את האישורים המקומיים שמותקנים בכל מארח של Apigee באישורים חדשים פעם בשנה. התהליך הזה נקרא רוטציה של אישורים. יש שתי דרכים להחליף אישורים, בהתאם לשאלה אם אתם משתמשים ברשות אישורים בהתאמה אישית או באישורים שמותקנים על ידי Consul.

החלפת אישורים מקומיים בלי רשות אישורים (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) בהתאמה אישית

כדי להחליף אישורים מקומיים באמצעות רשות אישורים בהתאמה אישית:

  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
    הפעלה/עצירה/בדיקה של כל הרכיבים.