אתם צופים במסמכי העזרה של Apigee Edge.
כניסה למסמכי העזרה של Apigee X. info
ביום שלישי, 19 במאי 2015, השקנו גרסה רבעונית של Apigee Edge לענן פרטי.
שם המוצר הקודם, 'Apigee Edge On-premises' או 'OPDK', הוא עכשיו 'Apigee Edge for Private Cloud'.
אם יש לכם שאלות, אתם יכולים להיכנס אל תמיכת הלקוחות של Apigee.
רשימה של כל נתוני הגרסה של Apigee Edge מופיעה במאמר נתוני הגרסה של Apigee.
תכונות חדשות ושיפורים
בהמשך מפורטים התכונות החדשות והשיפורים בגרסה הזו.
OpenLDAP – התקנה ושדרוג
OpenLDAP הוא עכשיו שרת ה-LDAP היחיד שנתמך ב-Edge להתקנות חדשות ולשדרוגים.
שירותי API
בהמשך מפורטים פיצ'רים ושיפורים חדשים בשירותי Edge API.
WebSockets
כדי לאפשר תקשורת אינטרנט בזמן אמת בין לקוח אינטרנט לשרת, דפדפן Edge תומך בפרוטוקול WebSocket. ב-Edge אפשר להשתמש בתפקיד של לקוח או שרת בתקשורת WebSocket. למידע על הגדרה ושימוש ב-WebSockets ב-Edge, אפשר לעיין במדריך Apigee Edge לענן פרטי באמצעות 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 בתצוגת 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 בענן פרטי.
הגבלת הגישה של מנהלי מערכות לדומיינים ספציפיים של אימייל
אפשר להגביל את החברות בתפקידים 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 Proxies, 'מוצרים', 'מפתחים' ו'אפליקציות' בממשק המשתמש לניהול, יש אפשרויות סינון חדשות לחיפוש.
הכלי 'מעקב אופליין'
הכלי 'מעקב אופליין' מאפשר לכם להציג ולנתח סשנים של מעקב ששמרתם בעבר. סשן מעקב שנשמר הוא למעשה 'הקלטה' של סשן מעקב, והוא יכול להיות שימושי במקרים שבהם נדרשת פתרון בעיות וניתוח נוסף. ממשק המשתמש של הכלי למעקב אופליין דומה לממשק המשתמש של הכלי למעקב 'בזמן אמת'.
מידע נוסף זמין במאמר שימוש בכלי המעקב אופליין.
תפקידי משתמשים שמוצגים בהגדרות המשתמש
התפקידים של המשתמש מוצגים עכשיו בדף User Settings (הגדרות משתמש) בממשק המשתמש לניהול (username > User Settings).
שיפורים בממשק המשתמש לניהול Edge
הגרסה הזו כוללת כמה שיפורים קטנים בנוחות השימוש ובעקביות בממשק המשתמש לניהול של Edge.
שירותי Analytics
בהמשך מפורטות תכונות חדשות ושיפורים ב-Edge Analytics Services.
נתונים זמינים מ-6 חודשים האחרונים
כשיוצרים דוחות ניתוח נתונים באמצעות ממשק המשתמש לניהול או ממשק ה-API, כברירת מחדל אי אפשר לגשת לנתונים שנאספו לפני יותר משישה חודשים מהתאריך הנוכחי. כדי לגשת לנתונים מלפני יותר משישה חודשים, צריך לפנות אל התמיכה של Apigee.
משתנים שנוספו לניתוח הנתונים
המשתנים החדשים הבאים מועברים לניתוח של 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 – שם התהליך במדיניות שנכשל (למשל PreFlow, PostFlow או תהליך שהוגדר על ידי משתמש).
- 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. מרכז הבקרה הזה מחליף את מרכז הבקרה לבדיקת ביצועים של שרת proxy ל-API. ביצועים של שרת proxy ל-API
- Traffic Composition (שונה): העיצוב, הממשק והתוכן של לוח הבקרה שונו לחלוטין. המדד הזה מודד את התרומה היחסית של ממשקי ה-API, האפליקציות, המפתחים והמוצרים המובילים לתוכנית ה-API הכוללת שלכם. הרכב התנועה
- ניתוח שגיאות (מהדורה מעודכנת): העיצוב והתוכן שונו לחלוטין. הצגת שיעורי השגיאות בשרתי proxy ל-API וביעדים של API. לוח הבקרה של ניתוח קודי השגיאה
-
השמות של מרכזי הבקרה הקיימים האלה השתנו:
- השם של ביצועים של נקודת קצה השתנה לביצועים של יעד: מוצגים דפוסי תנועה ומדדי ביצועים של יעדי קצה לקצה העורפי של שרת proxy ל-API. טירגוט לפי ביצועים
- השם של הדוח מעורבות שותפים השתנה למעורבות מפתחים: בדוח הזה מוצגים מפתחי האפליקציות הרשומים שמניבים את תנועת ה-API הגדולה ביותר. תוכלו לראות לכל מפתח איזה מפתח יוצר הכי הרבה תנועה ב-API ומי יוצר הכי הרבה שגיאות. מעורבות של מפתחים
שירותים למפתחים
ריכזנו כאן את התכונות החדשות והשיפורים ב-Edge Developer Services.
תמיכה ב-Swagger 2.0 ל-SmartDocs
SmartDocs תומך בייבוא מסמכי מפרט של Swagger 2.0, ומתאים לאחור ל-Swagger 1.2. תמיכה באובייקטים של סכמות אבטחה ובסכמות מרוכזות תהיה זמינה בגרסה מאוחרת יותר.
מונטיזציה
בהמשך מפורטים פיצ'רים ושיפורים חדשים בנושא מונטיזציה ב-Edge. מידע נוסף על מונטיזציה זמין גם בקטע 'בעיות מוכרות'.
טיפול נפרד בחברות ובמפתחים
עכשיו אנחנו מטפלים בחברות ובמפתחים בנפרד, כך שתוכלו להוסיף בקלות כמה חברות למפתחים וכמה מפתחים לחברות. בממשק המשתמש לניהול יש עכשיו חלונות נפרדים ל'חברות' ול'מפתחים' (אפשר לגשת אליהם מהתפריט 'פרסום').
בדוחות המונטיזציה, חברות הן עדיין מסנן ראשי, אבל תווית המסנן השתנתה מ'מפתחים' ל'חברות'.
באגים שתוקנו
בגרסה הזו תוקנו הבאגים הבאים.
| מזהה הבעיה | תיאור |
|---|---|
| OPDK-954 | הסכימה של Cassandra בגרסה 4.15.01 לא משודרגת |
| MGMT-1986 | שגיאה בממשק המשתמש בזמן הוספת מפתח |
| MGMT-1983 | Get an OAuth 2.0 authorization code API returns wrong status |
| MGMT-1962 | שגיאה בכניסה לממשק המשתמש לניהול באמצעות סיסמה חזקה כניסה לממשק המשתמש באמצעות תווים מיוחדים מסוימים, כמו סימן האחוז, כבר לא נכשלת. |
| MGMT-1894 | הטעינה של דף האפליקציות למפתחים לעולם לא מסתיימת בעמודה של המפתח |
| MGMT-1872 | לא ניתן להוריד דוחות בהתאמה אישית |
| MGMT-1777 | לא ניתן להוסיף משתמש עם כתובת אימייל עם סיומת ברמה העליונה (TLD) של .acn |
| MGMT-1362 | האימייל 'שכחתי את הסיסמה' לא פועל אם כתובת האימייל מכילה '_' תוקנה בעיה של איפוס סיסמה בענן פרטי עם כתובות אימייל שמכילות קו תחתון. |
| CORERT-613 | כשל בהקשאת לחיצת היד של SSL בגלל 'unrecognized_name' |
| APIRT-1346 | OAuth2.0 – הערך המגובב מוחזר בתגובה של אסימון הגישה כשהערך של hash.oauth.tokens.enabled הוא true |
הגרסה הזו כוללת גם תיקוני באגים מהגרסאות הבאות:
| Edge Cloud | Edge לענן פרטי |
|---|---|
בעיות מוכרות
בגרסה הזו יש את הבעיות הידועות הבאות.
| מזהה הבעיה | תיאור |
|---|---|
| לא רלוונטי |
שני סקריפטים של Cassandra, שבהם מתבסס המתקין בהתקנה או בשדרוג של מונטיזציה, לא נכללו במהדורה. כדי לעקוף את הבעיה, מריצים את הפקודות הבאות אחרי ההתקנה או השדרוג של Cassandra כדי להשלים את ההתקנה או השדרוג של המונטיזציה:
|
| CORERT-318 | לפעמים קריאות ל-API עם עומסי עבודה גדולים (מאות קילובייט) עלולות להיתקע. כדי לעקוף את הבעיה הזו, מגדירים את ערך המאפיין הבא בקובץ router.properties:HTTPServer.streaming.buffer.limit=0 (ברירת המחדל היא 10) |