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

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

ביום שלישי, 3 בדצמבר 2019, התחלנו לפרסם עדכון לגרסה זו של Apigee Edge עבור ענן ציבורי. (ההפצה המקורית בוצעה ביום חמישי, 18 באפריל 2019.)

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

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

מזהה הבעיה שם הרכיב תיאור
ב-1 באוקטובר 2019 התחלנו לפרסם את העדכונים הבאים ב-Apigee
110995050 זמן ריצה ל-API

איזון עומסים – יותר שליטה בהסרת שרתים שנכשלו

כשמגדירים את מאזן העומסים לשרת proxy ל-API, אפשר לקבוע כמה תגובות כשלים מתרחשים לפני הסרת שרת מהרוטציה של איזון העומסים. התשובה נכשלה המשמעות היא ש-Apigee לא מקבלת תגובה משרת יעד. במקרה כזה, כשל את המונה של מונה אחד. כש-Apigee מקבלת תגובה מיעד, גם אם היא שגיאת HTTP (למשל 500) שנספרת כתגובה משרת היעד. ומונה הכשלים יאופס. כדי להבטיח שתגובות HTTP לא תקינות (כמו 500) הגדלה של מונה הכשלים כדי להוציא שרת לא תקין מסבב איזון העומסים באופן הבא: בהקדם האפשרי, אפשר להוסיף רכיב <ServerUnhealthyResponse> חדש עם <ResponseCode> רכיבי צאצא להגדרות של מאזן העומסים. דפדפן Edge גם יספור תגובות עם הקודים האלה ככשלים.

<HTTPTargetConnection>
  <LoadBalancer>
    <Algorithm>RoundRobin</Algorithm>
    <Server name="target1" />
    <Server name="target2" />
    <ServerUnhealthyResponse>
        <ResponseCode>500</ResponseCode>
        <ResponseCode>502</ResponseCode>
        <ResponseCode>503</ResponseCode>
    </ServerUnhealthyResponse>
    <MaxFailures>5</MaxFailures>
  </LoadBalancer>
</HTTPTargetConnection>
  
  
130416715 אבטחה

שיפורים במדיניות בקרת הגישה

מדיניות AccessControl קובעת אילו כתובות IP יכולות לשלוח קריאות לשרת proxy ל-API. רכיב חדש במדיניות הזו נותן למפתחי API יותר שליטה בזיהוי כתובת ה-IP כתובות לבדיקה.

<IgnoreTrueClientIPHeader>: אופציונלי (ברירת המחדל היא False). כשהמדיניות מוגדרת כ-True, המדיניות מתעלמת מהכותרת True-Client-IP ו הערכה של כתובות IP בכותרת X-Forwarded-For, אחרי התנהגות ההערכה X-Forwarded-For שהגדרת.

<AccessControl async="false" continueOnError="false"
    enabled="true" name="Access-Control-1">
    <DisplayName>Access Control-1</DisplayName>
    <IgnoreTrueClientIPHeader>true</IgnoreTrueClientIPHeader>
    ...
</AccessControl>
העדכונים הבאים פורסמו ב-Apigee ב-18 באפריל 2019
117558815,
119856499,
110548137,
79526748,
72989449,
70712859,
69049041
זמן ריצה ל-API JWS ו-JWT
הוספנו כללי מדיניות חדשים לתמיכה ב-JWS ושיפרנו את כללי המדיניות הקיימים של JWT.

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

122610025 זמן ריצה ל-API מתן הרשאה ל-IncreaseFault להגדיר גם את סיבת השגיאה, ומשתנים שרירותיים כמו ב-AssignMessage

שני רכיבים חדשים זמינים במדיניות IncreaseFault ליצירת FaultRules נקייה ועוצמתית יותר.

  • ShortFaultReason הוא ערך בוליאני. אם המדיניות מוגדרת כ-True, שם המדיניות יתווסף למשתנה fault.reason.
  • הפונקציה AssignVariable, שזמינה ב-FultResponse, מאפשרת להקצות את תגובת השגיאה למשתנה שישמש בכללי מדיניות אחרים בתהליך ה-proxy ל-API.
121149811 יעדים מתארחים המגבלות שנאכפים לגבי יעדים מתארחים

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

117659213 זמן ריצה ל-API הגדרת פרמטרים של טווחי IP במדיניות AccessControl

עכשיו תוכלו להשתמש במשתנים של תבניות הודעות כדי להגדיר כתובות IP ומסכות CIDR מדיניות AccessControl. לדוגמה, אם רוצים לאחסן כתובת IP והתממה במפת ערכי מפתח (KVM), אפשר לאחזר את הערכים האלה ממשתנה שאתם מגדירים בתהליך ה-Proxy ל-API. כך ניתן לשנות ערכי IP בקלות רבה יותר בזמן ריצה ללא צורך לשנות את הגדרת המדיניות.

לדוגמה, במקום:

<MatchRule action="DENY">
    <SourceAddress mask="24">198.51.100.1</SourceAddress>
</MatchRule>
     

אפשר להגדיר את המדיניות באופן הבא, בהנחה שהערכים מאוחסנים ב-KVM, ומשתמשים במדיניות KeyValueMapOperations כדי לאחזר את הערכים ולהקצות אותם המשתנים שמוצגים כאן:

<MatchRule action="DENY">
    <SourceAddress mask="{kvm.mask.ref}">{kvm.ip.ref}</SourceAddress>
</MatchRule>
     
113599885 מעקב API תפקידים ב-API Monitoring

יש שני תפקידים ב-API Monitoring: אדמין Monitoring ו-API Monitoring, כפי שמתואר במאמר Access API Monitoring. הנושאים האלה זמינים בדצמבר 2018.

132256772 זמן ריצה ל-API כותרת X-Apigee.Message-Timeout נוספה לבקשה

Edge מוסיף עכשיו את הכותרת X-Apigee.Message-Timeout לכל בקשה. הכותרת הזו מיועד לשימוש פנימי על ידי Edge. לא להסתמך על הערכים בכותרות X-Apigee.* בשרתי ה-proxy ל-API כי הכותרות האלה לא מיועדות לשימוש לקוחות, ו-Apigee יכולה להסיר או לשנות אותן בכל שלב.

78575018 ענן פרטי / OPDK דילוג על שרת הניהול כדי לדלג על הרישום של מאגר הנתונים של השער כשיש כמה רצפי נתונים של השער

באגים תוקנו

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

מזהה הבעיה שם הרכיב תיאור
ב-3 בדצמבר 2019 התחלנו לפרסם ב-Apigee את התיקונים הבאים
תיקוני אבטחה.
ב-29 באוקטובר 2019 התחלנו לפרסם ב-Apigee את התיקונים הבאים
139381794 שרת ניהול

טיפול בשגיאות מחיקה של מאגר מפתחות כדי שהקריאה ל-API לא תיכשל

ב-1 באוקטובר 2019 התחלנו לפרסם ב-Apigee את התיקונים הבאים
140761319 זמן ריצה ל-API

x-apigee.edge.execution.sense.action תמיד מוגדר כ-null

139091614 זמן ריצה ל-API

במדיניות ResponseCache, NIOTheread מופעל ללא דחייה מ מאגר שרשורים

131331305 שירותי ליבה

מספר רב של יצואנים של יומנים בנתבים של Apigee גורמים לשימוש גבוה במעבדים (CPU)

136690640 זמן ריצה ל-API

שגיאות 404 לסירוגין בארגונים ספציפיים

140948100 זמן ריצה ל-API

תהליך עבודה משותף שנפרס לא פועל בחלק ממעבדי ההודעות

התיקונים הבאים פורסמו ב-Apigee ב-13 בספטמבר 2019
132654321 שרת ניהול יומני הביקורת לא מציגים נתונים
131246911 שרת ניהול כששולחים אימיילים למפתחים בפורטל, אפשר להפעיל תמיכה בדומיינים חדשים יותר כמו *.games, *.asia
התיקונים הבאים יושקו ב-Apigee ב-18 באפריל 2019
123844598 שרת ניהול אי אפשר לייבא שוב מפתחות אפליקציות שנמחקו אחרי יותר מ-24 שעות
123588156 זמן ריצה ל-API הסרת הכותרת Content-Length מהתגובה נכשלת עם שגיאת 304
122732400 זמן ריצה ל-API הגדרה של api.timeout override של io.timeout.millis
122545281 זמן ריצה ל-API מסכת הנתונים של DebugSession ל-JSON צריכה להביא בחשבון מקרה שבו jsonPayload הוא מערך
122355807 שרת ניהול התנהגות שגויה של משתמשים עם כמה תפקידים
121393556 זמן ריצה ל-API x_apigee_fault_code מוגדר כ-"org/codehaus/jackson/map/ObjectMapper"
120998548 ממשק המשתמש של Edge שגיאת הקלדה בהודעת שגיאה: האישור לא חוקי או שאי אפשר לסמוך עליו
120990929 זמן ריצה ל-API תגובת HTTP-413 מ-Nginx/Apigee-Router חושפת את סוג השרת
120799489 זמן ריצה ל-API כשמשתמשים ב-httpClient עם קריאה חוזרת (callback() ) אסינכרונית של JavaScript, פלט ניפוי הבאגים (trace) מושתק
120794339 זמן ריצה ל-API מצייני MP לארגון
120277011 שרת ניהול נדרש אימות קלט: לא ניתן לפרוס את שרת ה-proxy אם שם המארח של שרת היעד כולל **
119976417 מעקב API API Monitoring מראה זמן תגובה גבוה של שרת proxy, ואילו ניתוח הנתונים מציג זמן יעד גבוה לתגובה
119947481 זמן ריצה ל-API בתרחיש חריג, המטען הייעודי (payload) לצורך אנונימיזציה נרשם כטקסט פשוט
119877164 ענן פרטי / OPDK נתבים יוצרים שגיאות, מעבד ההודעות עובר למצב אופליין כש-TLS מופעל

התיקון הזה ייכלל בגרסה הבאה של Edge for Private Cloud.

119816218 זמן ריצה ל-API מטמון התשובה מתעלם מכותרת התוקף אם היא מוגדרת ל-0 או למספר שלילי
119770242 זמן ריצה ל-API תקשורת בין נתב ל-MP נכשלה וגרמה לזמן השבתה מלא: שגיאה ב-PostClientFlow גורמת ללולאה אינסופית
119443145 שרת ניהול שרת proxy ל-API מחזיר שגיאת 404 כשמשנים את השם של ProxyEndpoint ונפרסים מחדש
119260281 זמן ריצה ל-API \"לא ניתן לנתח כמחרוזת3000.0\" שגיאה ביומן
118743407 שרת ניהול משך הפריסה של שרת proxy ב-Apigee
118447966 זמן ריצה ל-API שגיאה ביתרונות המרכזיים של JavaScript בגרסה 180608_07 ל-MP
117549719 זמן ריצה ל-API חוסר התאמה בין ה-URI של הבקשה לנתיב הבסיס של שרת ה-proxy
117219520 זמן ריצה ל-API MessageLogging: יומן Syslog משתמש בפורמט תאריך שגוי כברירת מחדל, מציג אלפיות שנייה באופן שגוי
117116435 זמן ריצה ל-API שגיאות שמופיעות לסירוגין בקובץ JavaScript
117091520 זמן ריצה ל-API JavaCallouts נכשלים אחרי גרסה 18.06.08 של מעבד ההודעות
116165318 זמן ריצה ל-API פריסות בו-זמנית של אותה חבילה גורמות ל-Repository במסך
116055025 שירות Configstore למעבדי ההודעות חסרים אפליקציות ומארחים וירטואליים אחרי ההפעלה
115614498 זמן ריצה ל-API דרושה תמיכה ל-ILB ב-OPDK

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

113972537 זמן ריצה ל-API מספר P1 – NullPointerהחרגת הוגדל מקוד Node.js בשרתי proxy של Trireme – שגיאת שרת פנימית 500
113904969 תמיכה ב-Apigee בעיה במחיקת שרתי proxy ל-API בארגונים דמוגרפיים
113554802 זמן ריצה ל-API אימות טענת נכוֹנוּת (assertion) של SAML נכשלת עם NullPointer וכל החריגות
113315737 שרת ניהול פריסת שרת ה-proxy נכשלה כי חסרות רשומות פריסה ב-Zookeeper
112767195 זמן ריצה ל-API שגיאות DataStore שמופיעות לסירוגין במהלך גישה למדיניות KVM
112162179 זמן ריצה ל-API שמירה במטמון של אובייקט JavaScript בלי ליצור לו מחרוזת אחרת עלולה לגרום לנעילה
111860576 זמן ריצה ל-API חסרה שגיאה במדיניות בנושא מכסה
111671525 יעדים מתארחים קודי תגובה שלא עוברים בהצלחה מיעדים מתארחים גורמים לתקלה בשרת proxy
111523933 תוספים(מחברים) בעיה שקשורה לשמירה במטמון של מדיניות תוספי יתרונות מרכזיים
111420263 זמן ריצה ל-API חריגה בו-זמנית ב-MessageLogging
110843526 שרת ניהול ממשק API לניהול לצורך יצירה/עדכון של הוק (hook) תהליך צריך לאמת את התהליך המשותף
110805739 זמן ריצה ל-API TTL לא מוגדר כ- -1 בזרימת CPS כש-Reuserefreshtoken מוגדר כ-True והתוקף של אסימון הרענון לא מוגדר באופן מפורש
110429629 זמן ריצה ל-API מדיניות BasicAuthentication גורמת למשתנה request.headers.Authorization ל-DebugSession
110425503 זמן ריצה ל-API טעינה מחדש של Nginx גורמת לבעיות בזמינות של MP
110311540 זמן ריצה ל-API NPE בזמן השבתה של MP
110161455 זמן ריצה ל-API AccessEntity צריך להשתמש באחזור לפי שם האפליקציה במקום לאחזר את כל האפליקציות לארגוני CPS
90695522 זמן ריצה ל-API context.proxyRequest.asForm יוצר Java.lang.ArrayIndexOutOfBoundsלהת: 1
79734096 שרת ניהול כבר לא מתבצע סינון של יומני ביקורת לשרתי proxy
78105568 שרת ניהול פריסות של תהליכי עבודה משותפים לא מופיעות בקריאות ל-API של ניהול פריסות/ למשל /org/{org}/sharedflows/{sharedflow}/Deployments אחרי עדכון של תהליך משותף שנפרס
77528868 טריים רגרסיה של Trireme: הסקריפט server.js יצא עם קוד סטטוס 1-: נכס 0 לא נמצא
73766568 זמן ריצה ל-API השדרוג 170213_02 ל-171117_01 גרם לעלייה משמעותית בזמן האחזור של שרת ה-proxy עם יעד Trireme/Node
72710481 זמן ריצה ל-API CacheServiceImpl/CacheMemoryLimiter NullPointer וכל החריגים
68861063 זמן ריצה ל-API טיפול ב-NPE במהלך כיבוי נתבים
68833699 זמן ריצה ל-API מידע על שרת ה-proxy ל-API לפעמים לא מוסר מעץ סיווג API
67377575 יעדים מתארחים חוסר התאמה בין רשומת Analytics לבין מה שנשלח ללקוח בשרת proxy של Node.js
112481174 יעדים מתארחים השגיאה של שרת ה-proxy לא תיכשל בגלל שגיאת טורבו
117171470 יעדים מתארחים תיקון הודעת שגיאה לא תקינה מסוג app.yaml
67169139 זמן ריצה ל-API הפורמט של חותמת הזמן של Syslog במדיניות של MessageLogging שגוי
67165418 זמן ריצה ל-API שגיאת רישוי לגבי שימוש ביותר מעבדים של הודעות, גם כאשר משתמשים בפחות ממעבדי ההודעות ברישיון

התיקון הזה ייכלל בגרסה הבאה של Edge for Private Cloud.

67165195 זמן ריצה ל-API VerifySAMLAssertion לא מאמת את החתימה בהצהרה שמוטמעת בתגובה חתומה
66214414 זמן ריצה ל-API המשתנה currentstep.flowstate מחזיר תמיד \"SHARED_FLOW\" כאשר יש הפניה אליו מתהליך משותף
65731656 זמן ריצה ל-API ה-API להגנה מפני איומים נכשל לסירוגין באותה בקשה
133197060 זמן ריצה ל-API זמן קצוב לתפוגה של שער 57 מ-MP ליעד
110535186 זמן ריצה ל-API ServiceCallout ללא אלמנט תגובה ו-HTTPTargetConnection שמצביעים אל שרת proxy: SOMETIMES ללא שיחה
132443137 זמן ריצה ל-API לשנות את אופן הפעולה של מעבד ההודעות כך שיתעלם מכותרות שמתחילות ב- X-Apigee-*. לכן, צריך לשנות את הקוד של כל קוד שמשתמש X-Apigee-* כותרות ומחליפים את הכותרות האלה בכותרות נתמכות.
125709964 זמן ריצה ל-API ביטול המטמון עם purgeChildEntries לא פועלת כמצופה