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

אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X. מידע

גרסה 3.3.x

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

3.3.11

‫19 באוגוסט 2026 – עדכון של קובץ אימג' של קונטיינר Docker (תג: 3.3.11-sec.1)

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

עדכונים במאגר:

בעיות אבטחה שנפתרו בעדכון של קובץ Docker container

• GHSA-5p4m-2wfm-xmqj
• CVE-2026-13595
• CVE-2026-27456
• CVE-2026-12590
• CVE-2026-53614
• CVE-2026-53612
• CVE-2025-14104
• CVE-2026-53615
• CVE-2026-53613
• CVE-2026-34743

‫1 ביולי 2026 – הגרסה הראשונה

ב-1 ביולי 2026, Apigee פרסמה את התיקונים הבאים ל-Edge Microgateway 3.3.11.

גרסאות של רכיבים

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

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

• CVE-2026-7383
• CVE-2026-9076
• CVE-2026-34180
• CVE-2026-34181
• CVE-2026-34182
• CVE-2026-34183
• CVE-2026-42764
• CVE-2026-42766
• CVE-2026-42767
• CVE-2026-42769
• CVE-2026-45445
• CVE-2026-45446
• CVE-2026-45447
• CVE-2026-53550

3.3.10

ב-27 במאי 2026, Apigee פרסמה את התיקונים הבאים ל-Edge Microgateway.

גרסאות של רכיבים

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

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

• CVE-2026-41907
• CVE-2026-4800
• CVE-2026-2950
• CVE-2026-42338

3.3.9

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

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

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

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

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

• CVE-2025-13465
• CVE-2026-24842
• CVE-2026-26996
• CVE-2026-2391
• CVE-2026-27904
• CVE-2026-27601
• CVE-2026-27903
• CVE-2026-26960
• CVE-2024-22365
• CVE-2026-24001
• CVE-2025-15284
• CVE-2025-64756
• CVE-2026-31802
• CVE-2026-29786
• CVE-2026-25547

3.3.8

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

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

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

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

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

• CVE-2025-59343
• CVE-2025-64756

3.3.7

ב-17 ביולי 2025, Apigee פרסמה את התיקונים והשיפורים הבאים ל-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, Apigee פרסמה את התיקונים והשיפורים הבאים ל-Edge Microgateway.

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

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

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

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

3.3.5

ב-20 בדצמבר 2024, Apigee פרסמה את התיקונים והשיפורים הבאים ל-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,‏ Apigee פרסמה את התיקונים והשיפורים הבאים ב-Edge Microgateway.

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

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

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

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

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

3.3.3

ב-25 באפריל 2024, Apigee פרסמה את התיקונים והשיפורים הבאים ל-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, Apigee פרסמה את התיקונים והשיפורים הבאים ל-Edge Microgateway.

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

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

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

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

ללא.

3.3.1

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

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

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

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

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

3.3.0

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

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

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

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

npm install apigeetool@0.15.1

גרסה 3.2.x

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

3.2.3

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

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

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

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

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

3.2.2

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

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

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

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

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

3.2.1

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

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

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

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

edgemicro:
 enable_GET_req_body: true

3.2.0

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

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

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

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

גרסה 3.1.x

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

3.1.8

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

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

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

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

3.1.7

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

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

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

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

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

3.1.6

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

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

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

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

3.1.5

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

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

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

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

3.1.4

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

תיקון באג:

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

3.1.3

ב-15 באפריל 2020, Apigee פרסמה את התיקונים והשיפורים הבאים ב-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 APIs חדשים. ‫Edge Microgateway משתמש עכשיו בפקודות החדשות להוספה ולעדכון של ערכי KVM.
• ‫152822846 – במהדורות קודמות, Edge Microgateway עודכן כך שהעיבוד שלו של מיפוי נתיבי משאבים תואם לזה של Apigee Edge. בגרסה הזו תוקנה בעיה שבה לא הייתה התייחסות נכונה לתבנית /literal_string/*. לדוגמה: /*/2/*. אפשר לעיין גם במאמר הגדרת ההתנהגות של נתיב משאב מסוג '/',‏ '/*‎' ו-'/**‎'.
• ‫152005003 – בוצעו שינויים כדי להפעיל מזהים בהיקף הארגון והסביבה למכסות.
• ‫152005003 – בוצעו שינויים כדי להפעיל מזהים בהיקף הארגון והסביבה למכסות. השילוב של org + env + appName + productName משמש כמזהה של הקצאת המכסה.

3.1.2

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

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

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

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

• ‫151285018 – בוצע שיפור בתכונה כדי להוסיף תמיכה בשרת proxy של HTTP לתנועה בין 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, כי Node.js v8 הוצא משימוש.
• ‫151306049 – בוצע עדכון במסמכי התיעוד כדי לפרט את ממשקי ה-API לניהול של Apigee Edge שמשמשים את הפקודות של Edge Microgateway CLI. מידע נוסף זמין במאמר What management APIs does Edge Microgateway use?.

3.1.1

ב-20 בפברואר 2020, Apigee פרסמה את התיקונים והשיפורים הבאים ב-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 בינואר 2020, Apigee פרסמה את התיקונים והשיפורים הבאים ב-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 זיהה שינוי ב-proxy ל-API. עכשיו, כשמבצעים שינוי בשרת proxy, Edge Microgateway מרענן את המטמון והצמתים של העובדים מופעלים מחדש. השינוי הזה לא ישפיע על טרנזקציות פעילות ועל קריאות חדשות ל-API שנשלחות למיקרו-שער.
• ‫146378327 – רמת היומן של sourceRequest,‏ targetRequest ו-targetResponse שונתה לרמת INFO.
• ‫146019878 – תוקן חוסר התאמה בין זמן האחזור שחושב עבור 'ביצועים של שרת proxy של API' ב-Edge analytics לבין אירועי יומן של 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. אחר כך אפשר להגדיר מופעים אחרים של microgateway כך שיקראו את נתוני ההגדרה שלהם ממסד הנתונים. התכונה הזו מוסיפה רמת עמידות ל-Edge Microgateway. הוא מאפשר להפעיל מופעים של מיקרו-שער ולגרום להם לפעול בלי שהם צריכים לתקשר עם Apigee Edge. פרטים נוספים זמינים במאמר בנושא שימוש בכלי הסנכרון.

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

גרסה 3.0.x

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

3.0.10

ב-8 בנובמבר 2019, Apigee פרסמה את התיקונים והשיפורים הבאים ב-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 באוקטובר 2019, Apigee פרסמה את התיקונים והשיפורים הבאים ב-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 בספטמבר 2019, Apigee פרסמה את התיקונים והשיפורים הבאים ב-Edge Microgateway.

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

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

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

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

  התכונה מאפשרת להגדיר תקופת חסד שבה הטוקן הישן נשאר במטמון ונעשה בו שימוש חוזר עד שתקופת החסד מסתיימת. התכונה מאפשרת ל-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 – בוצע עדכון ב-proxy של edgemicro-auth כדי לדרוש אימות של המפתח והסוד של Edge Microgateway בכל בקשה של Verify API Key. ‫Edge Microgateway עודכן כך שתמיד יישלחו המפתח והסוד בכל בקשה לאימות מפתח API. השינוי הזה מונע מלקוחות לקבל JWT רק עם מפתח API.
• ‫140090250 – בוצע עדכון כדי להוסיף רישום אבחוני של עיבוד מכסות. בעקבות השינוי הזה, עכשיו אפשר לבצע קורלציה בין פלט יומן המכסות לבין שאר היומנים של Edge Microgateway.

3.0.7

ב-12 בספטמבר 2019, Apigee פרסמה את התיקונים והשיפורים הבאים ב-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, צריך לשדרג לגרסה העדכנית של פרוקסי 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 באוגוסט 2019, Apigee פרסמה את התיקונים והשיפורים הבאים ב-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, דוח הקריסות יודפס ביומנים. אם המדיניות מוגדרת לערך false, פרטי ה-stack trace לא יודפסו ביומנים.

3.0.5

ב-15 באוגוסט 2019, Apigee פרסמה את התיקונים והשיפורים הבאים ל-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 באוגוסט 2019, Apigee פרסמה את התיקונים והשיפורים הבאים ל-Edge Microgateway.

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

3.0.3

ב-23 ביולי 2019, Apigee פרסמה את התיקונים והשיפורים הבאים ב-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, Apigee פרסמה את התיקונים והשיפורים הבאים ב-Edge Microgateway.

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

3.0.1

ב-21 ביוני 2019, Apigee פרסמה את התיקונים והשיפורים הבאים ב-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 כשמשתמשים במטמון אסימונים. הבעיה תוקנה במודול microgateway-plugins של Edge. (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 כפרמטר של טופס. איך מקבלים אסימוני גישה ישירות

‫(תוקן בגרסה 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

(נוסף בתאריך 26.5.2024) פלאגין חדש לניתוח נתונים מאפשר להפריד נתיב API ספציפי כך שהוא יופיע כפרוקסי נפרד בלוחות הבקרה של 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 שהורדו

הגדרת מוצרים ללא שרתי 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, כדאי לנהל את ההגדרות שלהם ממקום אחד. כדי לעשות את זה, צריך לציין נקודת קצה של 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) שגיאה של הפניה לא תקינה למארח וירטואלי 'מאובטח' כשמשתמשים באפשרות ‎-v. התיקון הזה משנה את ה-proxy של edgemicro-auth לפני הפריסה כדי לוודא שהמארחים הווירטואליים תואמים בדיוק למה שמצוין בדגל ‎-v. בנוסף, אפשר לציין כל מספר של מארחים וירטואליים וכל שם בשבילם (ההגבלה על ברירת מחדל ומאובטח כבר לא חלה).
• (בעיה מספר 141) הפקודה edgemicro reload לא תומכת באפשרות של קובץ התצורה -c. כבר פתרנו את הבעיה הזו.
• (בעיה מספר 142) Edge Microgateway מתלונן על הצפנה שיצאה משימוש בזמן ההתקנה. כבר פתרנו את הבעיה הזו.
• (בעיה מספר 145) המכסה לא פועלת עם Edge Microgateway. כבר פתרנו את הבעיה הזו.
• (בעיה בקהילת Apigee: EMG - JWT token validated against both API Proxies and Resource URI in OAUTH) JWT token validated against both API Proxies and Resource URI in OAUTH. הבעיה נפתרה.
• (בעיה בקהילת Apigee: Microgateway פועל גם ללא טוקן OAuth בכותרת) 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 (בקשת משיכה [PR] מספר 99)

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

דוגמה:

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 לא אמור לשמש להם כשרת proxy. לדוגמה:

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)

בוצעו שיפורים בפרוקסי edgemicro-auth. לפני השינויים האלה, ה-proxy שמר את המפתחות במאגר המאובטח של Edge, שהוא כספת מוצפנת. עכשיו, ה-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. מוסיפים את הקוד הבא להגדרות של microgateway כדי להסתיר את ה-URI של הבקשה או את נתיב הבקשה. שימו לב שה-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 עם מודעות ל-microgateway וכו') וגם שינויים שבוצעו בקובץ ההגדרות המקומי. מרווח הזמן בין בדיקות שמוגדר כברירת מחדל הוא 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

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

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

לדוגמה, נניח שיש לכם 50 שרתי proxy של edgemicro_* בארגון או בסביבה של Edge, כולל שרתי proxy בשמות edgemicro_foo ו-edgemicro_bar. אפשר להגדיר את שרת ה-proxy של המיקרו-שער כך שישתמש רק בשני שרתי ה-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:

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

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

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

edgemicro:
    config_change_poll_interval: [seconds]

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

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

edgemicro --version

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

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

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

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

edgemicro:
  logging:
    to_console: true

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

גרסה 2.1.2

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

התרת נקודת קצה ל-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 על סמך הסיומת של נתיב כתובת ה-URL של ה-proxy. לפרטים על יצירת מוצרים והגדרת נתיבי משאבים, אפשר לעיין במאמר יצירת מוצרי API.

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

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

גרסה 2.0.0

‫Edge Microgateway v2.0.0 הושק ב-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 במצב אשכול. מצב Cluster מאפשר לכם לנצל את היתרונות של מערכות מרובות ליבות. המיקרו-שער משתמש במודול האשכול של Node.js כדי להפעיל את התכונה הזו. פרטים נוספים זמינים במסמכי התיעוד של Node.js.

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

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

גרסה 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.