אתם צופים במסמכי העזרה של Apigee Edge.
כניסה למסמכי העזרה של Apigee X. info
ביום שלישי, 2 ביוני 2015, השקנו גרסה חדשה של Apigee Edge בענן.
אם יש לכם שאלות, אתם יכולים להיכנס אל תמיכת הלקוחות של Apigee.
רשימה של כל נתוני הגרסה של Apigee Edge מופיעה במאמר נתוני הגרסה של Apigee.
תכונות חדשות ושיפורים
בהמשך מפורטים התכונות החדשות והשיפורים בגרסה הזו.
הזמינות הכללית של SmartDocs
SmartDocs עובר מגרסת בטא לזמינות לכולם. העדכונים והתכונות החדשות כוללים:
- תמיכה ב-Swagger 2.0, כולל ייבוא באמצעות קובץ או כתובת URL, כולל תמיכה באובייקטי אבטחה עם שמות מותאמים אישית.
- שיפורים בעיצוב החזותי של התבניות שמשמשות ליצירת מסמכי SmartDocs.
- שיפורים בממשק המשתמש ובתהליך העבודה בפורטל למפתחים, שזמינים דרך התפריט Content > SmartDocs ב-Drupal.
- האימות שהיה ידוע בתור 'אימות באמצעות טוקן מותאם אישית' נקרא עכשיו 'מפתח API'.
- אובייקטים של 'אבטחה' לאימות שמוגדרים ברמת הגרסה.
- הגדרת אימות לקוח ברמת התבנית. גרסאות חדשות לא מאפסות יותר את פרטי הכניסה של לקוחות SmartDocs שהוגדרו מראש.
בפוסט הזה בבלוג מפורטות תיאורים נוספים של התכונות.
למסמכי העזרה של SmartDocs, ראו שימוש ב-SmartDocs לתיעוד ממשקי API.
גרסת בטא של עורך חדש ל-proxy ל-API
גרסת בטא חדשה של עורך שרת ה-proxy של ה-API זמינה. כדי לגשת לגרסת הבטא, לוחצים על הקישור 'גישה לגרסת הבטא' כשעורכים שרת proxy קיים ל-API. אפשר לעבור בין הגרסה הקלאסית לבין גרסת הבטא של הכלי לעריכה.
מדיניות חדשה של OAuthV2
המדיניות החדשה בנושא מחיקה של פרטי OAuth V2 מאפשרת למחוק קודי הרשאה ואסימוני גישה. למידע נוסף, ראו מדיניות המחיקה של פרטי OAuthV2.
ישויות חדשות במדיניות של ישויות גישה
מדיניות ישות הגישה מספקת גישה לישויות החדשות הבאות: consumerkey-scopes, authorizationcode, requesttoken ו-verifier. מידע נוסף זמין במאמר מדיניות של ישות גישה.
הצגת אישורי SSL שפג תוקפם בקרוב
בדף SSL Certificates בממשק המשתמש לניהול (Admin > SSL Certificates), מצוין מתי יפוג התוקף של אישורי ה-SSL תוך 10, 15, 30 או 90 יום, בהתאם לבחירה שלכם בשדה הנפתח החדש של התוקף.
שם האפליקציה של המפתח שמוצג בממשק המשתמש לניהול
לאפליקציות של מפתחים ב-Edge יש שם פנימי שלא משתנה ושם מוצג שאפשר לשנות. בדף של אפליקציית הפיתוח בממשק המשתמש לניהול (פרסום > אפליקציות פיתוח > שם האפליקציה), מוצג 'השם' הפנימי של האפליקציה לצד 'השם המוצג', כך שקל יותר לזהות חזותית אפליקציות לפי השמות הפנימיים שלהן לצורך פתרון בעיות וניהול ממשקי API.
הגרסה הקלאסית של דוחות בהתאמה אישית תוסר מממשק המשתמש לניהול
הגרסה הקלאסית האופציונלית של דוחות ניתוח נתונים בהתאמה אישית כבר לא זמינה בממשק המשתמש לניהול.
תהליך השדרוג של SmartDocs
אם כבר השתמשתם ב-SmartDocs במהלך תקופת הבטא, כדי ליהנות מהתכונות והיכולות החדשות בגרסה הזמינה לכולם, תצטרכו לשדרג את SmartDocs בפורטל למפתחים.
דפי SmartDocs שכבר פורסמו בפורטל למפתחים ימשיכו לפעול, אבל עליכם לפעול לפי תהליך העדכון לפני שתערכו או תפרסמו שינויים בדפים קיימים או חדשים.
חשוב לזכור שאפשר ליצור ולפרסם SmartDocs בפורטל המפתחים, אבל הם נוצרים מתוך מודל ה-API שנמצא בשירותי ניהול ה-API של Apigee Edge. כל שינוי שתבצעו במודל API ב-Edge יהיה זהה בכל הסביבות של Pantheon (בדומה לאופן שבו מפתחים קיימים בסביבות Pantheon).
איך לשדרג מגרסת הבטא של SmartDocs לגרסה הזמינה לכולם
- מעדכנים את הגרסה 15.05.27 ובודקים אותה בסביבות dev או test ב-Pantheon.
- יוצרים מודל חדש שיחליף כל מודל API קיים שבו השתמשתם.
- אם מייבאים מסמכי Swagger או WADL, צריך לייבא אותם שוב לגרסה חדשה.
- אם טיפלתם במודל ה-API דרך המודול SmartDocs, תוכלו לייצא אותו כ-JSON של SmartDocs ולייבא אותו למודל החדש באמצעות צירוף קובץ.
- מגדירים את מאפייני האבטחה של הגרסה של המודל. בדף תוכן >
מסמכים חכמים > דגם, בוחרים באפשרות הגדרות אבטחה.
- בדף ההגדרות של המודל (תוכן >
SmartDocs), לוחצים על הגדרות בעמודה Operations (פעולות).
- מעדכנים את התבניות בהתאמה אישית כך שישתמשו בגרסה 6 של נכסי ה-CSS וה-JS, ומבצעים שינויים כך שישקפו את שמות האובייקטים החדשים, כמו authSchemes ו-apiSchema. מידע נוסף על עדכון תבניות של SmartDocs זמין במאמר שימוש ב-SmartDocs לתיעוד ממשקי API.
- מבצעים עיבוד מחדש (re-render) של הגרסה המתוקנת של המודל ומפרסמים אותה.
- אחרי שתאמתו את המסמכים החדשים, עליכם לעדכן את הפורטל של ייצור לגרסה 15.05.27.
לקוחות Edge Enterprise שיש להם שאלות או חששות לגבי תהליך השדרוג יכולים לשלוח אימייל לכתובות marsh@apigee.com ו-cnovak@apigee.com. לחלופין, אפשר להיעזר בקהילת Apigee כדי לקבל את התשובה הטובה ביותר.
באגים שתוקנו
בגרסה הזו תוקנו הבאגים הבאים.
| מזהה הבעיה | תיאור |
|---|---|
| TBD-72 | בעיה במדיניות הרישום ביומן של הודעות |
| MGMT-2124 | ההרשאות של תפקיד הלקוח מתאפסות כששומרים את ההרשאות בממשק המשתמש |
| MGMT-2048 | משתמש עם תפקיד בהתאמה אישית שמגביל את הרשאות הפריסה לסביבה אחת יכול לפרוס בסביבות אחרות |
| MGMT-2041 | הסרת האלמנט FaultRules מתבנית הקובץ המצורף שמוגדרת כברירת מחדל האלמנט FaultRules, שלא משמש במדיניות או בשלבים של שרת proxy ל-API, לא מתווסף יותר באופן אוטומטי כשיוצרים שרתי proxy ל-API או מוסיפים מדיניות. |
| MGMT-2034 | אחזור WSDL מחזיר כשל: "שגיאת אחזור WSDL: שגיאה בעיבוד WSDL" |
| MGMT-1812 | הוספת אימות של TargetEndpoint במהלך הייבוא בדומה ל-ProxyEndpoint, במהלך הייבוא של שרת ה-proxy ל-API, המערכת תאמת את הסכימה ואת הביטויים המתאימים של TargetEndpoint שנעשה בהם שימוש בתנאים. |
| MGMT-1345 | ייבוא של WSDL עם כמה מרחבי שמות גורם לשלב שגוי של Build SOAP |
| MGMT-800 | יצירת משאב בשם 'default' גורמת לתצוגת משתמש שבורה |
| MGMT-602 | תצוגת הפיתוח של שרת proxy ל-API: הוספת מדיניות של מטמון תגובות כשנקודת קצה לא כוללת תהליך PreFlow/PostFlow שגורם לשגיאה |
| MGMT-460 | שינוי השם של המדיניות גורם לבעיות בהתנהגות, למדיניות כפולה שלא ניתן להסיר |
| DEVRT-1565 | מרווחי זמן של 15 דקות לחיוב |
| AXAPP-1728 | התעלמות ממשתני מונטיזציה ב-Analytics |
| AXAPP-1690 | 'שגיאת API לא חוקית' בדוחות מותאמים אישית |
| AXAPP-1533 | ב-Analytics Geomap מתקבלת השגיאה 'קריאה לא חוקית ל-API' |
| APIRT-52 | דוחות מותאמים אישית: קוד סטטוס התגובה של הרבה ממשקי API הוא null |