אתם צופים במסמכי התיעוד של 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 ל-Private Cloud.
יומנים של Node.js במעקב
כשמבצעים ניפוי באגים בשרתי proxy של Node.js API, אפשר להפעיל את התכונה Node.js Log בתצוגת Trace של כלי העריכה של שרת ה-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.
הגבלת הגישה של אדמינים למערכת לדומיינים ספציפיים של אימייל
אתם יכולים להגביל את החברות בתפקידים sysadmin או sysadmin read-only למשתמשים בדומיינים ספציפיים של כתובות אימייל. כדי להפעיל את התכונה הזו, צריך להוסיף את הדומיינים המותרים לקובץ 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> – סיבת השגיאה. לדוגמה: 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: בדף הזה מוצגים דפוסי תנועה ומדדי ביצועים של יעדי קצה (endpoint) בעורף של שרת proxy של API. צפייה בביצועים של יעדים
- הדוח Partner Engagement (אינטראקציה עם שותפים) נקרא עכשיו Developer Engagement (אינטראקציה עם מפתחים): בדוח הזה אפשר לראות אילו מפתחי אפליקציות רשומים מניבים את התנועה הגבוהה ביותר ב-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 עם מטען ייעודי (payload) גדול (מאות קילו-בייט) עלולות להיתקע. כדי לפתור את הבעיה, צריך להגדיר את ערך המאפיין הבא בקובץ router.properties:HTTPServer.streaming.buffer.limit=0 (הגדרת ברירת המחדל היא 10) |