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

מוצג המסמך של Apigee Edge.
עוברים אל מסמכי תיעוד של Apigee X. מידע

גרסה 3.3.x

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

3.3.3

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

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

בטבלה הבאה מפורטים מספרי הגרסאות של הפרויקטים הנפרדים של הרכיבים. שמשויכים לכל אחד עם 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 מיקרו-שער.

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

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

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

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

ללא.

3.3.1

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

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

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

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

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

3.3.0

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

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

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

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

npm install apigeetool@0.15.1

גרסה 3.2.x

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

3.2.3

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

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

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

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

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

3.2.2

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

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

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

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

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

3.2.1

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

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

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

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

edgemicro:
 enable_GET_req_body: true

3.2.0

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

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

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

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

גרסה 3.1.x

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

3.1.8

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

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

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

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

3.1.7

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

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

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

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

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

3.1.6

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

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

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

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

3.1.5

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

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

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

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

3.1.4

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

תיקון באגים:

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

3.1.3

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

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

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

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

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

3.1.2

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

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

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

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

• 151285018 – בוצע שיפור של תכונה כדי להוסיף תמיכה בשרת proxy ל-HTTP לתנועה בין יעדי Edge Microgateway ויעדי קצה עורפי. בנוסף, תוקנו הבעיות ב-HTTP הקיים תמיכה בשרת proxy בין Edge Microgateway ו-Apigee Edge. פרטים נוספים זמינים במאמרים:
  • שימוש בשרת proxy ל-HTTP לתקשורת עם Apigee Edge
  • שימוש בשרת proxy ל-HTTP לתקשורת יעד
• 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 – בוצע עדכון תיעוד כדי להציג את רשימת הניהול של Apigee Edge ממשקי API שמשמשים את פקודות Edge Microgateway CLI. ראו באילו ממשקי API לניהול נעשה שימוש ב-Edge Microgateway?

3.1.1

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

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

בטבלה הבאה מפורטים מספרי הגרסאות של הפרויקטים הנפרדים של הרכיבים. שמשויכים לכל אחד עם 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

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

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

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

3.1.0

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

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

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

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

• 144187500 - אירוע חדש ברמת WARN יירשם ביומן כאשר הדגל quotas.failOpen מופעל. הסימון הזה מופעל אם מתרחשת שגיאה בעיבוד המכסה או אם המכסה חלה שליחת בקשה אל דפדפן 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 שנשלחות ל-microgateway לא יושפעו.
• 146378327 – רמת היומן של sourceRequest, targetRequest, ו-targetResponse השתנו לרמת INFO.
• 146019878 – אי-התאמה בין זמן האחזור שחושב עבור 'ביצועים של שרת proxy ל-API' ב-Edge analytics ו-Edge Microgateway sourceResponse/targetResponse תוקן. עכשיו זמן האחזור באירועים ביומן של Edge ו-Microgateway.
• שינויים שקשורים ללוגיקה של התאמת תבניות:
  • 147027862 – הפלאגין של oauth עודכן כדי לתמוך בנתיב המשאב הבא דפוסים תואמים כפי שמצוין במוצרי ה-API:
    • /{literal}**
    • /{literal}*
    • כל שילוב של מעל שני דפוסים

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

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

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

גרסה 3.0.x

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

3.0.10

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

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

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

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

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

  הערה: אם משתמשים בדפוס משאבים מורכב כמו /*/2/**, חייב לוודא שה-Proxy של 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 נכון, volos-quota-redis נמצא בשימוש. אם הערך הוא True, המכסה מוגבלת רק למכונות Edge Microgateway ש להתחבר ל-Redis. אם הערך הוא False, volos-quota-apigee המודול משמש כמאגר גיבוי, ומונה המכסות הוא גלובלי. פרטים נוספים זמינים במאמר אפשרויות הגדרה של מכסות. לדוגמה:

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

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

3.0.9

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

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

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

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

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

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

  quotas :
   failOpen : true

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

• 142093764 – בוצע שינוי הגדרה לשרת ה-proxy של edgemicro-auth כדי למנוע חריגה ממכסת האחסון. השינוי הוא להגדיר את סוג המכסה לערך יומן. כדי להשתמש בשיפור הזה, עליך לעדכן את 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 מיקרו-שער.

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

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

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

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

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

  כדי להגדיר את הפקודה החדשה 'fail open' בצעו את הפעולות הבאות:

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

3.0.7

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

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

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

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

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

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

  edgemicro:
      keepAliveTimeout

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

  edgemicro:
      keep_alive_timeout

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

3.0.6

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

• 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
  

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

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

  stack_trace: false

  אם המדיניות stack_trace מוגדרת לערך true, דוח הקריסות להיות מודפסות ביומנים. אם מוגדר הערך false, המקבץ נתוני המעקב לא יודפסו ביומנים.

3.0.5

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

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

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

• 138413755 – שיפור הודעות יומן הקשורות למפתחות JWT וסודות עבור CLI הזה פקודות: אישור, אימות, שדרוגkvm, אסימון, אסימון, מפתחות, מפתחות ביטול, רוטציית מפתח והגדרה.

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

3.0.4

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

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

3.0.3

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

• שיפורים ברישום ביומן: יומני זמן הריצה הקיימים משתמשים בגרסה חדשה פונקציית eventLog() שמתעדת ומתעדת את נתוני זמן הריצה באופן עקבי הפורמט. פרטי היומן כוללים:
  • חותמת זמן (ISO 8601: YYYY-MM-DDTHH:mm:ss.sssZ).
  • רמת היומן (שגיאה, אזהרה או מידע).
  • שם מארח – שם המארח ששולח בקשה מכותרת הבקשה.
  • מזהה תהליך – אם מריצים אשכול של תהליכי Node.js, זה המזהה של התהליך שבו התרחש הרישום ביומן.
  • שם הארגון ב-Apigee.
  • שם הסביבה בארגון.
  • שם ה-Proxy ל-API.
  • כתובת ה-IP של הלקוח.
  • מזהה לקוח.
  • מזהה הקורלציה (לא מוגדר כרגע).
  • שם הרכיב Microgateway של Edge.
  • הודעה מותאמת אישית – יכול להיות שחלק מהאובייקטים ידפיסו מידע נוסף שיועבר למאפיין השגיאה הזה.
  • שיטת הבקשה (אם בקשת 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 מיקרו-שער.

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

3.0.1

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

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

גרסה 2.5.x

תכונות ושיפורים חדשים v.2.5.x

(קבוע 2.5.38, 07/06/2019)

אסימוני JWT בפורמט שגוי עלולים לגרום לעובדים לקרוס כשהם משתמשים במטמון אסימונים. קבוע בקצה Microsoftgateway-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) הפעלת build של Windows עבור edgemicroctl.

(נוסף 2.5.31) ממשק API חדש של dgemicro-auth/אסימון

נוסף ממשק API חדש של endmicro-auth/token שמאפשר להעביר את הלקוח או את הסוד כמקודד Base64 בקידוד Base64 הכותרת 'הרשאה בסיסית' וה-Grant_type כפרמטר של הטופס. מידע נוסף זמין בקטע קבלת אסימונים למוכ"ז באופן ישיר.

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

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

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

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

Docker: תמיכה ב-TLS

(נוסף 2.5.29) Microgateway של Edge שפועל בקונטיינר של 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, היא חדשה. האפשרות השנייה הייתה קיימת קודם, בעצם לא משתנה, עם זאת, קובץ ה-Docker עודכן. לפרטים נוספים, אפשר לעיין בקישורים הבאים:

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

תמיכה באסימון OAuth חדש בפקודת שדרוג KVM

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

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

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

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

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

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

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

ביטול מפתחות

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

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

תמיכה ב-Docker

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

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

תמיכה ב-Kubernetes

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

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

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

דוגמאות:

כדי להתחיל לתמיד:

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

כדי להפסיק לתמיד:

edgemicro forever -a stop

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

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

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

כברירת מחדל, אפליקציית Edge Microgateway מורידה את כל שרתי ה-Proxy בארגון Edge שלך. שמתחיל בקידומת 'dgemicro_'. אפשר לשנות את ברירת המחדל כדי להוריד שרתי proxy שהשמות שלהם תואמים לדפוס. ראו סינון שרתי proxy שהורדו

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

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

תמיכה במעקב לנצח

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

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

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

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

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

לדוגמה:

edgemicro forever ~/mydir/forever.json

הוספת אפשרות של configUrl לטעינה מחדש של הפקודה

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

תקופת חסד לפערים במועדי JWT

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

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

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

• (בעיה מס' 236) תיקון שגיאת הקלדה בניקוי המטמון.
• (בעיה מס' 234) קריסות מחדש של Edge Microgateway 2.5.35.
• (בעיה מס' 135) הפניה לא חוקית למארח וירטואלי 'מאובטח' במהלך השימוש -v. התיקון הזה משנה את שרת ה-proxy ל-Endmicro-auth לפני הפריסה מוודאים שהמארחים הווירטואליים תואמים בדיוק למה שצוין בנתיב "v-" לסמן. In addition, ניתן לציין כל מספר של מארח וירטואלי וכל שם שהוא (כבר לא מוגבל ל- שמוגדרים כברירת מחדל ומאובטחים).
• (בעיה מס' 141) הפקודה edgemicro מחדש לא תומכת באפשרות של קובץ תצורה -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)
• שרת ה-proxy edgemicro-auth משתמש עכשיו במדיניות של Edge JWT. שרת ה-proxy לא תלוי יותר Node.js לספק תמיכה ב-JWT.

גרסה 2.4.x

תכונות ושיפורים חדשים v.2.4.x

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

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

דוגמה:

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 להגדרת ענן פרטי (PR 99)

כברירת מחדל, קובץ התצורה של microgateway נמצא ב-./config/config.yaml. בפקודות להתחלה, להגדרה ולהתחלה, אפשר עכשיו לציין נתיב config בהתאמה אישית בשורת הפקודה באמצעות הדגלים -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:

האפשרות הראשונה היא להגדיר את האפשרות dgemicro: proxy_tunnel כ-true ב-microgateway. קובץ תצורה:

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 בקובץ התצורה של microgateway. לדוגמה:

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

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

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

Microsoft 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 עם אסימון גישה למוכ"ז.

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

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

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

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

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

10. שכתוב של כתובת היעד המוגדרת כברירת מחדל בפלאגין (PR 74)

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

11. תמיכה ראשונית באימות של אסימוני OAuth (PR) 125)

אפשר להגדיר את Edge Microgateway להשתמש באסימון OAuth במקום ב שם משתמש/סיסמה. כדי להשתמש באסימון OAuth, צריך להשתמש בפרמטר הבא ב-dgemicro הגדרה באמצעות הפקודה:

-t, --token <token>

לדוגמה:

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

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

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

גרסה 2.3.5

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

סינון לפי שרת proxy

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

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

אנונימיזציה של נתונים ב-Analytics

הגדרה חדשה מאפשרת לך למנוע את הצגת הפרטים של נתיב הבקשה ב-Edge ב-Analytics. צריך להוסיף את הרכיבים הבאים לתצורת המיקרו-שער כדי לבצע אנונימיזציה של ה-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 שמותאמים למיקרו-שער וכו'), כמו גם שינויים שבוצעו בקובץ התצורה המקומי. ברירת המחדל מרווח הסקר הוא 600 שניות (חמש דקות).

שכתוב כתובות URL של יעד ביישומי פלאגין

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

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

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

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

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

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

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

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

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

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

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

• תוקנה דליפת זיכרון שאירעה במהלך בקשות/תגובות גדולות.
• סדר הביצוע של הפלאגין תוקן. עכשיו הוא מתנהג כמו שמוסבר התיעוד.
• הפלאגין מסוג 'בקשת צבירה' של הפלאגין כבר לא נתקע בבקשות GET.
• תוקנה בעיה בפלאגין 'צבירה-תגובה', שגרמה לחוסר תגובה בגוף שגיאות.

גרסה 2.3.1

הערה בנושא התקנה

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

npm install -g edgemicro

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

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

אלו התכונות והשיפורים החדשים בגרסה הזו.

סינון שרתי proxy

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

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

לדוגמה, נניח שיש לך 50 שרתי proxy של edgemicro_* ב-Edge org/env, כולל אלה בשם edgemicro_foo ו-edgemicro_bar. אפשר אומרים למיקרו-שער להשתמש רק בשני שרתי ה-proxy האלה כך:

edge micro:
proxies:
    - edgemicro_foo
    - edgemicro_bar

לאחר ההפעלה, ה-microgateway יוכל לקרוא רק לשרתי ה-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 חדשות. צריך להריץ את הפקודות האלה אותה ספרייה שבה בוצעה הפקודה 'endmicro start':

• edgemicro status – בודק אם ה-Ecrogateway של Edge פועלות או לא.
• edgemicro stop – הפסקת אשכול Microgateway של Edge.
• edgemicro reload – טעינה מחדש של Microsoft Edge Microgateway ללא זמן השבתה.

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

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

edgemicro:
    config_change_poll_interval: [seconds]

נוספו פרטי גרסה ל-CLI

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

edgemicro --version

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

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

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

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

edgemicro:
  logging:
    to_console: true  

ראו ניהול קובצי יומן.

גרסה 2.1.2

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

מתן הרשאה לנקודת קצה ל-API בהתאמה אישית לצורך הגדרה

יש נקודות קצה (endpoints) חדשות שניתן להגדיר לשרת ה-proxy הרשאות שתומכות בשימוש שירות אימות מותאם אישית. נקודות הקצה (endpoints) האלה:

• edgeconfig:verify_api_key_url
• edgeconfig:products

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

גרסה 2.1.1

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

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

בוצע שיפור בפקודה ששימשה לפריסת ההרשאה של Edge Microgateway שרת proxy ל-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. צפייה כדי לקבל פרטים נוספים, אפשר ללחוץ על הפקודה 'start'.

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

הגדרת תצורה חדשה, 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

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

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

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

שרת עיבוד יחיד

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

קובצי תצורה ממרחב שמות

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

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

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

הגדרות אישיות במטמון

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

מצב אשכול

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

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

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

גרסה 1.1.2

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

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

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

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

עכשיו 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.