נתוני גרסה של Edge Microgateway

אתם קוראים את מאמרי העזרה של Apigee Edge.
כדאי לעיין במסמכי העזרה בנושא Apigee X. מידע

גרסה 3.3.x

תיקוני באגים ושיפורים בגרסה 3.3.x

3.3.7

ב-17 ביולי 2025, פרסמנו את התיקונים והשיפורים הבאים ב-Edge Microgateway.

תיקוני באגים ושיפורים:

edgemicro:
  plugins:
    excludeUrls: '/hello,/proxy_one/*' # global exclude urls
    sequence:
      -oauth
      -json2xml
      -quota
      -json2xml:
          excludeUrls: '/hello/xml/*'  # plugin level exclude urls

בעיות אבטחה שתוקנו

• CVE-2024-12905
• CVE-2025-46653

3.3.6

ב-16 באפריל 2025, פרסמנו את התיקונים והשיפורים הבאים ב-Edge Microgateway:

גרסאות הרכיבים:

בטבלה הבאה מפורטים מספרי הגרסאות של פרויקטים של רכיבים נפרדים שמשויכים ל-Edge Microgateway 3.3.6. חשוב לזכור שכל רכיב הוא פרויקט נפרד, ולכן יכול להיות שמספרי הגרסאות לא יהיו זהים לגרסת המוצר הראשית:

בעיות אבטחה שתוקנו

• CVE-2025-27789
• CVE-2024-21538
• CVE-2024-12133

3.3.5

ביום שישי, 20 בדצמבר 2024, פרסמנו את התיקונים והשיפורים הבאים ב-Edge Microgateway.

גרסאות הרכיבים:

בטבלה הבאה מפורטים מספרי הגרסאות של פרויקטים של רכיבים נפרדים שמשויכים ל-Edge Microgateway 3.3.5. חשוב לזכור שכל רכיב הוא פרויקט נפרד, ולכן יכול להיות שמספרי הגרסאות לא יהיו זהים לגרסת המוצר הראשית:

תיקוני באגים ושיפורים:

current nodejs version is  18.x.x Note, v18.x.x will be out of support soon, see https://docs.apigee.com/release/notes/edge-microgateway-release-notes-0

You are using a version of NodeJS that is not supported

בעיות אבטחה שתוקנו

• CVE-2024-21538
• CVE-2024-45590
• CVE-2019-3844
• CVE-2019-12290
• CVE-2020-1751
• CVE-2018-12886
• CVE-2023-50387
• CVE-2019-3843
• CVE-2022-4415
• CVE-2021-3997

3.3.4

ב-18 בספטמבר 2024, פרסמנו את התיקונים והשיפורים הבאים ב-Edge Microgateway.

גרסאות הרכיבים:

בטבלה הבאה מפורטים מספרי הגרסאות של פרויקטים של רכיבים נפרדים שמשויכים ל-Edge Microgateway 3.3.4. חשוב לזכור שכל רכיב הוא פרויקט נפרד, ולכן יכול להיות שמספרי הגרסאות לא יהיו זהים לגרסת המוצר הראשית:

תיקוני באגים ושיפורים:

בעיות אבטחה שתוקנו

• CVE-2021-23337
• CVE-2024-4068
• CVE-2020-28469
• CVE-2020-28503

3.3.3

ב-25 באפריל 2024 פרסמנו את התיקונים והשיפורים הבאים ב-Edge Microgateway.

גרסאות הרכיבים:

בטבלה הבאה מפורטים מספרי הגרסאות של פרויקטים של רכיבים נפרדים שמשויכים ל-Edge Microgateway 3.3.3. חשוב לזכור שכל רכיב הוא פרויקט נפרד, ולכן יכול להיות שמספרי הגרסאות לא יהיו זהים לגרסת המוצר הראשית:

תיקוני באגים ושיפורים:

בעיות אבטחה שתוקנו

• CVE-2023-0842
• CVE-2023-26115
• CVE-2022-25883
• CVE-2017-20162
• CVE-2022-31129
• CVE-2022-23539
• CVE-2022-23541
• CVE-2022-23540
• CVE-2024-21484
• CVE-2022-46175
• CVE-2023-45133
• CVE-2020-15366
• CVE-2023-26136
• CVE-2023-26115

3.3.2

ב-18 באוגוסט 2023 פרסמנו את התיקונים והשיפורים הבאים ב-Edge Microgateway.

גרסאות הרכיבים:

בטבלה הבאה מפורטים מספרי הגרסאות של פרויקטים של רכיבים נפרדים שמשויכים ל-Edge Microgateway 3.3.2. חשוב לזכור שכל רכיב הוא פרויקט נפרד, ולכן יכול להיות שמספרי הגרסאות לא יהיו זהים לגרסת המוצר הראשית:

תיקוני באגים ושיפורים:

בעיות אבטחה שתוקנו

ללא.

3.3.1

ב-7 ביוני 2022 פרסמנו את התיקונים והשיפורים הבאים ב-Edge Microgateway.

גרסאות הרכיבים:

בטבלה הבאה מפורטים מספרי הגרסאות של פרויקטים של רכיבים נפרדים שמשויכים ל-Edge Microgateway 3.3.1. חשוב לזכור שכל רכיב הוא פרויקט נפרד, ולכן יכול להיות שמספרי הגרסאות לא יהיו זהים לגרסת המוצר הראשית:

תיקוני באגים ושיפורים:

בעיות אבטחה שתוקנו

3.3.0

ב-4 בפברואר 2022 פרסמנו את התיקונים והשיפורים הבאים ב-Edge Microgateway.

גרסאות הרכיבים:

בטבלה הבאה מפורטים מספרי הגרסאות של פרויקטים של רכיבים נפרדים שמשויכים ל-Edge Microgateway 3.3.0. חשוב לזכור שכל רכיב הוא פרויקט נפרד, ולכן יכול להיות שמספרי הגרסאות לא יהיו זהים לגרסת המוצר הראשית:

תיקוני באגים ושיפורים:

npm install apigeetool@0.15.1

גרסה 3.2.x

תיקוני באגים ושיפורים בגרסה 3.2.x

3.2.3

ב-17 בספטמבר 2021 פרסמנו את התיקונים והשיפורים הבאים ב-Edge Microgateway.

גרסאות הרכיבים:

בטבלה הבאה מפורטים מספרי הגרסאות של פרויקטים של רכיבים נפרדים שמשויכים ל-Edge Microgateway 3.2.3. חשוב לזכור שכל רכיב הוא פרויקט נפרד, ולכן יכול להיות שמספרי הגרסאות לא יהיו זהים לגרסת המוצר הראשית:

תיקוני באגים ושיפורים:

בעיות אבטחה שתוקנו

3.2.2

ביום חמישי, 15 ביולי 2021, פרסמנו את התיקונים והשיפורים הבאים ב-Edge Microgateway.

גרסאות הרכיבים:

בטבלה הבאה מפורטים מספרי הגרסאות של פרויקטים של רכיבים נפרדים שמשויכים ל-Edge Microgateway 3.2.2. חשוב לזכור שכל רכיב הוא פרויקט נפרד, ולכן יכול להיות שמספרי הגרסאות לא יהיו זהים לגרסת המוצר הראשית:

תיקוני באגים ושיפורים:

בעיות אבטחה שתוקנו

3.2.1

ביום שישי, 5 במרץ 2021, פרסמנו את התיקונים והשיפורים הבאים ב-Edge Microgateway.

גרסאות הרכיבים:

בטבלה הבאה מפורטים מספרי הגרסאות של פרויקטים של רכיבים נפרדים שמשויכים ל-Edge Microgateway 3.2.1. חשוב לזכור שכל רכיב הוא פרויקט נפרד, ולכן יכול להיות שמספרי הגרסאות לא יהיו זהים לגרסת המוצר הראשית:

תיקוני באגים ושיפורים:

edgemicro:
 enable_GET_req_body: true

3.2.0

ביום חמישי, 21 בינואר 2021, השקנו את התיקונים והשיפורים הבאים ב-Edge Microgateway.

גרסאות הרכיבים:

בטבלה הבאה מפורטים מספרי הגרסאות של פרויקטים של רכיבים נפרדים שמשויכים ל-Edge Microgateway 3.2.0. חשוב לזכור שכל רכיב הוא פרויקט נפרד, ולכן יכול להיות שמספרי הגרסאות לא יהיו זהים לגרסת המוצר הראשית:

תיקוני באגים ושיפורים:

גרסה 3.1.x

תיקוני באגים ושיפורים בגרסה 3.1.x

3.1.8

ביום שני, 16 בנובמבר 2020, פרסמנו את התיקונים והשיפורים הבאים ב-Edge Microgateway.

גרסאות הרכיבים:

בטבלה הבאה מפורטים מספרי הגרסאות של פרויקטים של רכיבים נפרדים שמשויכים ל-Edge Microgateway 3.1.8. חשוב לזכור שכל רכיב הוא פרויקט נפרד, ולכן יכול להיות שמספרי הגרסאות לא יהיו זהים לגרסת המוצר הראשית:

תיקוני באגים ושיפורים:

3.1.7

ביום חמישי, 24 בספטמבר 2020, פרסמנו את התיקונים והשיפורים הבאים ב-Edge Microgateway.

גרסאות הרכיבים:

בטבלה הבאה מפורטים מספרי הגרסאות של פרויקטים של רכיבים נפרדים שמשויכים ל-Edge Microgateway 3.1.7. חשוב לזכור שכל רכיב הוא פרויקט נפרד, ולכן יכול להיות שמספרי הגרסאות לא יהיו זהים לגרסת המוצר הראשית:

תיקוני באגים ושיפורים:

{"message":"write after end","code":"ERR_STREAM_WRITE_AFTER_END"}

3.1.6

ביום חמישי, 20 באוגוסט 2020, השקנו את התיקונים והשיפורים הבאים ב-Edge Microgateway.

גרסאות הרכיבים:

בטבלה הבאה מפורטים מספרי הגרסאות של פרויקטים של רכיבים נפרדים שמשויכים ל-Edge Microgateway 3.1.6. חשוב לזכור שכל רכיב הוא פרויקט נפרד, ולכן יכול להיות שמספרי הגרסאות לא יהיו זהים לגרסת המוצר הראשית:

תיקוני באגים ושיפורים:

3.1.5

ביום שישי, 26 ביוני 2020, פרסמנו את התיקונים והשיפורים הבאים ב-Edge Microgateway.

גרסאות הרכיבים:

בטבלה הבאה מפורטים מספרי הגרסאות של פרויקטים של רכיבים נפרדים שמשויכים ל-Edge Microgateway 3.1.5. חשוב לזכור שכל רכיב הוא פרויקט נפרד, ולכן יכול להיות שמספרי הגרסאות לא יהיו זהים לגרסת המוצר הראשית:

תיקוני באגים ושיפורים:

3.1.4

ביום שישי, 23 באפריל 2020, פרסמנו את התיקון הבא ל-Edge Microgateway.

תיקון באגים:

תוקנה בעיית תלות בגרסה 3.1.3. גרסה 3.1.3 סומנה כמוצאת משימוש במאגר npm. אחרת, כל תיקוני הבאגים והשיפורים שמתוארים בנתוני הגרסה 3.1.3 חלים על הגרסה הזו.

3.1.3

ביום רביעי, 15 באפריל 2020, פרסמנו את התיקונים והשיפורים הבאים ב-Edge Microgateway.

גרסאות הרכיבים:

בטבלה הבאה מפורטים מספרי הגרסאות של פרויקטים של רכיבים נפרדים שמשויכים ל-Edge Microgateway 3.1.3. חשוב לזכור שכל רכיב הוא פרויקט נפרד, ולכן יכול להיות שמספרי הגרסאות לא יהיו זהים לגרסת המוצר הראשית:

תיקוני באגים ושיפורים:

• ‫153509313 – תוקנה בעיה שבה מודול ניפוי הבאגים של Node.js גורם לדליפות זיכרון. הבעיה קיימת בגרסאות v3.1.0,‏ v3.1.1 ו-3.1.2.
• ‫153509313 – תוקנה בעיה שבה מזהה הודעה זהה לשתי עסקאות שונות הודפס בפלט של הרישום ביומן.
• ‫151673570 – תוקנה בעיה שבה Edge Microgateway לא עודכן לשימוש בממשקי Apigee KVM API חדשים. ‫Edge Microgateway משתמש עכשיו בפקודות החדשות להוספה ולעדכון של ערכי KVM.
• ‫152822846 – במהדורות קודמות, בוצע עדכון ב-Edge Microgateway כך שהעיבוד שלו של מיפוי נתיבי משאבים תואם לעיבוד ב-Apigee Edge. בגרסה הזו, תוקנה בעיה שבה הדפוס /literal_string/* לא טופל בצורה נכונה. לדוגמה: /*/2/*. אפשר גם לעיין במאמר הגדרת ההתנהגות של נתיב משאב מסוג '/',‏ '/*‎' ו-'/**‎'.
• ‫152005003 – בוצעו שינויים כדי להפעיל מזהים בהיקף הארגון והסביבה למכסות.
• ‫152005003 – בוצעו שינויים כדי להפעיל מזהים בהיקף הארגון והסביבה למכסות. השילוב של org + env + appName + productName משמש כמזהה של המכסה.

3.1.2

ביום שני, 16 במרץ 2020, השקנו את התיקונים והשיפורים הבאים ב-Edge Microgateway.

גרסאות הרכיבים:

בטבלה הבאה מפורטים מספרי הגרסאות של פרויקטים של רכיבים נפרדים שמשויכים ל-Edge Microgateway 3.1.3. חשוב לזכור שכל רכיב הוא פרויקט נפרד, ולכן יכול להיות שמספרי הגרסאות לא יהיו זהים לגרסת המוצר הראשית:

תיקוני באגים ושיפורים:

• ‫151285018 – בוצע שיפור בתכונה כדי להוסיף תמיכה ב-HTTP proxy לתנועה בין Edge Microgateway ליעדי backend. בנוסף, תוקנו בעיות בתמיכה הקיימת ב-proxy מסוג HTTP בין Edge Microgateway לבין Apigee Edge. פרטים נוספים זמינים במאמרים הבאים:
  • שימוש ב-proxy מסוג HTTP לתקשורת עם Apigee Edge
  • שימוש ב-HTTP proxy לתקשורת עם היעד
• ‫149101890 – קוד ההתראה ביומן למקרים שבהם שרת היעד או מאזן העומסים סוגר את החיבור שלו השתנה מ-ERROR ל-INFO.
• ‫150746985 – תוקנה בעיה שבה הפקודה edgemicro verify לא פעלה כראוי אם redisBasedConfigCache: true או quotaUri: https://%s-%s.apigee.net/edgemicro-auth הופיעו בקובץ ההגדרות.
• ‫151284716 – בוצע שיפור לסגירת חיבורי שרת מהר יותר כשמפעילים מחדש עובדים במהלך טעינה מחדש.
• ‫151588764 – עדכון גרסת Node.js בקובץ האימג' של Docker שמשמש להפעלת Edge Microgateway במאגר Docker לגרסה 12, כי גרסה 8 של Node.js הוצאה משימוש.
• ‫151306049 – בוצע עדכון במסמכי התיעוד כדי לפרט את ממשקי ה-API לניהול של Apigee Edge שמשמשים את הפקודות של Edge Microgateway CLI. אילו ממשקי ניהול API משמשים את Edge Microgateway?

3.1.1

ביום חמישי, 20 בפברואר, פרסמנו את התיקונים והשיפורים הבאים ב-Edge Microgateway.

גרסאות הרכיבים:

בטבלה הבאה מפורטים מספרי הגרסאות של פרויקטים של רכיבים נפרדים שמשויכים ל-Edge Microgateway 3.1.1. חשוב לזכור שכל רכיב הוא פרויקט נפרד, ולכן יכול להיות שמספרי הגרסאות לא יהיו זהים לגרסת המוצר הראשית:

תיקוני באגים ושיפורים:

• ‫146069701 – תוקנה בעיה שבה מודול microgateway-core לא כיבד את משתני הסביבה HTTP_PROXY ו-HTTPS_PROXY. בעקבות השינוי הזה, המערכת מתעלמת מהגדרות ה-proxy בקובץ התצורה של YAML, אם הן מצוינות. רק משתני הסביבה משמשים לציון ה-proxy.

  אם רוצים לציין הגדרת proxy בקובץ התצורה, צריך גם לציין משתנה HTTP_PROXY שכולל את אותה כתובת URL של proxy שצוינה בקובץ התצורה. לדוגמה, אם תגדירו את ההגדרה הבאה:

  edge_config:
    proxy: http://10.128.0.20:3128
    proxy_tunnel: true

  צריך גם לציין את משתנה הסביבה הזה:

  HTTP_PROXY=http://10.128.0.20:3128

• ‫146320620 – נוסף פרמטר הגדרה חדש, edgemicro.headers_timeout. המאפיין הזה מגביל את משך הזמן (באלפיות שנייה) שבו מנתח ה-HTTP ימתין לקבלת כותרות ה-HTTP המלאות. לדוגמה:

  edgemicro:
  keep_alive_timeout: 6000
  headers_timeout: 12000

  באופן פנימי, הפרמטר מגדיר את המאפיין Server.headersTimeout בבקשות ב-Node.js. (ברירת מחדל: 5 שניות יותר מהזמן שמוגדר באמצעות edgemicro.keep_alive_timeout. ההגדרה הזו מונעת ממאזני עומסים או משרתי proxy להפיל את החיבור בטעות).

• ‫149278885 – נוספה תכונה חדשה שמאפשרת להגדיר את הזמן הקצוב לתפוגה של ה-API לטירגוט ברמת ה-API proxy, במקום להשתמש בהגדרת זמן קצוב לתפוגה גלובלית אחת.

  אם מגדירים את המאפיין TargetEndpoint‏ io.timeout.millis ב-API Proxy, ‏ Edge Microgateway יוכל לאחזר את המאפיין הזה ולהחיל פסק זמן ספציפי לנקודת קצה של יעד. אם לא מציינים את הפרמטר הזה, Edge Microgateway משתמש בערך הזמן הקצוב לתפוגה הגלובלי שצוין באמצעות edgemicro.request_timeout.

3.1.0

ביום שלישי, 21 בינואר, השקנו את התיקונים והשיפורים הבאים ב-Edge Microgateway.

גרסאות הרכיבים:

בטבלה הבאה מפורטים מספרי הגרסאות של פרויקטים של רכיבים נפרדים שמשויכים ל-Edge Microgateway 3.1.0. חשוב לזכור שכל רכיב הוא פרויקט נפרד, ולכן יכול להיות שמספרי הגרסאות לא יהיו זהים לגרסת המוצר הראשית:

תיקוני באגים ושיפורים:

• ‫144187500 – אירוע חדש ברמת אזהרה יתועד ביומן כשהדגל quotas.failOpen יופעל. הדגל הזה מופעל אם מתרחשת שגיאה בעיבוד המכסה או אם הבקשה 'quota apply' אל Edge לא מצליחה לעדכן את מוני המכסה המרוחקים. במקרה כזה, המכסה תעובד על סמך ספירות מקומיות בלבד עד לסנכרון הבא של המכסה מרחוק. בעבר, האירוע הזה נרשם ביומן רק כשנקבעה רמת הרישום DEBUG.

  לדוגמה:

  2020-01-20T02:52:53.040Z [warn][localhost:8000][5][foo-eval][test][hello/][]
  [DbpGIq9jKfzPX8jvXEivhA0LPwE][f372cc30-3b2f-11ea-845f-a627f][quota][remote quota not
  available so processing locally, setting quota-failed-open for identifier: AppQuota60.Quota60]
  [GET][][][][]

• ‫145023519 – תוקנה בעיה שבה עסקאות בתהליך או עסקאות חדשות הושפעו בכל פעם ש-Edge Microgateway זיהה שינוי ב-API proxy. עכשיו, כשמתבצע שינוי בשרת proxy, Edge Microgateway מרענן את המטמון וצמתי העובדים מופעלים מחדש. השינוי הזה לא ישפיע על טרנזקציות פעילות ועל קריאות חדשות ל-API שנשלחות למיקרו-שער.
• ‫146378327 – רמת היומן של sourceRequest,‏ targetRequest ו-targetResponse שונתה לרמה INFO.
• ‫146019878 – תוקנה אי-התאמה בין זמן האחזור שחושב עבור 'ביצועים של API Proxy' בניתוח הנתונים של Edge לבין אירועי יומן של sourceResponse/targetResponse ב-Edge Microgateway. עכשיו, ההשהיה בניתוח הנתונים ב-Edge ובאירועים ביומן של Microgateway זהה.
• שינויים שקשורים ללוגיקה של התאמת תבניות:
  • ‫147027862 – הפלאגין oauth עודכן כדי לתמוך בדפוסי התאמה של נתיבי המשאבים הבאים, כפי שמצוין במוצרי API:
    • /{literal}**
    • /{literal}*
    • כל שילוב של שני הדפוסים שלמעלה

    בעקבות השינוי הזה, הפלאגין Edge Microgateway פועל עכשיו לפי אותו דפוס של התאמה, כמו ב-Apigee Edge, כפי שמוסבר במאמר הגדרת ההתנהגות של נתיב משאב עם הערכים '/‎', '/*‎' ו-'/**‎'.

  • ‫145644205 – עדכון לוגיקת ההתאמה לתבניות של הפלאגין apiKeys כדי שתתאים לפלאגין oauth.
• ‫143488312 – תוקנה בעיה שבה רווחים מובילים או נגררים בפרמטר client ID גרמו לכך שרשימת המוצרים של JWT הייתה ריקה בבקשות של אסימון OAuth ומפתח API.
• ‫145640807 ו-147579179 – נוספה תכונה חדשה שמאפשרת למופע מיוחד של Edge Microgateway שנקרא 'המסנכרן' לאחזר נתוני הגדרה מ-Apigee Edge ולכתוב אותם במסד נתונים מקומי של Redis. אחר כך אפשר להגדיר מופעים אחרים של מיקרו-שער כדי לקרוא את נתוני ההגדרה שלהם ממסד הנתונים. התכונה הזו מוסיפה רמת עמידות ל-Edge Microgateway. היא מאפשרת להפעיל מופעים של מיקרו-שער ולגרום להם לפעול בלי צורך לתקשר עם Apigee Edge. פרטים נוספים זמינים במאמר בנושא שימוש בכלי הסנכרון.

  התכונה של סנכרון נתמכת כרגע ב-Redis 5.0.x.

גרסה 3.0.x

תיקוני באגים ושיפורים בגרסה 3.0.x

3.0.10

ביום שישי, 8 בנובמבר, פרסמנו את התיקונים והשיפורים הבאים ב-Edge Microgateway.

גרסאות הרכיבים:

בטבלה הבאה מפורטים מספרי הגרסאות של פרויקטי הרכיבים השונים שמשויכים ל-Edge Microgateway 3.0.10. חשוב לזכור שכל רכיב הוא פרויקט נפרד, ולכן יכול להיות שמספרי הגרסאות לא יהיו זהים לגרסת המוצר הראשית:

תיקוני באגים ושיפורים:

• ‫142677575 – בוצע עדכון בתכונה כך שהתאמת התבניות של נתיבי משאבים שמשמשים במוצרי API ל-Edge Microgateway תהיה עכשיו זהה להתאמת התבניות של נתיבי משאבים שמשמשים ב-Apigee Edge, כפי שמתואר במאמר הגדרת ההתנהגות של נתיב משאב מסוג '/',‏ '/*‎' ו-'/**‎'.

  הערה: אם משתמשים בתבנית משאב מורכבת כמו /*/2/**, צריך לוודא שפרוקסי edgemicro_auth נוסף למוצר API עצמאי. לאחר מכן, צריך לכלול את המוצר הזה באפליקציית המפתח של ה-proxy, כמו שמוצג בצילום המסך הבא:

  

  הערה: מאפיין ההגדרה features.isSingleForwardSlashBlockingEnabled, כפי שמתואר במאמר הגדרת ההתנהגות של נתיב משאב מסוג '/',‏ '/*‎' ו-'/**‎', לא נתמך ב-Edge Microgateway.

• ‫143740696 – מבנה ההגדרות של quotas השתנה (ראו גם את הערות הגרסה לגרסה 3.0.9). המאפיין quotas משמש להגדרת פלאגין המכסה. השינוי במבנה בוצע כדי לשפר את הבהירות של רכיבי ההגדרה. כדי להגדיר את פלאגין המכסה, משתמשים בהגדרת ה-YAML הבאה. שימו לב שמאפיין ההגדרה נקרא quotas. פרטים על מאפייני ההגדרה של quotas זמינים במאמר אפשרויות הגדרה של מכסת נפח.

  edgemicro:
    home: ../gateway
    port: 8000
    max_connections: -1
    max_connections_hard: -1
    logging:
      level: info
      dir: /var/tmp
      stats_log_interval: 60
    plugins:
      dir: ../plugins
      sequence:
        - oauth
        - quota
  quotas:
    bufferSize:
      hour: 20000
      minute: 500
      default: 10000
    useDebugMpId: true
    failOpen: true
  ...

• ‫141750056 – נוספה תכונה חדשה שמאפשרת להשתמש ב-Redis כמאגר הנתונים של המכסות. אם useRedis הוא true, נעשה שימוש במודול volos-quota-redis. אם הערך הוא true, המכסה מוגבלת רק למופעים של Edge Microgateway שמתחברים ל-Redis. אם הערך הוא false, נעשה שימוש במודול volos-quota-apigee בתור מאגר הנתונים הבסיסי, והמונה של המכסה הוא גלובלי. פרטים נוספים מופיעים במאמר בנושא אפשרויות הגדרה למכסת נפח האחסון. לדוגמה:

  edgemicro:
  ...
  quotas:
    useRedis: true
    redisHost: localhost
    redisPort: 6379
    redisDb: 1

• ‫140574210 – זמן התפוגה שמוגדר כברירת מחדל לאסימונים שנוצרים על ידי שרת ה-proxy של edgemicro-auth השתנה מ-108,000 אלפיות השנייה (1.8 דקות) ל-1,800 שניות (30 דקות).
• ‫143551282 – כדי לתמוך בארגונים שמופעל בהם SAML, הפקודה edgemicro genkeys עודכנה כך שתכלול את הפרמטר ‑‑token. הפרמטר הזה מאפשר להשתמש בטוקן OAuth לאימות במקום בשם משתמש ובסיסמה. פרטים נוספים זמינים במאמר בנושא יצירת מפתחות.

3.0.9

ביום שישי, 11 באוקטובר, השקנו את התיקונים והשיפורים הבאים ב-Edge Microgateway.

גרסאות הרכיבים:

בטבלה הבאה מפורטים מספרי הגרסאות של פרויקטי הרכיבים השונים שמשויכים ל-Edge Microgateway 3.0.9. חשוב לזכור שכל רכיב הוא פרויקט נפרד, ולכן יכול להיות שמספרי הגרסאות לא יהיו זהים לגרסת המוצר הראשית:

תיקוני באגים ושיפורים:

• ‫141989374 – נוספה תכונה חדשה של 'כשל בפתיחה' לפלאגין של המכסה. כשהתכונה הזו מופעלת, אם מתרחשת שגיאה בעיבוד המכסה או אם הבקשה 'החלת מכסה' אל Edge לא מצליחה לעדכן את מוני המכסה המרוחקים, המכסה תעובד על סמך ספירות מקומיות בלבד עד לסנכרון הבא של המכסה המרוחקת. בשני המקרים האלה, הדגל quota-failed-open מוגדר באובייקט הבקשה.

  כדי להפעיל את התכונה 'מכסה', מגדירים את ההגדרה הבאה:

  quotas :
   failOpen : true

  הערה: בנוסף, השם של האובייקט של בקשת fail-open בפלאגין OAuth השתנה ל-oauth-failed-open.

• ‫142093764 – בוצע שינוי בהגדרות של שרת ה-edgemicro-auth proxy כדי למנוע חריגה מהמכסה. השינוי הוא הגדרת סוג המכסה ליומן. כדי להשתמש בשיפור הזה, צריך לעדכן את edgemicro-auth לגרסה 3.0.7 ואילך.
• ‫142520568 – נוספה תכונה חדשה שמאפשרת רישום ביומן של מזהה MP (מעבד הודעות) בתגובות למכסת השימוש. כדי להשתמש בתכונה הזו, צריך לעדכן את ה-proxy של edgemicro-auth לגרסה 3.0.7 ואילך ולהגדיר את ההגדרה הבאה:

  quotas:
    useDebugMpId: true

  כשהערך של useDebugMpId מוגדר, תגובות המכסה מ-Edge יכללו את מזהה ה-MP ויתועדו ביומן על ידי Edge Microgateway. לדוגמה:

  {
      "allowed": 20,
      "used": 3,
      "exceeded": 0,
      "available": 17,
      "expiryTime": 1570748640000,
      "timestamp": 1570748580323,
      "debugMpId": "6a12dd72-5c8a-4d39-b51d-2c64f953de6a"
  }

3.0.8

ביום חמישי, 26 בספטמבר, פרסמנו את התיקונים והשיפורים הבאים ב-Edge Microgateway.

גרסאות הרכיבים:

בטבלה הבאה מפורטים מספרי הגרסאות של פרויקטים של רכיבים נפרדים שמשויכים ל-Edge Microgateway 3.0.8. חשוב לזכור שכל רכיב הוא פרויקט נפרד, ולכן יכול להיות שמספרי הגרסאות לא יהיו זהים לגרסת המוצר הראשית:

תיקוני באגים ושיפורים:

• ‫140025210 – נוספה תכונה חדשה של 'פתיחה במקרה של כשל'. התכונה הזו מאפשרת להמשיך את העיבוד של ה-API אם אי אפשר לרענן טוקן JWT שפג תוקפו בגלל שגיאת חיבור שמונעת קריאה מוצלחת לאימות מפתח ה-API לשרת ה-proxy של edgemicro-auth.

  התכונה מאפשרת להגדיר תקופת חסד שבה הטוקן הישן נשאר במטמון ונעשה בו שימוש חוזר עד שתקופת החסד מסתיימת. התכונה מאפשרת ל-Edge Microgateway להמשיך לעבד בקשות במקרה של כשל זמני בחיבור. כשהקישוריות מתחדשת, ומתבצעת קריאה מוצלחת של Verify API Key, נשלף JWT חדש שמחליף את ה-JWT הישן במטמון.

  כדי להגדיר את התכונה החדשה 'פתיחה במקרה של כשל', מבצעים את הפעולות הבאות:

  1. מגדירים את המאפיינים הבאים בקטע oauth בקובץ ההגדרות של Edge Microgateway:

     oauth:
       failOpen: true
       failopenGraceInterval: time_in_seconds
       cacheKey: true
       ...

     לדוגמה:

     oauth:
       failOpen: true
       failopenGraceInterval: 5
       cacheKey: true
       ...

     בדוגמה הזו, הטוקן הישן ישמש למשך 5 שניות אם לא ניתן לרענן אותו בגלל בעיית קישוריות. אחרי 5 שניות, תוחזר שגיאת אימות.

• ‫141168968 – בוצע עדכון כדי לכלול את correlation_id בכל הפלט של יומן הפלאגין. בנוסף, רמות היומן של חלק מהיומנים שונו ל-error לפי הצורך.
• ‫140193349 – בוצע עדכון ב-edgemicro-auth proxy כדי לדרוש אימות של המפתח והסוד של Edge Microgateway בכל בקשה של Verify API Key. ‫Edge Microgateway עודכן כך שתמיד יישלחו המפתח והסוד בכל בקשה לאימות מפתח API. השינוי הזה מונע מלקוחות לקבל JWT עם מפתח API בלבד.
• ‫140090250 – בוצע עדכון כדי להוסיף רישום אבחונים ביומן לעיבוד מכסות. בעקבות השינוי הזה, עכשיו אפשר לבצע קורלציה בין הפלט של יומן הרישום של המכסה לבין שאר היומנים של Edge Microgateway.

3.0.7

ביום חמישי, 12 בספטמבר, השקנו את התיקונים והשיפורים הבאים ב-Edge Microgateway.

גרסאות הרכיבים:

בטבלה הבאה מפורטים מספרי הגרסאות של פרויקטים של רכיבים נפרדים שמשויכים ל-Edge Microgateway 3.0.7. חשוב לזכור שכל רכיב הוא פרויקט נפרד, ולכן יכול להיות שמספרי הגרסאות לא יהיו זהים לגרסת המוצר הראשית:

תיקוני באגים ושיפורים:

• ‫140075602 – בוצע עדכון בפלאגין OAuth כדי להחזיר קוד סטטוס 5xx במקרים המתאימים. בעבר, הפלאגין החזיר רק קודי סטטוס 4xx בכל המקרים שבהם קוד הסטטוס לא היה 200. מעכשיו, לכל תגובה להודעה שקוד הסטטוס שלה הוא לא 200, יוחזר קוד 4xx או 5xx מדויק, בהתאם לשגיאה.

  התכונה הזו מושבתת כברירת מחדל. כדי להפעיל את התכונה הזו, מוסיפים את המאפיין oauth.useUpstreamResponse: true להגדרות של Edge Microgateway. לדוגמה:

  oauth:
    allowNoAuthorization: false
    allowInvalidAuthorization: false
    gracePeriod: 10
    useUpstreamResponse: true

• ‫140090623 – בגרסה 3.0.6, נוסף מאפיין הגדרה חדש, quota.quotaUri. מגדירים את מאפיין ההגדרה הזה אם רוצים לנהל את המכסות באמצעות ה-proxy‏ edgemicro-auth שנפרס בארגון. אם לא מגדירים את המאפיין הזה, נקודת הקצה של המכסה מוגדרת כברירת מחדל כנקודת הקצה הפנימית של Edge Microgateway. לדוגמה:

  edge_config:
    quotaUri: https://%s-%s.apigee.net/edgemicro-auth

  בגרסה 3.0.7, בוצע עדכון ב-edgemicro-auth כדי לאפשר את ההגדרה החדשה הזו. כדי להשתמש בנכס quotaUri, צריך לשדרג לגרסת ה-proxy העדכנית של edgemicro-auth. פרטים נוספים זמינים במאמר בנושא שדרוג שרת ה-proxy edgemicro-auth.

• ‫140470888 – נוספה כותרת הרשאה לשיחות בנושא מכסות כדי לספק אימות. בנוסף, שונה ה-proxy של edgemicro-auth כדי להסיר את organization מהמזהה של המכסה. מכיוון שנקודת הקצה של המכסה נמצאת בארגון של הלקוח, אין יותר צורך במזהה המכסה.
• ‫140823165 – שם הנכס הבא:

  edgemicro:
      keepAliveTimeout

  תועד באופן שגוי בגרסה 3.0.6. שם הנכס הנכון הוא:

  edgemicro:
      keep_alive_timeout

• ‫139526406 - תוקן באג שגרם לספירת מכסת שימוש שגויה אם לאפליקציית מפתח היו מספר מוצרים. ההקצאה נאכפת עכשיו בצורה נכונה לכל מוצר באפליקציה שיש בה כמה מוצרים. השילוב של appName + productName משמש כמזהה המכסה.

3.0.6

ביום חמישי, 29 באוגוסט, פרסמנו את התיקונים והשיפורים הבאים ב-Edge Microgateway.

• ‫138633700 – נוסף מאפיין הגדרה חדש, keepAliveTimeout. המאפיין הזה מאפשר להגדיר את הזמן הקצוב לתפוגה של Edge Microgateway (באלפיות השנייה). (ברירת מחדל: 5,000 אלפיות השנייה)

  לדוגמה:

  edgemicro:
    keep_alive_timeout: 600

• ‫140090623 – נוסף מאפיין הגדרה חדש, quotaUri. מגדירים את מאפיין ההגדרה הזה אם רוצים לנהל את המכסות באמצעות ה-proxy‏ edgemicro-auth שנפרס בארגון. אם לא מגדירים את המאפיין הזה, נקודת הקצה של הקצאת נפח ברירת המחדל היא נקודת הקצה הפנימית של Edge Microgateway. לדוגמה:

  edge_config:
    quotaUri: https://your_org-your_env.apigee.net/edgemicro-auth
  

  כדי להשתמש בתכונה הזו, קודם צריך לפרוס את הגרסה העדכנית של edgemicro-auth ה-proxy בארגון. פרטים נוספים זמינים במאמר בנושא שדרוג שרת ה-proxy של edgemicro-auth.

• ‫138722809 – נוסף מאפיין הגדרה חדש, stack_trace. המאפיין הזה מאפשר לכם לקבוע אם עקבות מחסנית יופיעו בקובצי יומן. לדוגמה:

  stack_trace: false

  אם המדיניות stack_trace מוגדרת לערך true, פרטי ה-stack trace יודפסו ביומנים. אם המדיניות מוגדרת לערך false, פרטי ה-stack trace לא יודפסו ביומנים.

3.0.5

ביום חמישי, 15 באוגוסט, השקנו את התיקונים והשיפורים הבאים ב-Edge Microgateway.

• ‫139005279 – תוקנה בעיה שבה הפקודה edgemicro status לא החזירה את המספר הנכון של תהליכי עובד.
• ‫138437710 – תוקנה בעיה בכיתה ExitCounter שמנעה את כתיבת היומן המתאים.

• ‫139064652 – נוספה האפשרות להוסיף רמות רישום ביומן trace ו-debug ליומני אירועים ומערכת. בשלב הזה, הוספנו רק את האפשרות להוסיף את רמות היומן האלה. כרגע, רמות היומן הזמינות הן info,‏ warn ו-error.
• ‫139064616 – פלט היומן עבר סטנדרטיזציה לכל הצהרות היומן של המסוף. הצהרות הרישום ביומן של Console כוללות עכשיו את המאפיינים הבאים:
• חותמת זמן
• שם הרכיב
• מזהה תהליך
• הודעה ביומן המסוף

• ‫138413755 – שיפור הודעות היומן שקשורות למפתח ולסוד של JWT עבור פקודות ה-CLI הבאות: cert, verify, upgradekvm, token, genkeys, revokekeys, rotatekey ו-configure.

• ‫138413577 – הוספה ושיפור של טיפול בשגיאות בטיימאוט של שירותי קצה עורפי.
• ‫138413303 – הוספה ושיפור של טיפול בשגיאות עבור תפוגת זמן קצוב לתגובה ולשקע.
• ‫138414116 – הוספה ושיפור של טיפול בשגיאות מסוג 'החיבור נדחה'.

3.0.4

ביום חמישי, 1 באוגוסט, השקנו את התיקונים והשיפורים הבאים ב-Edge Microgateway.

• ‫134445926 – שיפורים באימות פנימי של Edge Microgateway.
• ‫137582169 – נפתרה בעיה שגרמה להפעלת תהליכים לא רצויים. התהליכים הנוספים גרמו לטעינה מחדש של תוספים ולשימוש מוגזם בזיכרון. מעכשיו, מספר התהליכים ב-Edge Microgateway נשאר בגבול הצפוי.
• ‫137768774 – שיפורים בהודעות ביומן:
  • ניקוי יומני טרנזקציות (בקשות).
  • הוספנו עוד הודעות ביומן במקומות שנדרש.
  • הודעות יומן של טרנזקציות (בקשות) הועברו מפלט הקונסולה לקובץ היומן הרלוונטי.
  • עדכנו את יומני המסוף כך שישתמשו בפונקציית רישום מרכזית ביומן.
• ‫138321133, 138320563 – שינוי פנימי בסיסי במאגר המכסות כדי לאפשר שיפורים עתידיים במכסות.

3.0.3

ביום שלישי, 23 ביולי, השקנו את התיקונים והשיפורים הבאים ב-Edge Microgateway.

• שיפורים ברישום ביומן: יומני זמן הריצה הקיימים משתמשים בפונקציה חדשה eventLog() שמתעדת נתוני זמן ריצה בפורמט עקבי. פרטי היומן כוללים:
  • חותמת זמן (ISO 8601: ‏YYYY-MM-DDTHH:mm:ss.sssZ).
  • רמת הרישום ביומן (error,‏ warn או info).
  • שם המארח – שם המארח ששלח את הבקשה מכותרת הבקשה.
  • מזהה תהליך – אם אתם מפעילים אשכול של תהליכי Node.js, זהו המזהה של התהליך שבו התבצע הרישום ביומן.
  • שם הארגון ב-Apigee.
  • שם הסביבה בארגון.
  • שם ה-proxy ל-API.
  • כתובת ה-IP של הלקוח.
  • ClientId.
  • מזהה ההתאמה (לא מוגדר כרגע).
  • שם הרכיב של Edge Microgateway.
  • הודעה בהתאמה אישית – יכול להיות שחלק מהאובייקטים ידפיסו מידע נוסף שמועבר למאפיין השגיאה הזה.
  • שיטת הבקשה (אם מדובר בבקשת HTTP).
  • קוד הסטטוס של התשובה (אם מדובר בבקשת HTTP).
  • הודעת שגיאה.
  • קוד שגיאה – אם אובייקט כולל קוד שגיאה, הוא מודפס במאפיין הזה.
  • משך הזמן.
  • מערכת הפעלה סמן לסוף השורה.

  ערכי מאפיינים מסוג Null מובילים לסוגריים ריקים, [].

  בדוגמה הבאה מוצג פורמט היומן:

  Timestamp [level][hostname][ProcessId][Org][Environment][APIProxy][ClientIp][ClientId][][component][customMessage][reqMethod][respStatusCode][errMessage][errCode][timeTaken]

  (137770055)

• ביצועים: מוצרי API לא סוננו לפי סביבה. הבעיה הזו נפתרה. (135038879)
• שילובים שונים של בדיקות פונקציונליות ושיפורים באיכות הקוד.

3.0.2

ביום רביעי, 3 ביולי 2019, פרסמנו את התיקונים והשיפורים הבאים ב-Edge Microgateway.

איכות הקוד – הקוד נבדק כדי לוודא שהוא עומד בסטנדרטים של האיכות שנדרשים על ידי המשתמשים, ובוצעו בו שינויים כדי לעמוד בסטנדרטים האלה. טיפלנו בשגיאות ובאזהרות שנוגעות לאיכות הקוד שמקורן ב-JSHint. כתוצאה מכך, זוהו ותוקנו כמה שגיאות קוד בפועל. כל המודולים של Apigee Edge Microgateway עברו את התהליך הזה. אפשר לעיין בשינויים שבוצעו ב-28 ביוני וב-2 ביולי ב-microgateway-config,‏ microgateway-core,‏ microgateway-plugins וב-microgateway. כל המודולים עם שינויים באיכות הקוד נבדקו באמצעות כלים פנימיים שמאמתים את ההפעלה של Edge Microgateway לתרחישי שימוש של לקוחות.

3.0.1

ביום שישי, 21 ביוני 2019, פרסמנו את התיקונים והשיפורים הבאים ב-Edge Microgateway.

• ‫134834551 – שינוי גרסאות Node.js הנתמכות ב-Edge Microgateway
  (גרסאות Node.js הנתמכות: 8 ו-12; גרסאות 7, 9 ו-11 הן ניסיוניות)
• ‫134751883 – קריסת Edge Microgateway בעת טעינה מחדש תחת עומס
• ‫134518428 – נקודת הקצה Products של Edge Microgateway מחזירה 5XX אם דפוס המסנן שגוי
• ‫135113408 – העובדים צריכים להפעיל מחדש אם הם מסיימים את הפעולה באופן לא צפוי
• ‫134945852 – לא נעשה שימוש ב-tokenCacheSize בפלאגין OAuth
• ‫134947757 – הגדרת cacheTTL בפלאגין OAuth
• ‫135445171 – החישוב של תקופת החסד ב-OAuth לא נכון
• שימוש במודול memored שסופק עם ההתקנה של Edge Microgateway
• ‫135367906 - ביקורת אבטחה

גרסה 2.5.x

תכונות חדשות ושיפורים בגרסה 2.5.x

(תוקן בגרסה 2.5.38, 06/07/2019)

אסימוני JWT בפורמט לא תקין עלולים לגרום לקריסת תהליכי worker כשמשתמשים במטמון אסימונים. תוקן במודול Edge microgateway-plugins. (b/134672029)

(נוסף בגרסה 2.5.37) נוספה אפשרות ה-CLI‏ edgemicro-cert -t.

באפשרות edgemicro cert -t אפשר לציין טוקן OAuth כדי לאמת ממשקי ניהול של API. אפשר לקרוא גם על ניהול אישורים.

(נוסף בגרסה 2.5.35) נוספה תמיכה בניפוי באגים ב-Edge Microgateway באמצעות edgemicroctl.

אפשר להשתמש בדגל mgdebug עם edgemicroctl. אפשר גם לעיין במשימות שקשורות לשילוב עם Kubernetes.

(נוסף בגרסה 2.5.35) הפעלת גרסת Windows ל-edgemicroctl.

(נוסף ב-2.5.31) API חדש של edgemicro-auth/token

נוסף API חדש של edgemicro-auth/token שמאפשר להעביר את הלקוח/הסוד ככותרת של הרשאת Base64 מקודדת בסיסית, ואת grant_type כפרמטר של טופס. איך מקבלים אסימוני Bearer ישירות

(תוקן בגרסה 2.5.31) הגדרה פרטית לא מכבדת את דגל הטוקן

תוקנה בעיה שבה הגדרה של Edge Microgateway לשימוש בטוקן גישה של OAuth2 ב-Edge for Private Cloud לא פעלה כמו שצריך (הטוקן לא כובד).

‫Docker: תמיכה בשימוש באישורים בחתימה עצמית

(נוסף בגרסה 2.5.29) אם אתם משתמשים ברשות אישורים (CA) שלא מהימנה כברירת מחדל על ידי Node.js, אתם יכולים להשתמש בפרמטר NODE_EXTRA_CA_CERTS כשאתם מפעילים קונטיינר Docker עם Edge Microgateway. מידע נוסף זמין במאמר שימוש ב-CA שלא מהימן על ידי Node.js.

‫Docker: תמיכה ב-TLS

(נוסף בגרסה 2.5.29) Edge Microgateway שפועל במאגר Docker תומך עכשיו ב-TLS לבקשות נכנסות לשרת Edge Microgateway (בקשות צפונה) ולבקשות יוצאות מ-Edge Microgateway לאפליקציית יעד (בקשות דרומה).

בדוגמאות הבאות מוסבר בפירוט איך להגדיר את תצורות ה-TLS האלה:

• דוגמה להגדרת TLS לתעבורה יוצאת
• דוגמה להגדרת TLS לתקשורת עם שרתים חיצוניים

בדוגמאות האלה אפשר לראות איך להשתמש בנקודת הטעינה של הקונטיינר /opt/apigee/.edgemicro כדי לטעון את האישורים, שאליהם מתייחסים אחר כך בקובץ ההגדרות של Edge Microgateway.

‫Docker: תמיכה בהעברת בקשות דרך שרת proxy

(נוסף בגרסה 2.5.27) אם מריצים את Edge Microgateway במאגר Docker, אפשר להשתמש באפשרויות האלה כדי לשלוט בהתנהגות של ה-proxy כאשר ה-microgateway פועל מאחורי חומת אש:

• HTTP_PROXY
• HTTPS_PROXY
• NO_PROXY

פרטים נוספים זמינים במאמר בנושא הפעלת Edge Micro כקונטיינר Docker.

Docker: הוראות מעודכנות לתוסף

(נוסף בגרסה 2.5.27) אם מריצים את Edge Microgateway במאגר Docker, יש עכשיו שתי אפשרויות לפריסת פלאגינים. אפשרות אחת, שכוללת שימוש בנקודת הרכבה של Docker, היא חדשה. האפשרות השנייה הייתה קיימת קודם, והיא לא השתנתה באופן מהותי, אבל קובץ ה-Dockerfile עודכן. פרטים נוספים זמינים בקישורים הבאים:

• אפשרות א': העלאת ספריית הפלאגינים לנפח אחסון (חדש)
• אפשרות ב': בניית התוספים במאגר התגים (מעודכן)

תמיכה בטוקנים חדשים של OAuth לפקודת השדרוג של KVM

(נוסף בגרסה 2.5.27) אפשר להשתמש באסימון OAuth עם הפקודה upgradekvm. פרטים נוספים זמינים במאמר בנושא שדרוג KVM.

הפרדה בין ממשקי API ב-Edge Analytics

(נוסף בגרסה 2.5.26) דגלים חדשים של תוסף ניתוח הנתונים מאפשרים להפריד נתיב API ספציפי כך שהוא יופיע כשרת proxy נפרד בלוחות הבקרה של Edge Analytics. לדוגמה, אפשר להפריד בין ממשקי API של בדיקות תקינות כדי למנוע בלבול בינם לבין קריאות API בפועל. מידע נוסף מופיע במאמר בנושא החרגת נתיבים מניתוח.

הגדרת שרת proxy מקומי

(נוסף ב-2.5.25) באמצעות פרוקסי מקומי, אין צורך ליצור באופן ידני פרוקסי עם מודעות למיקרו-שער ב-Apigee Edge. במקום זאת, שער המיקרו ישתמש בנתיב הבסיס של ה-proxy המקומי. מידע נוסף זמין במאמר בנושא שימוש במצב פרוקסי מקומי.

שימוש במצב עצמאי

(נוסף בגרסה 2.5.25) אפשר להריץ את Edge Microgateway בלי להיות מחוברים לאף תלות ב-Apigee Edge. במצב הזה, שנקרא מצב עצמאי, אפשר להריץ ולבדוק את Edge Microgateway בלי חיבור לאינטרנט. מידע נוסף זמין במאמר בנושא הפעלת Edge Microgateway במצב עצמאי.

ביטול מפתחות

(נוספה גרסה 2.5.19) נוספה פקודה חדשה ל-CLI שמבטלת את פרטי הכניסה של המפתח והסוד להגדרה של Edge Microgateway.

edgemicro revokekeys -o [organization] -e [environment] -u [username] -k [key] -s [secret]

תמיכה ב-Docker

(נוסף בגרסה 2.5.19) עכשיו אפשר להוריד את הגרסה האחרונה של Edge Microgateway כקובץ אימג' של Docker:

docker pull gcr.io/apigee-microgateway/edgemicro:latest

תמיכה ב-Kubernetes

(נוסף ב-2.5.19) אפשר לפרוס את Edge Microgateway כשירות או כשער צדדי לפני שירותים שנפרסו באשכול Kubernetes. מידע נוסף: סקירה כללית על שילוב של Edge Microgateway עם Kubernetes

תמיכה באפשרות TCP nodelay

(נוספה גרסה 2.5.16) הגדרת תצורה חדשה, nodelay, נוספה להגדרת Edge Micro.

כברירת מחדל, חיבורי TCP משתמשים באלגוריתם Nagle כדי לשמור נתונים במאגר זמני לפני שליחתם. הגדרת nodelay ל-true משביתה את ההתנהגות הזו (הנתונים יישלחו באופן מיידי בכל פעם שמתבצעת קריאה ל-socket.write()). מידע נוסף זמין גם במסמכי התיעוד של Node.js.

כדי להפעיל את nodelay, עורכים את קובץ התצורה של Edge Micro באופן הבא:

edgemicro:
  nodelay: true
  port: 8000
  max_connections: 1000
  config_change_poll_interval: 600
  logging:
    level: error
    dir: /var/tmp
    stats_log_interval: 60
    rotate_interval: 24

אפשרויות חדשות ב-CLI לניטור ללא הגבלת זמן

(נוספה גרסה 2.5.12) נוספו פרמטרים חדשים לפקודה edgemicro forever. הפרמטרים האלה מאפשרים לציין את המיקום של קובץ forever.json, ולהתחיל או להפסיק את תהליך הרקע של Forever. אפשר לקרוא גם על מעקב ללא הגבלת זמן

דוגמאות:

כדי להתחיל להשתמש ב-Forever:

edgemicro forever -f ~/mydir/forever.json -a start

כדי להפסיק את המינוי ל-Forever:

edgemicro forever -a stop

רוטציית מפתחות JWT

נוספה תכונה חדשה שמאפשרת לבצע רוטציה של זוגות המפתחות הציבוריים/הפרטיים שמשמשים ליצירת אסימוני JWT שמשמשים לאבטחת OAuth ב-Edge Microgateway. מידע נוסף זמין במאמר בנושא רוטציה של מפתחות JWT.

סינון של שרתי proxy ל-API שהורדו

כברירת מחדל, Edge Microgateway מוריד את כל ה-proxies בארגון Edge שמתחילים בקידומת השמות edgemicro_. אפשר לשנות את ברירת המחדל הזו כדי להוריד פרוקסי שהשמות שלהם תואמים לתבנית. סינון של שרתי proxy שהורדו

ציון מוצרים ללא שרתי proxy ל-API

ב-Apigee Edge, אפשר ליצור מוצר API שלא מכיל שרתי proxy ל-API. הגדרת המוצר הזו מאפשרת למפתח API שמשויך למוצר לפעול עם כל שרת proxy שנפרס בארגון שלכם. החל מגרסה 2.5.4, Edge Microgateway תומך בהגדרת המוצר הזו.

תמיכה במעקב ללא הגבלת זמן

ל-Edge Microgateway יש קובץ forever.json שאפשר להגדיר אותו כדי לשלוט כמה פעמים ובאילו מרווחי זמן Edge Microgateway צריך להפעיל מחדש. הקובץ הזה מגדיר שירות בשם forever-monitor, שמנהל את Forever באופן פרוגרמטי.

ניהול מרכזי של קובץ ההגדרות של Edge Micro

אם מפעילים כמה מופעים של Edge Microgateway, כדאי לנהל את ההגדרות שלהם ממקום אחד. כדי לעשות את זה, צריך לציין נקודת קצה (endpoint) של HTTP שבה Edge Micro יכול להוריד את קובץ התצורה שלו.

תמיכה באפשרות forever CLI

(נוסף בגרסה 2.5.8) משתמשים בפקודה edgemicro forever [package.json] כדי לציין את המיקום של הקובץ forever.json. לפני הוספת הפקודה הזו, קובץ ה-config היה צריך להיות בספריית הבסיס של Edge Microgateway.

לדוגמה:

edgemicro forever ~/mydir/forever.json

הוספה של האפשרות configUrl לפקודה reload

(נוסף בגרסה 2.5.8) עכשיו אפשר להשתמש באפשרות --configUrl או -u עם הפקודה edgemicro reload.

תקופת חסד לגבי אי-התאמות בזמן של JWT

(נוסף בגרסה 2.5.7) מאפיין gracePeriod בהגדרת OAuth עוזר למנוע שגיאות שנגרמות בגלל הבדלים קלים בין השעה במערכת לבין השעות Not Before ‏ (nbf) או Issued At ‏(iat) שצוינו באסימון ההרשאה של JWT. מגדירים את המאפיין הזה למספר השניות שבהן יכולים להיות הבדלים כאלה. מאפייני OAuth

(נוסף בגרסה 2.5.7) מאפיין gracePeriod בהגדרת OAuth עוזר למנוע שגיאות שנגרמות בגלל הבדלים קלים בין השעה במערכת לבין השעות Not Before ‏ (nbf) או Issued At ‏(iat) שצוינו באסימון ההרשאה של JWT. מגדירים את המאפיין הזה למספר השניות שבהן יכולים להיות הבדלים כאלה. מאפייני OAuth

באגים שתוקנו בגרסה 2.5.x

• (בעיה מספר 236) תיקון שגיאת הקלדה בניקוי המטמון.
• (בעיה מספר 234) טעינה מחדש גורמת לקריסה של Edge Microgateway 2.5.35.
• (בעיה מספר 135) שגיאה של הפניה לא חוקית למארח וירטואלי 'secure' כשמשתמשים באפשרות ‎-v. התיקון הזה משנה את שרת ה-proxy edgemicro-auth לפני הפריסה כדי לוודא שהמארחים הווירטואליים תואמים בדיוק למה שמצוין בדגל ‎-v. בנוסף, אפשר לציין כל מספר של מארחים וירטואליים וכל שם בשבילם (ההגבלה על ברירת מחדל ומאובטח כבר לא חלה).
• (בעיה מספר 141) הפקודה edgemicro reload לא תומכת באפשרות של קובץ ההגדרות -c. כבר פתרנו את הבעיה הזו.
• (בעיה מספר 142) Edge Microgateway מתלונן על קריפטו שיצא משימוש בזמן ההתקנה. כבר פתרנו את הבעיה הזו.
• (בעיה מספר 145) מכסת השימוש לא פועלת עם Edge Microgateway. כבר פתרנו את הבעיה הזו.
• (בעיה בקהילת Apigee: https://community.apigee.com/questions/33149/emg-jwt-token-validated-against-both-api-proxies-a.html#answer-33336) אסימון JWT מאומת מול שני שרתי proxy של API ומול URI של משאב ב-OAuth. הבעיה הזו נפתרה.
• (בעיה בקהילת Apigee: https://community.apigee.com/questions/47846/microgateway-not-working-with-oauth.html) Microgateway לא פועל עם OAuth. כבר פתרנו את הבעיה הזו.
• תיקון של pidPath ב-Windows.
• (בעיה מספר 157) תוקנה בעיה שגרמה להודעת השגיאה הבאה: ReferenceError: deployProxyWithPassword לא מוגדר.
• (בעיה מספר 169) עדכון של יחסי תלות ב-Node.js (npm audit)
• ה-proxy של edgemicro-auth משתמש עכשיו במדיניות JWT של Edge. ה-proxy כבר לא מסתמך על Node.js כדי לספק תמיכה ב-JWT.

גרסה 2.4.x

תכונות חדשות ושיפורים בגרסה 2.4.x

1. הגדרת כינוי מותאם אישית לשרת ה-proxy של edgemicro-auth (PR 116)

אפשר לשנות את נתיב הבסיס שמוגדר כברירת מחדל לשרת ה-proxy edgemicro-auth. כברירת מחדל, נתיב הבסיס הוא /edgemicro-auth. כדי לשנות את הערך, משתמשים בדגל ‎-x בפקודה edgemicro configure.

דוגמה:

edgemicro configure -x /mypath …

2. תמיכה בתווים כלליים לחיפוש בנתיבים בסיסיים (PR 77)

אפשר להשתמש בתו כללי לחיפוש * אחד או יותר בנתיב הבסיס של שרת proxy מסוג edgemicro_*. לדוגמה, נתיב בסיס של /team/*/members מאפשר ללקוחות להתקשר אל https://[host]/team/blue/members וגם אל https://[host]/team/green/members בלי שתצטרכו ליצור שרתי proxy חדשים של API כדי לתמוך בצוותים חדשים. שימו לב: אין תמיכה ב-/**/.

3. נוספה ל-CLI נתיב הגדרה מותאם אישית להגדרת Private Cloud (בקשת משיכה מס' 99)

כברירת מחדל, קובץ ההגדרות של המיקרו-שער נמצא בנתיב ./config/config.yaml. בפקודות init,‏ configure ו-start, אפשר עכשיו לציין נתיב הגדרה מותאם אישית בשורת הפקודה באמצעות הדגלים -c או ‎--configDir. תוקנה בעיה שבה לא זוהה ספריית הגדרות מותאמת אישית להתקנות של ענן פרטי.

דוגמה:

edgemicro start -o docs -e test -k abc123 -s xyz456 -c /home/microgateway/config

4. התייחסות למשתני ‎ *_PROXY (PR 61)

אם Edge Microgateway מותקן מאחורי חומת אש ולא יכול לתקשר עם Apigee Edge בענן הציבורי, יש שתי אפשרויות:

אפשרות 1:

האפשרות הראשונה היא להגדיר את האפשרות edgemicro: proxy_tunnel כ-true בקובץ ההגדרות של המיקרו-שער:

edge_config:
   proxy: http://10.224.16.85:3128
   proxy_tunnel: true

כש-proxy_tunnel מוגדר כ-true, ‏ Edge Microgateway משתמש במתודה HTTP CONNECT כדי ליצור מנהור של בקשות HTTP דרך חיבור TCP יחיד. (הכלל הזה נכון גם אם משתני הסביבה להגדרת ה-Proxy מופעלים ב-TLS).

אפשרות 2:

האפשרות השנייה היא לציין שרת proxy ולהגדיר את proxy_tunnel לערך false בקובץ ההגדרות של המיקרו-שער. לדוגמה:

edge_config:
   proxy: http://10.224.16.85:3128
   proxy_tunnel: false

במקרה כזה, אפשר להגדיר את המשתנים הבאים כדי לשלוט במארחים של כל שרת proxy מסוג HTTP שרוצים להשתמש בו, או במארחים שלא אמורים לטפל בשרתי proxy של Edge Microgateway:‏ HTTP_PROXY,‏ HTTPS_PROXY ו-NO_PROXY. אפשר להגדיר את NO_PROXY כרשימה של דומיינים מופרדים בפסיקים ש-Edge Microgateway לא אמור להעביר אליהם פרוקסי. לדוגמה:

export HTTP_PROXY='http://localhost:3786'
export HTTPS_PROXY='https://localhost:3786'

למידע נוסף על המשתנים האלה, אפשר לעיין במאמרים הבאים:

https://www.npmjs.com/package/request#controlling-proxy-behaviour-using-environment-variables

5. הגדרת פסק זמן מותאם אישית לבקשות יעד (PR 57)

אפשר להגדיר פסק זמן מותאם אישית לבקשות ליעד באמצעות ההגדרה הבאה:

edgemicro:
    request_timeout: 10

הזמן הקצוב לתפוגה מוגדר בשניות. אם מתרחש פסק זמן, Edge Microgateway מגיב עם קוד סטטוס 504.

6. התייחסות להודעות סטטוס HTTP מותאמות אישית בתגובה של היעד (PR 53)

‫Edge Microgateway מכבד הודעות סטטוס HTTP מותאמות אישית שמוגדרות בתגובה של היעד. בגרסאות קודמות, הודעות סטטוס שנשלחו מהיעד הוחלפו בערכי ברירת מחדל של Node.js.

7. הכותרת X-Forwarded-For יכולה להגדיר את client_ip לניתוח נתונים

אם הכותרת X-Forwarded-For קיימת, היא תגדיר את המשתנה client_ip שמדווח ב-Edge Analytics. התכונה הזו מאפשרת לכם לדעת את כתובת ה-IP של הלקוח ששלח בקשה ל-Edge Microgateway.

8. שינויים בתוסף OAuth

התוסף OAuth תומך באימות של מפתח API ובאימות של אסימון גישה ל-OAuth. לפני השינוי הזה, התוסף קיבל כל אחת מהצורות של האבטחה. השינוי הזה מאפשר להשתמש רק באחד ממודלי האבטחה האלה (תוך שמירה על תאימות לאחור).

תוספי OAuth מוסיפים שני דגלים חדשים:

• ‫allowOAuthOnly – אם הערך מוגדר כ-true, כל API חייב לשאת כותרת Authorization עם אסימון גישה מסוג Bearer.

• ‫allowAPIKeyOnly – אם הערך מוגדר כ-true, כל API חייב לשאת כותרת x-api-key (או מיקום מותאם אישית) עם מפתח API.

מגדירים את הדגלים האלה בקובץ התצורה של Edge Microgateway באופן הבא:

oauth:
    allowNoAuthorization: false
    allowInvalidAuthorization: false
    keep-authorization-header: false
    allowOAuthOnly: false
    allowAPIKeyOnly: false

9. שיפור שרת ה-proxy של edgemicro-auth (PR 40)

בוצעו שיפורים ב-proxy‏ edgemicro-auth. לפני השינויים האלה, ה-proxy שמר את המפתחות ב-Edge Secure Store, כספת מוצפנת. עכשיו, ה-proxy מאחסן מפתחות במפתחות המוצפנים של Edge (KVM).

10. שינוי כתובת היעד שמוגדרת כברירת מחדל בתוסף (PR 74)

אפשר גם לשנות את יציאת נקודת הקצה של היעד ולבחור בין HTTP ל-HTTPS. משנים את המשתנים האלה בקוד של הפלאגין: req.targetPort ו-req.targetSecure. כדי לבחור HTTPS, מגדירים את req.targetSecure לערך true. כדי לבחור HTTP, מגדירים אותו לערך false. אם הגדרתם את req.targetSecure כ-true, תוכלו לקרוא מידע נוסף בשרשור הדיון הזה.

11. תמיכה ראשונית באימות טוקן OAuth (PR 125)

אפשר להגדיר את Edge Microgateway כך שישתמש באסימון OAuth לאימות במקום בשם משתמש ובסיסמה. כדי להשתמש באסימון OAuth, משתמשים בפרמטר הבא בפקודה edgemicro configure:

-t, --token <token>

לדוגמה:

edgemicro configure -o docs -e test -t <your token>

באגים שתוקנו בגרסה 2.4.3

• תוקנה בעיה שבה נדרש ארגון בתשלום כדי להפעיל כראוי את שרת ה-proxy של edgemicro-auth. מעכשיו אפשר להשתמש ב-Edge Microgateway גם בארגונים עם תקופת ניסיון. (PR 5)
• תוקנה בעיה שבה עיבוד הנתונים בזרם לא הסתיים, אבל בכל זאת בוצעו פעולות לטיפול בסיום. כתוצאה מכך, נשלחה תשובה חלקית. (PR 71)
• תוקנה בעיה שבה לא זוהה ספריית הגדרות מותאמת אישית להתקנות של Private Cloud. (PR 110)
• תוקנה בעיה ב-SSL דו-כיווני בין הלקוח לבין Edge Microgateway. (PR 70)
• תוקנה הבעיה שבה נדרש קו נטוי בסוף נתיב הבסיס של ה-proxy כדי שאימות מפתח ה-API יפעל בצורה תקינה. עכשיו, אין צורך בלוכסן בסוף נתיב הבסיס. (PR 48)

גרסה 2.3.5

תכונות חדשות ושיפורים בגרסה 2.3.5

סינון של שרת proxy

אתם יכולים לסנן אילו פרוקסי עם מודעות ל-Microgateway יעובדו על ידי מופע Edge Microgateway. כש-Edge Microgateway מופעל, הוא מוריד את כל ה-proxies שמותאמים ל-microgateway בארגון שאליו הוא משויך. כדי להגביל את הפרוקסי שמיקרו-שער יעבד, משתמשים בהגדרה הבאה. לדוגמה, ההגדרה הזו מגבילה את מספר שרתי ה-proxy ששער המיקרו יעבד לשלושה: edgemicro_proxy-1, edgemicro_proxy-2 ו-edgemicro_proxy-3:

proxies:
  - edgemicro_proxy-1
  - edgemicro_proxy-2
  - edgemicro_proxy-3

מיסוך נתונים ב-Analytics

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

analytics:
  mask_request_uri: 'string_to_mask'
  mask_request_path: 'string_to_mask'

גרסה 2.3.3

תכונות חדשות ושיפורים בגרסה 2.3.3

בהמשך מפורטים התכונות והשיפורים החדשים בגרסה הזו.

השבתה של בדיקת שינויים אוטומטית

כדי להשבית את הבדיקה האוטומטית של שינויים, צריך להגדיר את המאפיין הזה בקובץ ההגדרות של המיקרו-שער:

disabled_config_poll_interval: true

כברירת מחדל, סקר תקופתי מזהה שינויים שבוצעו ב-Edge (שינויים במוצרים, בשרתי proxy עם מודעות למיקרו-שערים וכו') וגם שינויים שבוצעו בקובץ ההגדרות המקומי. ברירת המחדל למרווח הזמן בין בדיקות היא 600 שניות (חמש דקות).

כתיבה מחדש של כתובות URL ליעד בתוספים

אפשר לשנות את כתובת היעד שמוגדרת כברירת מחדל באופן דינמי בתוסף, על ידי שינוי המשתנים האלה בקוד התוסף: req.targetHostname ו-req.targetPath.

חתימת פונקציה חדשה של פלאגין

נוספה חתימה חדשה של פונקציית פלאגין שמספקת את תגובת היעד כארגומנט. התוספת הזו מאפשרת לתוספים לגשת בקלות רבה יותר לתשובה הרלוונטית.

function(sourceRequest, sourceResponse, targetResponse, data, cb)

פלט רישום פשוט יותר שמוגדר כברירת מחדל

כברירת מחדל, שירות הרישום ביומן משמיט עכשיו את ה-JSON של פרוקסי, מוצרים ו-JWT שהורדו. כדי לשנות את ברירת המחדל כך שהאובייקטים האלה יוצגו, צריך להגדיר את DEBUG=* כשמפעילים את Edge Microgateway. לדוגמה:

DEBUG=* edgemicro start -o docs -e test -k abc123 -s xyz456

נתיב של הגדרה בהתאמה אישית נוסף ל-CLI

כברירת מחדל, קובץ התצורה של מיקרו-שער נמצא בנתיב ‎ ./config/config.yaml. בפקודות init, configure ו-start, אפשר עכשיו לציין נתיב הגדרה מותאם אישית בשורת הפקודה. לדוגמה:

edgemicro start -o docs -e test -k abc123 -s xyz456 -c /home/microgateway/config

באגים שתוקנו בגרסה 2.3.3

• תוקנה דליפת זיכרון שהתרחשה במהלך בקשות או תגובות גדולות.
• תוקן סדר ההפעלה של הפלאגין. היא פועלת עכשיו כמו שמוסבר במסמכי התיעוד.
• התוסף accumulate-request לא נתקע יותר בבקשות GET.
• תוקנה בעיה בפלאגין accumulate-response שבה היעדר גוף תגובה גרם לשגיאות.

גרסה 2.3.1

הערה לגבי ההתקנה

בגרסאות קודמות של Edge Microgateway אפשר להתקין את התוכנה על ידי הורדה של קובץ ZIP. כבר אין תמיכה בקובצי ה-ZIP האלה. כדי להתקין את Edge Microgateway, צריך להשתמש באחת מהאפשרויות הבאות:

npm install -g edgemicro

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

תכונות חדשות ושיפורים בגרסה 2.3.1

בהמשך מפורטים התכונות והשיפורים החדשים בגרסה הזו.

סינון שרתי proxy

הגדרה חדשה מאפשרת לכם לסנן אילו שרתי proxy ייטענו ב-Edge Microgateway בזמן ההפעלה. בעבר, המיקרו-שער טען את כל ה-proxies שמודעים למיקרו-שער (proxies שנקראים edgemicro_*) שנמשכו מהארגון או מהסביבה של Edge שציינתם בפקודה edgemicro configure. התכונה החדשה הזו מאפשרת לכם לסנן את רשימת השרתים האלה כדי ש-Edge Microgateway יטען רק את השרתים שציינתם. פשוט מוסיפים את רכיב ה-proxies לקובץ ההגדרות של microgateway כך:

edge micro:
proxies:
    - edgemicro_[name]
    - edgemicro_[name]
    ...

לדוגמה, נניח שיש לכם 50 שרתי proxy של edgemicro_* בארגון או בסביבה של Edge, כולל שרתי proxy בשמות edgemicro_foo ו-edgemicro_bar. אפשר להגדיר ל-microgateway להשתמש רק בשני ה-proxy האלה באופן הבא:

edge micro:
proxies:
    - edgemicro_foo
    - edgemicro_bar

עם ההפעלה, שער המיקרו יוכל לקרוא רק לשרתי ה-proxy שצוינו. כל ניסיון לקרוא לשרתי proxy אחרים שמודעים ל-microgateway שהורדו מהארגון או מהסביבה של Edge יגרום לשגיאה.

הגדרת כותרות של בקשות לטירגוט בפלאגינים

יש שני דפוסים בסיסיים שכדאי להכיר אם רוצים להוסיף או לשנות כותרות של בקשות ליעד: האחד שבו הבקשה הנכנסת מכילה נתונים (כמו בבקשת POST) והשני שבו היא לא מכילה נתונים (כמו בבקשת GET פשוטה).

נניח שהבקשה הנכנסת מכילה נתונים, ואתם רוצים להגדיר כותרות של בקשה בבקשת היעד. בגרסאות קודמות של Edge Microgateway, לא הייתה אפשרות להגדיר כותרות יעד באופן מהימן במקרה הזה.

העיקרון המרכזי בדפוס הזה הוא קודם לצבור את כל הנתונים הנכנסים מהלקוח. לאחר מכן, בפונקציה onend_request(), משתמשים בפונקציה החדשה request.setOverrideHeader(name, value) כדי להתאים אישית את הכותרות.

בהמשך מופיע קוד לדוגמה של תוסף שמראה איך עושים את זה. הכותרות שמוגדרות ב-onend_request נשלחות ליעד:

module.exports.init = function(config, logger, stats) {


  function accumulate(req, data) {
    if (!req._chunks) req._chunks = [];
    req._chunks.push(data);
  }

  return {

    ondata_request: function(req, res, data, next) {
      if (data && data.length > 0) accumulate(req, data);
      next(null, null);
    },

    onend_request: function(req, res, data, next) {
      if (data && data.length > 0) accumulate(req, data);
      var content = Buffer.concat(req._chunks);
      delete req._chunks;
      req.setOverrideHeader('foo', 'bar');
      req.setOverrideHeader('content-length', content.length);
      next(null, content);
    },


    onerror_request: function(req, res, data, next) {
      next(null, null);
    }

  };

}

אם הבקשה לא כוללת נתונים, אפשר להגדיר כותרות יעד ב-handler של onrequest(). הדפוס הזה לא חדש – הוא תועד בעבר והוא נמצא בשימוש בתוספים לדוגמה שמסופקים עם Edge Microgateway.

onrequest: function(req, res, next) {
      debug('plugin onrequest');
      req.headers['x-foo-request-id'] = "bar";
      req.headers['x-foo-request-start'] = Date.now();
      next();
    }

תכונת הטעינה מחדש ללא השבתה

אחרי שמבצעים שינוי בהגדרות של Edge Microgateway, אפשר לטעון את ההגדרות בלי לאבד הודעות. בעקבות השינוי הזה, Edge Microgateway תמיד מופעל במצב אשכול, והאפשרות --cluster הוסרה מהפקודה edgemicro start.

בנוסף, נוספו שלוש פקודות חדשות של CLI. צריך להריץ את הפקודות האלה מאותה ספרייה שבה בוצעה הפקודה edgemicro start:

• ‫edgemicro status – בדיקה אם Edge Microgateway פועל או לא.
• ‫edgemicro stop – מפסיק את אשכול Edge Microgateway.
• ‫edgemicro reload – טעינה מחדש של ההגדרות של Edge Microgateway ללא השבתה.

טעינה מחדש אוטומטית של ההגדרה ללא השבתה

‫Edge Microgateway טוען הגדרה חדשה מעת לעת ומבצע טעינה מחדש אם משהו השתנה. הסקר יזהה שינויים שבוצעו ב-Edge (שינויים במוצרים, בשרתי proxy עם מודעות ל-microgateway וכו') וגם שינויים שבוצעו בקובץ ההגדרות המקומי. מרווח ברירת המחדל בין בדיקות הוא 600 שניות (חמש דקות). אפשר לשנות את ברירת המחדל בקובץ ההגדרות של המיקרו-שער באופן הבא:

edgemicro:
    config_change_poll_interval: [seconds]

נוסף מידע על הגרסה ל-CLI

נוסף דגל --version ל-CLI. כדי לקבל את הגרסה הנוכחית של Edge Microgateway, משתמשים בפקודה:

edgemicro --version

אפשרויות חדשות של SSL בשרת Edge Microgateway

בנוסף לאפשרויות key ו-cert, Edge Microgateway תומך עכשיו באפשרויות הבאות של SSL בשרת:

שליחת קובצי יומן אל stdout

אפשר לשלוח נתוני יומן לפלט רגיל באמצעות הגדרת תצורה חדשה:

edgemicro:
  logging:
    to_console: true  

מידע נוסף זמין במאמר בנושא ניהול קובצי יומן.

גרסה 2.1.2

בהמשך מפורטים התכונות והשיפורים החדשים בגרסה הזו.

התרת נקודת קצה (endpoint) מותאמת אישית של API לצורך הגדרה

יש נקודות קצה חדשות שניתנות להגדרה עבור שרת ה-proxy של ההרשאות, שתומכות בשימוש בשירות אימות בהתאמה אישית. נקודות הקצה האלה הן:

• edgeconfig:verify_api_key_url
• edgeconfig:products

לפרטים, אפשר לעיין במאמר בנושא שימוש בשירות אימות בהתאמה אישית.

גרסה 2.1.1

בהמשך מפורטים התכונות והשיפורים החדשים בגרסה הזו.

פריסת שרת proxy לאימות שמתאים לפלטפורמות שונות

בוצע שיפור כך שהפקודה שמשמשת לפריסת שרת ה-proxy של Edge Microgateway authorization ב-Edge תהיה תואמת למערכות Windows.

גרסה 2.1.0

תכונות חדשות ושיפורים בגרסה 21.0

התכונות והשיפורים החדשים כוללים:

ציון אפשרויות של SSL/TLS ללקוח

אתם יכולים לציין אפשרויות לקוח לחיבורי SSL/TSL ליעדים באמצעות קבוצה חדשה של אפשרויות הגדרה. מידע נוסף על שימוש באפשרויות של SSL/TSL לקוח

גרסה 2.0.11

הערת התקנה גרסה 2.0.11

בגרסאות קודמות של Edge Microgateway אפשר להתקין את התוכנה על ידי הורדה של קובץ ZIP. כבר אין תמיכה בקובצי ה-ZIP האלה. כדי להתקין את Edge Microgateway, צריך להשתמש באחת מהאפשרויות הבאות:

npm install -g edgemicro

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

תכונות חדשות ושיפורים בגרסה 2.0.11

התכונות והשיפורים החדשים כוללים:

ציון יציאה בעת ההפעלה

פקודת ההתחלה מאפשרת לציין מספר יציאה כדי לבטל את היציאה שצוינה בקובץ התצורה. אפשר גם לציין מספר יציאה באמצעות משתנה הסביבה PORT. פרטים נוספים זמינים במאמר בנושא פקודת התחלה.

אפשרות לשמירת כותרות אימות

הגדרת תצורה חדשה, keepAuthHeader, מאפשרת לשמור את כותרת ההרשאה שנשלחת בבקשה. אם הערך הוא True, כותרת האימות מועברת ליעד. מאפייני OAuth

אפשרות להשתמש בשירות הרשאות בהתאמה אישית

אם אתם רוצים להשתמש בשירות מותאם אישית משלכם כדי לטפל באימות, אתם צריכים לשנות את הערך של authUri בקובץ ההגדרות של Edge Microgateway כך שיצביע לשירות שלכם. לפרטים, אפשר לעיין במאמר שימוש בשירות אימות בהתאמה אישית.

גרסה 2.0.4

גרסה 2.0.4 של Edge Microgateway הושקה ב-25 במאי 2016.

תכונות חדשות ושיפורים בגרסה 2.0.4

בהמשך מפורטים התכונות והשיפורים החדשים בגרסה הזו.

תמיכה בנתיבי משאבים במוצרים

‫Edge Microgateway תומך עכשיו בנתיבי משאבים במוצרים. נתיבי משאבים מאפשרים להגביל את הגישה לממשקי API על סמך הסיומת של נתיב ה-proxy. לפרטים על יצירת מוצרים והגדרת נתיבי משאבים, אפשר לעיין במאמר יצירת מוצרי API.

תמיכה בהתקנה גלובלית של npm

מעכשיו אפשר להתקין את Edge Microgateway באמצעות האפשרות npm -g (גלובלית). פרטים על האפשרות הזו מופיעים במסמכי ה-npm.

גרסה 2.0.0

גרסה 2.0.0 של Edge Microgateway הושקה ב-18 באפריל 2016.

תכונות חדשות ושיפורים בגרסה 2.0.0

בהמשך מפורטים התכונות והשיפורים החדשים בגרסה הזו.

שרת תהליכים יחיד

Edge Microgateway הוא עכשיו שרת עם תהליך יחיד. הוא כבר לא משתמש במודל של שני תהליכים שבו תהליך אחד (שנקרא בעבר 'הסוכן') מפעיל את Edge Microgateway, והתהליך השני הוא הארכיטקטורה החדשה מקלה על אוטומציה ועל שימוש במאגרי תגים.

קבצי הגדרה עם מרחב שמות

קבצי ההגדרות מופרדים עכשיו באמצעות מרחב שמות שכולל את הארגון והסביבה, כך שאפשר להריץ כמה מופעים של Microgateway באותו מארח. אחרי שמריצים את פקודת ההגדרה של Edge Microgateway, אפשר למצוא את קובצי ההגדרה ב-‎~/.edgemicro.

משתני סביבה חדשים

עכשיו יש 4 משתני סביבה: EDGEMICRO_ORG, ‏ EDGEMICRO_ENV, ‏ EDGEMICRO_KEY,‏ EDGEMICRO_SECRET. אם מגדירים את המשתנים האלה במערכת, לא צריך לציין את הערכים שלהם כשמשתמשים בממשק שורת הפקודה (CLI) כדי להגדיר ולהפעיל את Edge Microgateway.

הגדרה ששמורה במטמון

‫Edge Microgateway משתמש בקובץ תצורה שנשמר במטמון אם הוא מופעל מחדש ללא חיבור ל-Apigee Edge.

מצב אשכול

יש עכשיו אפשרויות להפעלת Edge Microgateway במצב אשכול. מצב אשכול מאפשר לכם לנצל את היתרונות של מערכות מרובות ליבות. המיקרו-שער משתמש במודול האשכול של Node.js כדי להפעיל את התכונה הזו. פרטים נוספים זמינים במסמכי התיעוד של Node.js.

באגים שתוקנו בגרסה 2.0.0

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

גרסה 1.1.2

גרסה 1.1.2 של Edge Microgateway הושקה ב-14 במרץ 2016.

תכונות חדשות ושיפורים בגרסה 1.1.2

בהמשך מפורטים התכונות והשיפורים החדשים בגרסה הזו.

שיפור הביצועים

‫Edge Microgateway משתמש עכשיו בסוכן HTTP של Node.js בצורה נכונה, כדי לשפר את איגום החיבורים. השיפור הזה משפר את הביצועים ואת היציבות הכוללת בעומס גבוה.

תמיכה בניפוי באגים מרחוק

אפשר להגדיר את Edge Microgateway כך שיפעל עם מאתר באגים מרחוק, כמו node-inspector.

מיקום חדש של קובץ התצורה

כשמגדירים את Edge Microgateway, הקובץ agent/config/default.yaml מועתק אל ~./edgemicro/config.yaml.

רוטציה של קובצי יומן

מאפיין הגדרה חדש מאפשר לציין מרווח זמן לרוטציה של יומני Edge Microgateway.

באגים שתוקנו גרסה 1.1.2

הבאגים הבאים תוקנו בגרסה 1.1.2.