תחזוקת Apigee mTLS

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

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

צריך להחליף אישורים מקומיים, שמותקנים בכל מארח של 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)

כדי להחליף אישורים מקומיים עם 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

   צפייה הפעלה/עצירה/בדיקה של כל הרכיבים.