אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X. מידע
ביום שלישי, 19 במאי 2015, השקנו גרסה רבעונית של Apigee Edge for Private Cloud.
שם המוצר הקודם 'Apigee Edge On-premises' או 'OPDK' הוא עכשיו 'Apigee Edge for Private Cloud'.
אם יש לכם שאלות, אתם יכולים לפנות לתמיכה של Apigee Edge.
רשימה של כל נתוני הגרסה של Apigee Edge מופיעה במאמר נתוני הגרסה של Apigee.
תכונות חדשות ושיפורים
בהמשך מפורטים התכונות והשיפורים החדשים בגרסה הזו.
OpenLDAP – התקנה ושדרוג
OpenLDAP הוא עכשיו שרת ה-LDAP היחיד שנתמך על ידי Edge בהתקנות חדשות ובשדרוגים.
שירותי API
בהמשך מפורטים תכונות חדשות ושיפורים בשירותי Edge API.
WebSockets
כדי לאפשר תקשורת בזמן אמת באינטרנט בין לקוח אינטרנט לבין שרת, דפדפן Edge תומך בפרוטוקול WebSocket. דפדפן Edge יכול לשמש כלקוח או כשרת בתקשורת WebSocket. למידע על הגדרה ושימוש ב-WebSockets ב-Edge, אפשר לעיין במדריך Apigee Edge for Private Cloud Using WebSockets.
תמיכה בספק אימות חיצוני לניהול API
Edge משתלב עם Active Directory ועם ספקי אימות חיצוניים אחרים או מערכות LDAP שמכילות משתמשים אדמיניסטרטיביים של ה-API. מידע נוסף זמין במדריך הגדרת אימות חיצוני ב-Edge for Private Cloud.
מיתוג משותף בממשק הניהול
אתם יכולים להוסיף לוגו מותאם אישית לממשק המשתמש של Edge לניהול, והוא יופיע לצד הלוגו של Apigee. מידע נוסף זמין במאמר בנושא 'הוספת לוגו בהתאמה אישית לתפריט של ממשק המשתמש של Apigee' במדריך התפעול של Apigee Edge לענן פרטי.
יומנים של Node.js ב-Trace
כשמבצעים ניפוי באגים ב-proxy ל-API של Node.js, אפשר להפעיל את התכונה Node.js Log בתצוגת המעקב של כלי העריכה של ה-proxy ל-API. כדי להפעיל את התכונה, מגדירים את apigee.feature.disableNodeJSLogs="false" בקובץ apigee-base.conf או בקובץ apigee-onpremise.conf בהתקנה. מידע נוסף על יומן Node.js זמין במאמר ניפוי באגים ופתרון בעיות בשרתי proxy של Node.js.
תפוגת התוקף של הסיסמה
ב-Edge 4.15.01.x, הסיסמאות של Edge פג תוקפן אוטומטית אחרי 30 יום. כלומר, משתמשים ננעלו מחוץ לחשבון אלא אם הם שינו את הסיסמה לפני שתוקף הסיסמה פג. עם זאת, היא גם גרמה לסיסמה של האדמין של המערכת לפוג, כך שהאדמין לא יכול היה להיכנס ל-Edge.
כשמשדרגים לגרסה 4.15.04.00, ברירת המחדל משתנה כך שתוקף הסיסמאות לא פג. אם צריך, אפשר להגדיר שסיסמאות ב-Edge יפוגו באמצעות הסקריפט /opt/apigee4/bin/apigee-enable-pwlockout.sh. מידע נוסף זמין במדריך התפעול של Apigee Edge for Private Cloud.
הגבלת הגישה של אדמינים למערכת לדומיינים ספציפיים של אימייל
אתם יכולים להגביל את החברות בתפקידים 'אדמין מערכת' או 'אדמין מערכת עם גישת קריאה בלבד' למשתמשים בדומיינים ספציפיים של כתובות אימייל. כדי להפעיל את התכונה הזו, צריך להוסיף את הדומיינים המותרים לקובץ apigee4/conf/apigee/management-server/security.properties, כמו שמתואר במדריך ההפעלה של Apigee Edge for Private Cloud.
הודעות שגיאה בממשק המשתמש לניהול
עיצבנו מחדש את הודעת השגיאה שמוצגת בממשק המשתמש לניהול, כדי להשתמש בשטח המסך בצורה יעילה יותר.
משתני שגיאה חדשים של OAuthV2
המשתנים החדשים שקשורים לשגיאות מוגדרים על ידי מדיניות OAuthV2:
- oauthV2.<policy-name>.failed – מוגדר כ-true אם המדיניות נכשלה.
- oauthv2.<policy_name>.<fault_name> – השם של התקלה. לדוגמה, invalid_request
- oauthv2.<policy_name>.<fault_cause> – סיבת השגיאה. לדוגמה: Token Expired
מידע נוסף זמין בכתובת 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 Proxies, Products, Developers ו-Apps בממשק הניהול, יש אפשרויות סינון חדשות לחיפוש.
הכלי Offline Trace
הכלי Offline Trace מאפשר לכם להציג ולנתח סשנים של מעקב שנשמרו בעבר. סשן מעקב שנשמר הוא בעצם 'הקלטה' של סשן מעקב, והוא יכול להיות שימושי במקרים שבהם נדרש פתרון בעיות וניתוח נוסף. ממשק המשתמש של הכלי Offline Trace דומה לזה של הכלי Trace 'בזמן אמת'.
מידע נוסף זמין במאמר בנושא שימוש בכלי Offline Trace.
תפקידי משתמש שמוצגים בהגדרות המשתמש
בדף הגדרות המשתמש בממשק הניהול (שם משתמש > הגדרות משתמש), מוצגים עכשיו התפקידים של המשתמש.
שיפורים בממשק המשתמש לניהול Edge
הגרסה הזו כוללת מספר שיפורים קטנים בנוחות השימוש ובעקביות בממשק הניהול של Edge.
שירותי Analytics
בהמשך מפורטים שיפורים ותכונות חדשות בשירותי Edge Analytics.
נתונים זמינים לשישה חודשים
כשיוצרים דוחות ניתוח באמצעות ממשק הניהול או ה-API, כברירת מחדל אי אפשר לגשת לנתונים שנאספו לפני יותר משישה חודשים מהתאריך הנוכחי. אם רוצים לגשת לנתונים מלפני יותר משישה חודשים, צריך לפנות לתמיכה של Apigee Edge.
משתנים שנוספו לניתוח
המשתנים החדשים הבאים מועברים לניתוח Edge, ומוצגים בשלב AX בחלון המעקב של שרת ה-proxy של ה-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 – השם של ה-Flow במדיניות שנכשלה (כמו PreFlow, PostFlow או Flow שהוגדר על ידי המשתמש).
- apigee.edge.execution.fault_flow_state – המיקום שבו המדיניות צורפה לתהליך. ערכים אפשריים: PROXY_REQ_FLOW, TARGET_REQ_FLOW, TARGET_RESP_FLOW, PROXY_RESP_FLOW.
מרכזי בקרה
- התרשימים של הביצועים של ממשקי API, מפתחים, מוצרים ואפליקציות למפתחים הועברו. בעבר, הם הוצגו בתחתית הדפים הראשיים של הישויות האלה. עכשיו אפשר לגשת לתרשימים על ידי בחירת הכרטיסייה Analytics בחלק העליון של כל דף.
- הגרסה הזו כוללת שיפורים משמעותיים בלוחות הבקרה הקיימים או החדשים הבאים:
- לוח הבקרה של Apigee (גרסה מעודכנת): כולל שלושה גרפים של מדדים: תנועת Proxy, מעורבות של מפתחים ואפליקציות של מפתחים. בכל תרשים יש תצוגה של 'פרטים נוספים' שמאפשרת לכם להתעמק בכל מדד. מידע נוסף על לוח הבקרה של Apigee
- ביצועי שרת ה-Proxy (חדש): מציג דפוסי תנועה של שרת proxy ל-API וזמני עיבוד. מחליף את לוח הבקרה של ביצועי ה-API Proxy. מידע נוסף זמין במאמר בנושא ביצועים של שרת proxy של API.
- הרכב התנועה (גרסה מתוקנת): שינוי מקיף במראה, בתחושה ובתכנים של לוח הבקרה. המדד הזה משקף את התרומה היחסית של ממשקי ה-API, האפליקציות, המפתחים והמוצרים המובילים שלכם לתוכנית ה-API הכוללת. ראו הרכב התנועה.
- ניתוח שגיאות (גרסה מתוקנת): שינוי מקיף במראה, בתחושה ובתוכן. הצגת שיעורי השגיאות של שרתי proxy ל-API ויעדים. ראו לוח הבקרה של ניתוח קודי שגיאה.
-
השמות של מרכזי הבקרה הקיימים האלה שונו:
- Endpoint Performance שונה ל-Target Performance: מציג דפוסי תעבורת נתונים ומדדי ביצועים עבור יעדי בק-אנד של proxy ל-API. צפייה בביצועים של יעדים
- מעורבות שותפים שונה למעורבות מפתחים: בדוח הזה אפשר לראות אילו מפתחי אפליקציות רשומים מניבים את התנועה הגבוהה ביותר ב-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 מ-API מחזירה סטטוס שגוי |
| MGMT-1962 | שגיאה בכניסה לממשק המשתמש לניהול עם סיסמה חזקה הכניסה לממשק המשתמש עם תווים מיוחדים מסוימים, כמו סימן האחוז, לא נכשלת יותר. |
| MGMT-1894 | הטעינה של הדף 'אפליקציות למפתחים' לא מסתיימת אף פעם בעמודה 'מפתח' |
| MGMT-1872 | אי אפשר להוריד דוחות בהתאמה אישית |
| MGMT-1777 | אי אפשר להוסיף משתמש עם כתובת אימייל ששם הדומיין שלה מסתיים ב- .acn |
| MGMT-1362 | האימייל 'שכחתי את הסיסמה' לא פועל אם כתובת האימייל מכילה את התו '_' תוקנה בעיה באיפוס סיסמה ב-Private Cloud עם כתובות אימייל שמכילות קו תחתון. |
| CORERT-613 | כשלים בלחיצת היד של SSL בגלל 'unrecognized_name' |
| APIRT-1346 | OAuth2.0 – ערך הגיבוב מוחזר בתגובה של אסימון הגישה אם hash.oauth.tokens.enabled מוגדר כ-true |
הגרסה הזו כוללת גם תיקוני באגים מהגרסאות הבאות:
| Edge Cloud | Edge for Private Cloud |
|---|---|
בעיות מוכרות
בגרסה הזו יש את הבעיות הידועות הבאות.
| מזהה הבעיה | תיאור |
|---|---|
| לא רלוונטי |
שני סקריפטים של Cassandra, שתוכנית ההתקנה משתמשת בהם בהתקנה או בשדרוג של מונטיזציה, לא נכללו במהדורה. כדי לעקוף את הבעיה הזו, מריצים את הפקודות הבאות אחרי ההתקנה או השדרוג של Cassandra כדי להשלים את ההתקנה או השדרוג של המונטיזציה:
|
| CORERT-318 | לפעמים קריאות ל-API עם מטען ייעודי גדול (מאות קילו-בייט) עלולות להיתקע. כדי לפתור את הבעיה, צריך להגדיר את ערך המאפיין הבא בקובץ router.properties:HTTPServer.streaming.buffer.limit=0 (הגדרת ברירת המחדל היא 10) |