20.04.06 – נתוני הגרסה של Apigee Edge ל-Public Cloud

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

בתאריכים הבאים התחלנו להשיק עדכוני רכיבים ל-Apigee Edge for Public Cloud:

• מעבד ההודעות: יום שישי, 1 במאי 2020
• ‫API Management: יום שני, 20 באפריל 2020
• ניהול המונטיזציה: יום שני, 20 באפריל 2020
• תיקון ב-API Management: יום שני, 22 ביוני 2020
• תיקון לניהול מונטיזציה: יום שני, 6 ביולי 2020
• עדכון אבטחה של שרת הניהול: יום שני, 24 באוגוסט 2020
• הפצת תיקון (Patch) של מעבד ההודעות עם תיקוני באגים: יום חמישי, 24 בספטמבר 2020
• הפצת תיקון (Patch) של מעבד ההודעות עם תיקוני באגים: יום שני, 26 באוקטובר 2020
• הפצת תיקון (Patch) של מעבד בקשות עם תיקוני באגים: יום שני, 1 בפברואר 2021

עדכונים ותכונות חדשות

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

מדיניות JWT

• הצפנת JWT

  כללי המדיניות של JWT מאפשרים ליצור, לאמת ולפענח אסימונים מוצפנים. הוספנו לרכיבי המדיניות את הפרטים הבאים:

  • ‫<Type> – מאפשר להגדיר אם האסימונים חתומים או מוצפנים.
  • ‫<EncryptionAlgorithms> – מאפשר להגדיר אלגוריתמים להצפנה <Key> ו-<Content>.

  (67165581)

• תמיכה באלגוריתמים של PSS בטוקנים חתומים

  המדיניות ליצירה ולאימות של JWT ו-JWS תומכת עכשיו באלגוריתמים PS256,‏ PS384 ו-PS512, כמו שמתואר ב-IETF RFC 7518. (119856499)

• GenerateJWT relative start time for token

  כשיוצרים JWT באמצעות מדיניות GenerateJWT, אפשר לציין את הזמן היחסי בין מועד היצירה של הטוקן לבין המועד שבו הוא הופך לתקף באמצעות הרכיב <NotBefore>. לדוגמה, ערך <NotBefore> של 2h אומר שהטוקן לא תקף עד שעתיים אחרי שהוא נוצר. אפשר להגדיר את הזמן <NotBefore> באלפיות שנייה (ms), בשניות (s), בדקות (m), בשעות (h), בימים (d) או בשבועות (w). (126261970)

• הפניה אל PublicKey/Certificate ב-VerifyJWT

  במדיניות VerifyJWT, רכיב <PublicKey> / <Certificate> מאפשר להפנות אל האישור בפורמט PEM שבאמצעותו יאומתו חתימות JWT נכנסות. לדוגמה:

  <PublicKey>
    <Certificate ref='public.certificate_pem'/>
  </PublicKey>

  (132918033)

פונקציות של תבניות הודעות

בגרסה הזו הוספנו את הפונקציות החדשות הבאות של תבניות הודעות:

• ‫firstnonull – מחזירה את הערך של הארגומנט הראשון (הכי שמאלי) שאינו null. (139698514)
• ‫xpath – מאפשרת להחיל ביטוי של נתיב XML‏ (XPath) כדי לנתח משתני XML. (123246424)

מדיניות AssignMessage: AssignVariable מאפשרת להפנות לתבנית הודעה

במדיניות AssignMessage, הרכיב <AssignVariable> / <Template> מאפשר מאפיין ref, שמאפשר להוסיף תבנית מוגדרת מראש בזמן הריצה, שאפשר לשנות בלי לשנות את המדיניות. (118396082)

כינויים מרובים לאישור

כש מגדירים TLS ומשתמשים בכמה אישורים במאגר מפתחות, כל אחד עם כינוי שונה, Edge מאפשר לכם להפנות לכינויים ספציפיים של אישורים בהגדרת <SSLInfo><KeyAlias>. כדי להפעיל את ההתנהגות המעודכנת הזו, צריך להגדיר מאפיין חדש HTTPClient.choose.alias.by.keyalias לערך true בקובץ http.properties במעבדי ההודעות. משתמשי Edge for Public Cloud צריכים לפנות אל התמיכה כדי להוסיף את הנכס הזה. (142141620)

מדיניות JSONtoXML: ‏ השמטת הצהרת ה-XML, הזחת הפלט

שתי אפשרויות בוליאניות חדשות במדיניות JSONtoXML מאפשרות לכם לשלוט יותר בפלט ה-XML.

• ‫<Options> <OmitXmlDeclaration> – אם המדיניות מוגדרת כ-True (ברירת המחדל היא False), הרכיב <OmitXmlDeclaration> משמיט את הצהרת ה-XML <?xml version="1.0" encoding="UTF-8"?> שנוצרת על ידי המדיניות.

• ‫<Options> <Indent> – אם המדיניות מוגדרת כ-True (ברירת המחדל היא False), האלמנט <Indent> יוצר כניסה בפלט ה-XML. לדוגמה, במקום הפלט הזה:

  <Array><n>1</n><n>2</n><n>3</n></Array>

  הרכיב Indent יוצר את הפלט הבא:

  <Array>
   <n>1</n>
   <n>2</n>
   <n>3</n>
  </Array>

(65142394)

תשובות לסריקה של מארח וירטואלי

אם נשלחה בקשה לכתובת IP של נקודת קצה (endpoint) של Apigee (לא צוין מארח וירטואלי), Edge החזיר תגובת HTTP 200 ומסמך HTML ריק מהמארח הווירטואלי שמוגדר כברירת מחדל ב-Apigee ומשויך לכתובת ה-IP הזו. כדי להימנע מהרושם השגוי שתשובה כזו עשויה לייצג פגיעות פוטנציאלית שאפשר לנצל, החיבור מנותק ולא מוחזרת תשובה. ‪(140005396)

מאפיינים של שרת היעד ב-Trace שיכולים לעזור בפתרון בעיות

מאפייני העקבות החדשים הבאים עוזרים לפתור בעיות בחיבור ליעד. הם מראים אם HTTPClient של שרת היעד נשמר במטמון: isHttpClientCached ו-isFromClientPool. (140574604)

המדיניות MessageLogging: הודעת Syslog

במדיניות MessageLogging, רכיב חדש של <Syslog> / <PayloadOnly> (boolean) מאפשר לקבוע אם משהו יתווסף אוטומטית ל-<Message> שהגדרתם. אם מגדירים את <PayloadOnly> כ-true, לא מתווסף שום דבר לפני הגדרת ההודעה (ללא קשר להגדרה של <FormatMessage> ). אם המדיניות מוגדרת כ-False (ברירת המחדל), ההגדרה <FormatMessage> קובעת מה יתווסף לפני הודעת היומן. (68722102)

תפוגת התוקף של מדיניות המטמון

רכיב חדש של תפוגה, <TimeoutInSeconds>, במדיניות ResponseCache ובמדיניות PopulateCache, מתנהג כמו רכיב <TimeoutInSecs> הקיים, כפי שהוא נועד לפעול במקור. צריך להשתמש ברכיב החדש. האלמנט <TimeoutInSecs> שלא בשימוש עדיין קיים לצורך תאימות לדורות קודמים. אם מוגדרים גם הרכיב <TimeoutInSecs> וגם הרכיב <TimeoutInSeconds>, ‏ Edge משתמש ב-<TimeoutInSeconds>. (119172893)

משתנה הזרימה virtualhost.aliases.values

משתנה חדש של זרימת הודעות לקריאה בלבד, virtualhost.aliases.values, מחזיר מערך בפורמט JSON של כל הכינויים שהוקצו למארח הווירטואלי שהופעל בבקשה הנכנסת. (128453178)

פרמטר חדש למחיקת גרסת proxy

נוסף פרמטר שאילתה חדש, force, אל delete proxy ל-API גרסה. במקרים שבהם הגרסה מופיעה ב-List API Proxies API אבל אי אפשר לבצע עליה שאילתה, הפרמטר הזה מבטיח שהגרסה של ה-proxy ל-API תימחק. (111691721)

לדוגמה:

DELETE /v1/organizations/myorg/apis/myproxy/revisions/2?force=true

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

משתנה חדש של זרימת הודעות לקריאה בלבד, virtualhost.aliases.values, מחזיר מערך בפורמט JSON של כל הכינויים שהוקצו למארח הווירטואלי שהופעל בבקשה הנכנסת. (128453178)

באגים שתוקנו

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