4.19.06.02 – נתוני גרסה של Edge לענן פרטי

כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של Apigee X. מידע

ב-10 במרץ 2020 השקנו גרסה חדשה של Apigee Edge לענן פרטי.

תהליך העדכון

כדי לעדכן את ההתקנה, מבצעים את הפעולות הבאות בצומתי Edge:

1. בכל צומתי Edge:

   1. מנקים את המאגרים של Yum:

      sudo yum clean all

   2. מורידים את הקובץ bootstrap_4.19.06.sh של Edge מגרסה 4.19.06 אל /tmp/bootstrap_4.19.06.sh:

      curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh

   3. מתקינים את Edge 4.19.06 apigee-service, ומתקינים את תוכנת העזר ואת יחסי התלות:

      sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord

      כאשר uName:pWord הם שם המשתמש והסיסמה שקיבלת מ-Apigee. אם לא מזינים את הערך pWord, צריך להזין אותו.

   4. מעדכנים את הכלי apigee-setup:

      sudo /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

   5. משתמשים בפקודה source כדי להפעיל את הסקריפט apigee-service.sh:

      source /etc/profile.d/apigee-service.sh

2. מעדכנים את הכלי apigee validate:

   sudo /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

3. צריך לייבא את שרת ה-proxy החדש של SmartDocs מהתיקייה smartdocs.zip לספרייה /opt/apigee/apigee-validate/bundles ולפרוס אותו כגרסה חדשה. יש לייבא את שרת ה-Proxy החדש לארגון שבו מוגדר כרגע SmartDocs. פריסת שרת ה-proxy כגרסה חדשה תקל על החזרה למצב הקודם, במידת הצורך.

   הערה: לפני הפריסה, צריך לוודא שה-<VirtualHost> בשרת ה-Proxy החדש תואם לתצורה <VirtualHost> שמוגדרת כרגע בסביבה. אם לא, עורכים את שרת ה-proxy לפני הפריסה.

4. בממשק המשתמש של Edge, יוצרים ומעדכנים KVM בשם "smartdocs_whitelist", כפי שמתואר באיור שלמטה. יש ליצור את ה-KVM בארגון ובסביבה שבהם שרת ה-proxy של SmartDocs מופעל כרגע.

   הערה: חשוב לוודא שהתיבה מוצפנת לא מסומנת.

   • מוסיפים מפתח בשם 'is_whitelist_configured', שהערך שלו הוא 'YES'.
   • מוסיפים מפתח שני בשם 'allowed_hosts', כאשר הערכים הם שמות מארחים מופרדים ברווחים או כתובות IP שנקראו מ-SmartDocs. הערך של 'allowed_hosts' צריך לכלול את כל המארחים שכלולים במפרטים של OpenAPI שנוספו ל-SmartDocs. לדוגמה, אם יש לך מפרט OpenAPI שקורא ל-mocktarget.apigee.net, עליך להוסיף את mocktarget.apigee.net לערך 'allowed_hosts'. אם לא נכלל מארח ב-KVM, התגובה של SmartDocs תהיה 400 Bad Request עם מטען ייעודי (payload) של תוכן Bad Request-Hostname not permitted.
   הערה: אם לא מוסיפים ומגדירים את ה-KVM הזה, שרת ה-Proxy לא יאכוף הוספה לרשימת ההיתרים. הפעולה הזו עלולה לגרום לגישה לא מורשית למארחים ולכתובות ה-IP שלך. הערכים של 'allowed_hosts' צריכים לכלול רק שמות מארחים וכתובות IP של נקודות קצה של API שתועדו ב-SmartDocs.

תוכנות נתמכות

ללא.

הוצאה משימוש ופרישה

ללא.

הבאגים תוקנו

בטבלה הבאה מפורטים הבאגים שתוקנו בגרסה הזו:

מזהה הבעיה	התיאור
145340106	נקודת חולשה ב-Apigee SmartDocs API שרת ה-proxy של Apigee SmartDocs עודכן כדי לטפל בנקודות חולשה באבטחה. מידע נוסף והשלבים הנדרשים זמינים בקטע תהליך העדכון.