הרשאת גישה לממשק המשתמש של Edge לכתובות IP מקומיות

Edge for Private Cloud v4.18.01

יש כמה מקומות שבהם ממשק המשתמש של Edge עשוי לנסות לגשת לכתובת IP מקומית. כתובות ה-IP המקומיות האלה עשויות להתאים למשאבים פרטיים או מוגנים אחרים שלא אמורים להיות חשופים למשתמשים חיצוניים:

  • הכלי Trace בממשק המשתמש של Edge יכול לשלוח ולקבל בקשות API לכל כתובת URL שצוינה. בתרחישי פריסה מסוימים שבהם רכיבי Edge מתארחים יחד עם שירותים פנימיים אחרים, משתמש זדוני יכול לנצל לרעה את היכולות של כלי המעקב על ידי שליחת בקשות לכתובות IP פרטיות.
  • כשיוצרים שרת proxy ל-API ממפרט OpenAPI, המפרט מתאר רכיבים של API כמו נתיב הבסיס, נתיבים ופעלים, כותרות ועוד. כחלק מהמפרט, משתמש זדוני יכול לציין נתיב בסיס של שרת ה-proxy שמפנה לכתובת IP פרטית.
  • כשיוצרים שרת proxy ל-API מקובץ WSDL שנמצא במערכת הקבצים המקומית.

מטעמי אבטחה, כברירת מחדל, ממשק המשתמש של Edge לא יכול להפנות לכתובות IP פרטיות. רשימת כתובות ה-IP הפרטיות כוללת:

  • כתובת לולאה חוזרת (loopback) ‏(127.0.0.1 או localhost)
  • כתובות מקומיות באתר (ל-IPv4‏ – 10.0.0.0/8, ‏ 172.16.0.0/12, ‏ 192.168.0.0/16)
  • כל כתובת מקומית (כל כתובת שמובילה ל-localhost).

כדי לאפשר לממשק המשתמש של Edge לגשת לכתובות IP פרטיות, מגדירים את האסימונים הבאים:

  • בכלי Trace, המאפיין conf_apigee-base_apigee.feature.enabletraceforinternaladdresses מושבת כברירת מחדל. מגדירים את הערך true כדי לאפשר לכלי Trace גישה לכתובות IP פרטיות.
  • במפרטי OpenAPI, המאפיין conf_apigee-base_apigee.feature.enableopenapiforinternaladdresses מושבת כברירת מחדל. כדי לאפשר גישה של OpenAPI לכתובות IP פרטיות, צריך להגדיר את הערך True.
  • בקובצי WSDL, המאפיין conf_apigee-base_apigee.feature.enablewsdlforinternaladdresses מושבת כברירת מחדל. צריך להגדיר את הערך True כדי לאפשר העלאה של קובץ WSDL מכתובות IP פרטיות.

כדי להגדיר את המאפיינים האלה כ-true:

  1. פותחים את הקובץ ui.properties בכלי עריכה. אם הקובץ לא קיים, יוצרים אותו.
    > vi /opt/apigee/customer/application/ui.properties
  2. מגדירים את המאפיינים הבאים כ-true:
    conf_apigee-base_apigee.feature.enabletraceforinternaladdresses="true"
    conf_apigee-base_apigee.feature.enableopenapiforinternaladdresses="true"
    conf_apigee-base_apigee.feature.enablewsdlforinternaladdresses="true"
  3. שומרים את השינויים בקובץ ui.properties.
  4. מוודאים שקובץ המאפיינים נמצא בבעלות המשתמש apigee:
    > chown apigee:apigee /opt/apigee/customer/application/ui.properties
  5. מפעילים מחדש את ממשק המשתמש של Edge:
    > ‎/opt/apigee/apigee-service/bin/apigee-service edge-ui restart

עכשיו ממשק המשתמש של Edge יכול לגשת לכתובות IP מקומיות.