אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X. מידע
ביום שלישי, 2 ביוני 2015, השקנו גרסת ענן חדשה של Apigee Edge.
אם יש לכם שאלות, אתם יכולים לפנות לתמיכה של Apigee Edge.
רשימה של כל נתוני הגרסה של Apigee Edge מופיעה במאמר נתוני הגרסה של Apigee.
תכונות חדשות ושיפורים
בהמשך מפורטים התכונות והשיפורים החדשים בגרסה הזו.
זמינות כללית של SmartDocs
התכונה SmartDocs עוברת מגרסת בטא לגרסה שזמינה לכלל המשתמשים (GA). העדכונים והתכונות החדשות כוללים:
- תמיכה ב-Swagger 2.0, כולל ייבוא לפי קובץ או כתובת URL, כולל תמיכה ב: אובייקטים של אבטחה עם שמות מותאמים אישית.
- שיפורים בעיצוב החזותי בתבניות שיוצרות מסמכים חכמים.
- שיפורים בשימושיות ובזרימת העבודה בפורטל למפתחים, שזמינים דרך התפריט Content (תוכן) > SmartDocs ב-Drupal.
- מה שנקרא בעבר אימות באמצעות 'טוקן בהתאמה אישית' נקרא עכשיו 'מפתח API'.
- אובייקטים של אימות (Authentication) ושל אבטחה (Security) שמוגדרים ברמת השינוי.
- הגדרת אימות לקוח ברמת התבנית. בגרסאות חדשות יותר, אי אפשר יותר לאפס את פרטי הכניסה של לקוח SmartDocs שהוגדרו מראש.
לתיאורים נוספים של התכונות, אפשר לעיין בפוסט הזה בבלוג.
מידע נוסף על SmartDocs זמין במאמר שימוש ב-SmartDocs לתיעוד ממשקי API.
גרסת בטא חדשה של עורך proxy ל-API
גרסת בטא חדשה של עורך proxy ל-API זמינה. כדי לגשת לגרסת הבטא, לוחצים על הקישור 'גישה לגרסת הבטא' כשעורכים פרוקסי קיים של API. אפשר לעבור באופן חופשי בין הגרסה הקלאסית לבין גרסת הבטא של כלי העריכה.
מדיניות OAuthV2 חדשה
המדיניות החדשה DeleteOAuthV2Info מאפשרת לכם למחוק קודי הרשאה וטוקנים של גישה. מידע נוסף על מדיניות בנושא מחיקת פרטי OAuthV2
ישויות חדשות במדיניות Access Entity (גישה לישות)
מדיניות Access Entity מספקת גישה לישויות החדשות הבאות: consumerkey-scopes, authorizationcode, requesttoken ו-verifier. מידע נוסף זמין במאמר בנושא מדיניות לגבי ישויות גישה.
הצגת אישורי SSL שתוקפם עומד לפוג
בדף SSL Certificates (אישורי SSL) בממשק הניהול (Admin > SSL Certificates) מצוין מתי תוקף אישורי ה-SSL יפוג תוך 10, 15, 30 או 90 ימים, בהתאם לבחירה בשדה החדש של התאריך האחרון לתוקף בתפריט הנפתח.
שם האפליקציה של המפתח שמוצג בממשק המשתמש לניהול
לאפליקציות למפתחים ב-Edge יש גם שם פנימי שלא משתנה וגם שם מוצג שאפשר לשנות. בדף של אפליקציית מפתח בממשק הניהול (Publish > Developer Apps > app name), השם הפנימי של האפליקציה מוצג לצד השם המוצג, וכך קל יותר לזהות חזותית אפליקציות לפי השמות הפנימיים שלהן לצורך פתרון בעיות וניהול API.
הגרסה הקלאסית של דוחות בהתאמה אישית תוסר מממשק הניהול
הגרסה הקלאסית האופציונלית של דוחות ניתוח בהתאמה אישית לא זמינה יותר בממשק המשתמש של הניהול.
תהליך השדרוג של SmartDocs
אם כבר השתמשתם ב-SmartDocs במהלך תקופת הבטא, תכונות ויכולות חדשות בגרסת הזמינות לכלל המשתמשים (GA) דורשות שתשדרגו את SmartDocs בפורטל למפתחים.
כל הדפים של SmartDocs שכבר פורסמו בפורטל למפתחים ימשיכו לפעול, אבל תצטרכו לפעול לפי תהליך העדכון לפני שתערכו או תפרסמו שינויים בדפים קיימים או בדפים חדשים.
חשוב לזכור שאפשר לעבד ולפרסם SmartDocs בפורטל המפתחים, אבל מסמכי SmartDocs נוצרים ממודל ה-API שקיים בשירותי ניהול ה-API של Apigee Edge. כל שינוי שתבצעו במודל API ב-Edge יהיה זהה בכל סביבות Pantheon שלכם (בדומה לאופן שבו מפתחים קיימים בסביבות Pantheon).
כדי לשדרג מגרסת הבטא של SmartDocs לגרסה שזמינה לכלל המשתמשים
- צריך לעדכן ולבדוק את הגרסה 15.05.27 בסביבות הפיתוח או הבדיקה ב-Pantheon.
- יוצרים מודל חדש כדי להחליף מודל API קיים שבו השתמשתם.
- אם ייבאתם מסמכי Swagger או WADL, ייבאו אותם שוב לגרסה חדשה.
- אם אתם מנהלים את מודל ה-API באמצעות מודול SmartDocs, תוכלו לייצא אותו כ-SmartDocs JSON ולייבא אותו למודל החדש באמצעות קובץ מצורף.
- מגדירים את מאפייני האבטחה של הגרסה של המודל. בדף Content >
SmartDocs > model, בוחרים באפשרות Security Settings.
- כדי לבדוק אם יש אימות שהוגדר מראש בדף הגדרות המודל (Content >
SmartDocs), לוחצים על Settings (הגדרות) בעמודה Operations (פעולות).
- צריך לעדכן את כל התבניות המותאמות אישית כדי להשתמש בנכסי CSS ו-JS בגרסה 6, ולבצע שינויים שישקפו שמות אובייקטים חדשים, כמו authSchemes ו-apiSchema. מידע על עדכון תבניות SmartDocs זמין במאמר שימוש ב-SmartDocs לתיעוד ממשקי API.
- מבצעים רינדור מחדש ומפרסמים את הגרסה המתוקנת של המודל.
- אחרי אימות התיעוד החדש, מעדכנים את פורטל הייצור לגרסה 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, המערכת תאמת את TargetEndpoint כדי לוודא שהסכימה והביטויים שמשמשים בתנאים תקינים במהלך הייבוא של ה-proxy ל-API. |
| MGMT-1345 | ייבוא של WSDL עם כמה מרחבי שמות מוביל ליצירת שלב Build SOAP שגוי |
| MGMT-800 | יצירת משאב עם השם 'default' גורמת לממשק משתמש פגום |
| MGMT-602 | תצוגת פיתוח של API Proxy: הוספת מדיניות של מטמון תגובות כשנקודת הקצה לא כוללת PreFlow/PostFlow גורמת לשגיאה |
| MGMT-460 | שינוי השם של מדיניות גורם להתנהגות לא תקינה, מדיניות כפולה שלא ניתן להסיר |
| DEVRT-1565 | מרווחי זמן של 15 דקות לחיובים |
| AXAPP-1728 | התעלמות ממשתני מונטיזציה בניתוח הנתונים |
| AXAPP-1690 | "שגיאת API לא תקינה" בדוחות בהתאמה אישית |
| AXAPP-1533 | השגיאה Invalid API Call מוצגת במפה הגיאוגרפית של Analytics |
| APIRT-52 | דוחות בהתאמה אישית: קוד הסטטוס של התגובה להרבה ממשקי API הוא null |