אתם צופים במסמכי התיעוד של 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 - installation and upgrade
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 Management, והוא יופיע לצד הלוגו של Apigee. מידע נוסף זמין במאמר בנושא 'הוספת לוגו בהתאמה אישית לתפריט של ממשק המשתמש של Apigee' במדריך התפעול של Apigee Edge for Private Cloud.
יומנים של 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.
הגבלת הגישה של אדמינים למערכת לדומיינים ספציפיים של אימייל
אתם יכולים להגביל את החברות בתפקידים 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 (שרתי proxy של API), 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.
תמיכה ב-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) |