4.15.04.00 – נתוני גרסה של Apigee Edge לענן פרטי

כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של Apigee X.
מידע

ביום שלישי, 19 במאי 2015, השקנו גרסה רבעונית של Apigee Edge לענן פרטי.

שם המוצר הקודם, 'Apigee Edge On-locals', או 'OPDK', הוא עכשיו 'Apigee Edge לענן פרטי'.

יש לך שאלות? אפשר להיעזר בתמיכת הלקוחות של Apigee.

בנתוני הגרסה של Apigee תוכלו למצוא רשימה של כל נתוני הגרסה של Apigee Edge.

תכונות חדשות ושיפורים

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

OpenLDAP - התקנה ושדרוג

OpenLDAP הוא עכשיו שרת ה-LDAP היחיד שנתמך על ידי Edge להתקנות חדשות ולשדרוגים.

שירותי API

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

WebSockets

כדי לאפשר תקשורת אינטרנט בזמן אמת בין לקוח אינטרנט לשרת, Edge תומך בפרוטוקול WebSocket. Edge יכול לשמש בתפקיד הלקוח או השרת בתקשורת WebSocket. למידע על הגדרה של WebSockets ושימוש בהן ב-Edge, אפשר לעיין במדריך בנושא Apigee Edge לענן פרטי באמצעות WebSockets.

תמיכה של ספק אימות חיצוני לניהול API

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

מיתוג משותף בממשק המשתמש לניהול

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

יומנים של Node.js במעקב

בעת ניפוי באגים בשרתי proxy של Node.js API, אפשר להפעיל את התכונה Node.js Log (יומן Node.js) בתצוגת Trace של עורך ה-API של שרת ה-API. כדי להפעיל את התכונה, צריך להגדיר את apigee.feature.disableNodeJSLogs="false" בקובץ apigee-base.conf או apigee-onplace.conf בהתקנה. למידע נוסף על יומן Node.js, קראו את המאמר ניפוי באגים ופתרון בעיות בשרתי proxy של Node.js.

תפוגת התוקף של הסיסמה

ב-Edge 4.15.01.x, תוקף הסיסמאות של Edge פג באופן אוטומטי אחרי 30 ימים. המשמעות היא שהמשתמש ננעל מחוץ לחשבון, אלא אם הוא שינה את הסיסמה לפני שפג תוקפה. אבל היא גרמה גם לתפוגה של הסיסמה של מנהל המערכת כך שהאדמין של sys ננעל מחוץ ל-Edge.

כשמשדרגים לגרסה 4.15.04.00, ברירת המחדל משתנה כך שהתוקף של הסיסמאות לא יפוג. במקרה הצורך, אפשר להגדיר שיפוג התוקף של סיסמאות ל-Edge באמצעות הסקריפט /opt/apigee4/bin/apigee-enable-pwlockout.sh. מידע נוסף זמין במאמר Apigee Edge למדריך פעולות בענן פרטי.

הגבלת הגישה ל-sysadmin לדומיינים ספציפיים של כתובות אימייל

אפשר להגביל את הגישה למשתמשים בדומיינים של אימייל ספציפיים עם הרשאות לקריאה בלבד ב-sysadmin או ב-sysadmin. כדי להפעיל את התכונה הזו, צריך להוסיף את הדומיינים המורשים לקובץ apigee4/conf/apigee/management-server/security.properties, כפי שמתואר במדריך הפעולות של Apigee Edge לענן פרטי.

הודעות שגיאה בממשק המשתמש לניהול

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

משתני טעות חדשים של OAuthV2

המשתנים החדשים האלה שקשורים לתקלות מוגדרים במדיניות OAuthV2:

  • oauthV2.<policy-name>.failed – הערך מוגדר כ-true אם המדיניות נכשלה.
  • oauthv2.<policy_name>.<fault_name> – שם התקלה. לדוגמה, invalid_request
  • oauthv2.<policy_name>.<fault_cause> – סיבת התקלה. לדוגמה: פג תוקף האסימון

מידע נוסף זמין בכתובת http://apigee.com/docs/api-services/content/oauthv2-policy.

יצירת מוצרים

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

מידע נוסף זמין בכתובת http://apigee.com/docs/developer-services/content/creating-api-products.

ממשק משתמש להסרת משתמשים מארגון

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

פרטים נוספים זמינים בכתובת http://apigee.com/docs/api-services/content/managing-organization-users.

אפשרויות סינון בממשק המשתמש לניהול

בדפים של ממשקי ה-API, המוצרים, המפתחים והאפליקציות בממשק המשתמש של הניהול, יש אפשרויות סינון חדשות לחיפוש.

כלי מעקב במצב אופליין

הכלי 'מעקב במצב אופליין' מאפשר לכם להציג ולנתח סשנים של מעקב שנשמרו בעבר. סשן מעקב שנשמר הוא למעשה "תיעוד" של סשן נתוני מעקב, והוא יכול להיות שימושי במקרים שבהם צריך לפתור בעיות ולבצע ניתוח נוסף. ממשק המשתמש של כלי המעקב אופליין דומה לכלי המעקב ה'פעיל'.

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

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

תפקידי המשתמש מוצגים עכשיו בדף הגדרות המשתמש בממשק המשתמש לניהול (שם משתמש > הגדרות משתמש).

שיפורים בממשק המשתמש של ניהול Edge

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

שירותי Analytics

בהמשך מוצגות תכונות ושיפורים חדשים בשירותי Edge Analytics.

הנתונים זמינים למשך שישה חודשים

כשיוצרים דוחות ניתוח נתונים באמצעות ממשק המשתמש או ה-API לניהול, לא ניתן לגשת לנתונים מלפני שישה חודשים מהתאריך הנוכחי כברירת מחדל. כדי לקבל גישה לנתונים מלפני יותר משישה חודשים, צריך לפנות לתמיכה של Apigee.

המשתנים נוספו לניתוח הנתונים

המשתנים החדשים הבאים מועברים אל Edge analytics, והם מופיעים בשלב AX בחלון המעקב אחר שרת ה-API של ה-API.

  • apigee.edge.execution.is_target_error – מאפשר לך לזהות אם שגיאות ה-API הן שגיאות בצד היעד (ערך "1") או שגיאות שאינן שגיאות יעד לתגובות HTTP שנכשלו (ערך "0"). הערך הוא null לתגובת HTTP מוצלחת.
  • apigee.edge.execution.is_policy_error – מאפשר לזהות אם מדיניות נכשלה (ערך "1") או אם מדיניות מסוימת נכשלה בתגובת HTTP לא מוצלחת (ערך "0"). הערך הוא null לתגובת HTTP מוצלחת.
    המשתנים הקשורים הבאים מספקים פרטים על המדיניות שהנכשלה קודם. אם לא הוגדרה מדיניות שנכשלה, הערכים הם null.
    • apigee.edge.execution.fault_policy_name – שם המדיניות שנכשלה.
    • apigee.edge.execution.fault_flow_name – שם התהליך במדיניות שנכשל (למשל PreFlow, PostFlow או זרימה בהגדרת המשתמש).
    • apigee.edge.execution.fault_flow_state – המיקום שבו המדיניות צורפה בתהליך העבודה. ערכים אפשריים: PROXY_REQ_FLOW, TARGET_REQ_FLOW, TARGET_RESP_FLOW, PROXY_RESP_FLOW.

מרכזי בקרה

  • העברנו את תרשימי הביצועים של ממשקי ה-API, המפתחים, המוצרים והאפליקציות למפתחים. בעבר הם הוצגו בחלק התחתון של הדפים הראשיים של הישויות האלה. כדי לגשת לתרשימים אפשר לבחור בכרטיסייה Analytics בחלק העליון של כל דף.
  • הגרסה הזו כוללת עבודה משמעותית על מרכזי הבקרה הקיימים או החדשים האלה:
    • Apigee Dashboard (מתוקן): כולל תרשימי מדדים: תנועה בשרת proxy, מעורבות מפתחים ואפליקציות למפתחים. בכל תרשים יש תצוגה 'פרטים נוספים' שבה אפשר להציג פירוט של כל מדד. מידע נוסף מופיע במרכז הבקרה של Apigee.
    • ביצועים של שרת proxy (חדש): הצגת דפוסי התנועה של שרת proxy של ה-API וזמני העיבוד. מחליף את מרכז הבקרה לביצועים של שרת ה-API של שרת ה-API. לפרטים, קראו את המאמר ביצועי API של שרת proxy ל-API.
    • מבנה התנועה (השתנה): העיצוב והתוכן של לוח הבקרה עודכנו לחלוטין. מדד את התרומה היחסית של ממשקי ה-API, האפליקציות, המפתחים והמוצרים המובילים שלך לתוכנית ה-API הכוללת. למידע נוסף, אפשר לעיין במאמר מבנה התנועה.
    • ניתוח שגיאות (עודכן): העיצוב והתוכן שונו לחלוטין. מציג שיעורי שגיאות לשרתי proxy וליעדים של API. לפרטים, ראו מרכז השליטה לניתוח קוד שגיאה.
  • שינינו את השמות של מרכזי הבקרה הקיימים האלה:
    • השם של Endpoint Performance שונה ל-Target Performance (ביצועים יעד): מציג דפוסי תנועה ומדדי ביצועים עבור יעדי הקצה העורפי של שרת proxy ל-API. מידע נוסף זמין בקטע Target performance (יעד הביצועים).
    • השם של התעניינות השותפים השתנה למעורבות עם המפתח: מראה אילו ממפתחי האפליקציות הרשומים מניבים את רוב תנועת ה-API. עבור כל אחד מהמפתחים שלך, אפשר לראות מי מייצר הכי הרבה את תנועת ה-API ומכין את מספר השגיאות הגדול ביותר. למידע נוסף, אפשר לעיין בקטע מעורבות המפתחים.

שירותים למפתחים

בהמשך מפורטות תכונות חדשות ושיפורים נוספים ב-Edge Developer Services.

תמיכת Swagger 2.0 ב-SmartDocs

SmartDocs תומך בייבוא של מסמכי מפרט Swagger 2.0 ושמירה על תאימות לאחור עם Swagger 1.2. בגרסה מאוחרת יותר תהיה תמיכה באובייקטים של סכמת אבטחה ובסכימות מרכזיות.

מונטיזציה

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

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

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

למידע נוסף, ראו ניהול חברות ומפתחים.

בדוחות המונטיזציה, חברות נשארות המסנן הראשי, אבל תווית הסינון השתנתה מ'מפתחים' ל'חברות'.

הבאגים תוקנו

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

מזהה הבעיה התיאור
OPDK-954 4.15.01 הסכימה של Cassandra לא משודרגת
MGMT-1986 שגיאה בממשק המשתמש במהלך הוספת המפתח
MGMT-1983 קבלת קוד הרשאה של OAuth 2.0 מחזירה סטטוס שגוי
MGMT-1962 שגיאה בהתחברות לממשק המשתמש לניהול עם סיסמה חזקה
ההתחברות לממשק המשתמש עם תווים מיוחדים מסוימים, כמו סימן האחוז, כבר לא נכשלת.
MGMT-1894 טעינת הדף 'אפליקציות למפתחים' לא מסתיימת אף פעם בעמודה למפתחים
MGMT-1872 לא מצליחים להוריד דוחות בהתאמה אישית
MGMT-1777 לא ניתן להוסיף משתמש עם כתובת אימייל עם דומיין ברמה העליונה של .acn
MGMT-1362 כתובת האימייל עם 'שכחתי את הסיסמה' לא עובדת אם כתובת האימייל מכילה '_'
תיקון הבעיה באיפוס הסיסמה בענן פרטי עם כתובות אימייל שמכילות קו תחתון.
CORERT-613 לחיצת יד של SSL נכשלה בגלל "unseller_name"
APIRT-1346 OAuth2.0 – הערך המגובב מוחזר בתגובה של אסימון הגישה כשהערך hash.oauth.tokens.enabled

הגרסה הזו כוללת גם תיקוני באגים מהגרסאות הבאות:

ענן Edge Edge לענן פרטי

בעיות ידועות

בגרסה הזו קיימות הבעיות המוכרות הבאות.

מזהה הבעיה התיאור
לא רלוונטי

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

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

  • apigee4/share/apache-cassandra/bin/cassandra-cli -h {host} -f apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/360-company-developers.txt
  • apigee4/share/apache-cassandra/bin/cassandra-cli -h {host} -f apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/320-update-notification-service_item.txt
CORERT-318 לפעמים קריאות ל-API עם מטענים ייעודיים (payload) גדולים (100KB) יכולות להיתקע. כדי לפתור את הבעיה הזו, צריך להגדיר את ערך המאפיין הבא בקובץ router.properties:
HTTPServer.streaming.buffer.limit=0 (הגדרת ברירת המחדל היא 10)