15.05.27 – נתוני הגרסה לענן של Apigee Edge

אתם צופים במסמכי התיעוד של Apigee Edge.
אפשר לעבור אל מסמכי התיעוד של Apigee X.
מידע

ביום שלישי, 2 ביוני 2015, השקנו גרסת ענן חדשה של Apigee Edge.

אם יש לכם שאלות, אתם יכולים לפנות אל התמיכה של Apigee Edge.

רשימה של כל נתוני הגרסה של Apigee Edge מופיעה במאמר נתוני הגרסה של Apigee.

תכונות חדשות ושיפורים

בהמשך מפורטים התכונות והשיפורים החדשים בגרסה הזו.

זמינות כללית של SmartDocs

התכונה SmartDocs יוצאת מגרסת בטא ועוברת לזמינות כללית. העדכונים והתכונות החדשות כוללים:

  • תמיכה ב-Swagger 2.0, כולל ייבוא לפי קובץ או כתובת URL, כולל תמיכה ב:‎ אובייקטים של אבטחה עם שמות מותאמים אישית.
  • שיפורים בעיצוב הוויזואלי בתבניות שיוצרות מסמכים חכמים.
  • שיפורים בשימושיות ובזרימת העבודה בפורטל למפתחים, שזמין דרך התפריט Content (תוכן) > SmartDocs ב-Drupal.
  • מה שנקרא בעבר אימות באמצעות 'טוקן מותאם אישית' נקרא עכשיו 'מפתח API'.
  • אובייקטים של אימות 'אבטחה' שמוגדרים ברמת הגרסה.
  • הגדרת אימות לקוח ברמת התבנית. בגרסאות חדשות יותר, כבר לא מתבצע איפוס של פרטי הכניסה של לקוח SmartDocs שהוגדרו מראש.

לתיאורים נוספים של התכונות, אפשר לעיין בפוסט הזה בבלוג.

מידע נוסף על SmartDocs זמין במאמר שימוש ב-SmartDocs לתיעוד ממשקי API.

גרסת בטא של עורך חדש של proxy ל-API

גרסת בטא חדשה של כלי העריכה של שרתי proxy של API זמינה. כדי לגשת לגרסת הבטא, לוחצים על הקישור 'גישה לגרסת הבטא' כשעורכים שרת proxy קיים של API. אפשר לעבור בין הגרסה הקלאסית לגרסת הבטא של כלי העריכה.

מדיניות OAuthV2 חדשה

המדיניות החדשה DeleteOAuthV2Info מאפשרת למחוק קודי הרשאה וטוקנים של גישה. מידע נוסף על מדיניות בנושא מחיקת פרטי OAuthV2

ישויות חדשות במדיניות Access Entity (גישה לישות)

מדיניות Access Entity מספקת גישה לישויות החדשות הבאות: consumerkey-scopes,‏ authorizationcode,‏ requesttoken ו-verifier. מידע נוסף זמין במאמר בנושא מדיניות לגבי ישויות גישה.

הצגת אישורי SSL שתוקפם עומד לפוג

בדף 'אישורי SSL' בממשק הניהול (אדמין > אישורי SSL) מצוין מתי תוקף אישורי ה-SSL יפוג תוך 10, 15, 30 או 90 ימים, בהתאם לבחירה שלכם בשדה החדש של התפריט הנפתח 'תוקף האישור יפוג'.

שם האפליקציה של המפתח שמוצג בממשק המשתמש לניהול

לאפליקציות למפתחים ב-Edge יש גם שם פנימי שלא משתנה וגם שם מוצג שאפשר לשנות. בדף של אפליקציית מפתח בממשק הניהול (Publish (פרסום) > Developer Apps (אפליקציות מפתח) > שם האפליקציה), השם הפנימי של האפליקציה מוצג לצד השם המוצג. כך קל יותר לזהות חזותית אפליקציות לפי השמות הפנימיים שלהן לצורך פתרון בעיות וניהול API.

הגרסה הקלאסית של דוחות בהתאמה אישית תוסר מממשק ניהול התוכן

הגרסה הקלאסית האופציונלית של דוחות ניתוח בהתאמה אישית לא זמינה יותר בממשק המשתמש של הניהול.


תהליך השדרוג של SmartDocs

אם כבר השתמשתם ב-SmartDocs במהלך תקופת הבטא, כדי להשתמש בתכונות וביכולות החדשות בגרסה הזמינה לקהל הרחב, תצטרכו לשדרג את SmartDocs בפורטל למפתחים.

דפי SmartDocs שכבר פורסמו בפורטל למפתחים ימשיכו לפעול, אבל תצטרכו לבצע את תהליך העדכון לפני שתערכו או תפרסמו שינויים בדפים קיימים או בדפים חדשים.

חשוב לזכור שאפשר לעבד ולפרסם SmartDocs בפורטל המפתחים, אבל הם נוצרים ממודל ה-API שקיים בשירותי ניהול ה-API של Apigee Edge. כל שינוי שתבצעו במודל API ב-Edge יהיה זהה בכל הסביבות של Pantheon (בדומה לאופן שבו מפתחים קיימים בכל הסביבות של Pantheon).

כדי לשדרג מגרסת הבטא של SmartDocs לגרסה שזמינה לכלל המשתמשים

  1. צריך לעדכן ולבדוק את הגרסה 15.05.27 בסביבות הפיתוח או הבדיקה ב-Pantheon.
  2. יוצרים מודל חדש כדי להחליף מודל API קיים שבו השתמשתם.
    • אם ייבאתם מסמכי Swagger או WADL, ייבאו אותם שוב לגרסה חדשה.
    • אם אתם מנהלים את מודל ה-API באמצעות מודול SmartDocs, תוכלו לייצא אותו כ-SmartDocs JSON ולייבא אותו למודל החדש באמצעות קובץ מצורף.
  3. מגדירים את מאפייני האבטחה של הגרסה של המודל. בדף Content > SmartDocs > model (תוכן > SmartDocs > דגם), בוחרים באפשרות Security Settings (הגדרות אבטחה).
  4. כדי לבדוק אם יש אימות שהוגדר מראש בדף ההגדרות של המודל (Content > SmartDocs), לוחצים על Settings (הגדרות) בעמודה Operations (פעולות).
  5. צריך לעדכן את כל התבניות המותאמות אישית כדי להשתמש בגרסה 6 של נכסי ה-CSS וה-JS, ולבצע שינויים שישקפו שמות אובייקטים חדשים, כמו authSchemes ו-apiSchema. מידע על עדכון תבניות SmartDocs זמין במאמר שימוש ב-SmartDocs לתיעוד ממשקי API.
  6. מעבדים מחדש את הגרסה של המודל ומפרסמים אותה.
  7. אחרי אימות התיעוד החדש, מעדכנים את פורטל הייצור לגרסה 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 כדי לוודא שהסכימה והביטויים שמשמשים בתנאים תקינים במהלך ייבוא ה-API Proxy.
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