‫۲۷/۰۵/۱۵ - یادداشت‌های انتشار ابر Apigee Edge

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید.
اطلاعات

در سه‌شنبه، ۲ ژوئن ۲۰۱۵، نسخه ابری جدیدی از Apigee Edge منتشر کردیم.

اگر سؤالی دارید، با پشتیبانی Apigee Edge تماس بگیرید.

برای مشاهده فهرستی از همه یادداشت‌های انتشار Apigee Edge، به یادداشت‌های انتشار Apigee مراجعه کنید.

ویژگی‌های جدید و بهبودها

در این نسخه پخش، ویژگی‌های جدید و موارد بهبودیافته زیر ارائه شده است.

دردسترس بودن عمومی SmartDocs

‫SmartDocs از نسخه بتا به دردسترس عموم قرار می‌گیرد. به‌روزرسانی‌ها و ویژگی‌های جدید شامل موارد زیر می‌شود:

  • پشتیبانی از Swagger 2.0، ازجمله وارد کردن براساس فایل یا نشانی وب، ازجمله پشتیبانی از اشیاء امنیتی با نام سفارشی.
  • بهبودهای طراحی دیداری در الگوهایی که «سند هوشمند» تولید می‌کنند.
  • بهبودهای گردش کار و قابلیت استفاده در «درگاه توسعه‌دهندگان»، که ازطریق منو «محتوا > SmartDocs» در Drupal دردسترس است.
  • آنچه قبلاً به‌عنوان اصالت‌سنجی «نماد سفارشی» شناخته می‌شد اکنون «کلید API» نامیده می‌شود.
  • اشیای «امنیت» اصالت‌سنجی در سطح بازبینی تعریف شده است.
  • پیکربندی اصالت‌سنجی کارخواه در سطح الگو. بازبینی‌های جدید دیگر اطلاعات اعتباری پیش‌پیکربندی‌شده مشتری SmartDocs را بازنشانی نمی‌کنند.

برای توضیحات بیشتر درباره ویژگی‌ها، این پست وبلاگ را ببینید.

برای مستندات SmartDocs، به استفاده از SmartDocs برای مستندسازی میاناهای برنامه‌سازی کاربردی مراجعه کنید.

نسخه بتای ویرایشگر جدید پراکسی API

نسخه بتای جدیدی از ویرایشگر پراکسی API دردسترس است. برای دسترسی، هنگام ویرایش یک پراکسی API موجود، روی پیوند «دسترسی به نسخه بتا» کلیک کنید. می‌توانید بین ویرایشگرهای «کلاسیک» و «بتا» جابه‌جا شوید.

خط‌مشی جدید OAuthV2

خط‌مشی جدید DeleteOAuthV2Info به شما امکان می‌دهد کدهای مجوز و کد دسترسی را حذف کنید. برای اطلاعات بیشتر، خط‌مشی حذف اطلاعات OAuthV2 را ببینید.

نهادهای جدید در خط‌مشی «دسترسی به نهاد»

خط‌مشی «دسترسی به نهاد» دسترسی به نهادهای جدید زیر را فراهم می‌کند: consumerkey-scopes، authorizationcode،‏ requesttoken، و verifier. برای اطلاعات بیشتر، خط‌مشی «دسترسی به نهاد» را ببینید.

نمایش گواهینامه‌های SSL که نزدیک به انقضا هستند

صفحه «گواهینامه‌های SSL» در واسط کاربر مدیریت (سرپرست > گواهینامه‌های SSL) نشان می‌دهد که گواهینامه‌های SSL در چه زمانی ظرف ۱۰، ۱۵، ۳۰، یا ۹۰ روز منقضی می‌شوند، که این زمان بستگی به انتخاب شما در فیلد کرکره‌ای انقضای جدید دارد.

نام برنامه توسعه‌دهنده در میانای کاربری مدیریت نمایش داده می‌شود

برنامه‌های توسعه‌دهنده در Edge هم «نام» داخلی دارند که تغییر نمی‌کند و هم «نام نمایشی» که می‌توانید تغییر دهید. در صفحه «برنامه توسعه‌دهنده» در واسط کاربر مدیریت (انتشار > برنامه‌های توسعه‌دهنده > نام برنامه)، «نام» داخلی برنامه همراه با «نام نمایشی» نمایش داده می‌شود که شناسایی بصری برنامه‌ها براساس نام‌های داخلی آن‌ها را برای عیب‌یابی و مدیریت API آسان‌تر می‌کند.

نسخه کلاسیک گزارش‌های سفارشی از رابط کاربری مدیریت برداشته می‌شود

نسخه اختیاری کلاسیک گزارش‌های تجزیه‌وتحلیل سفارشی دیگر در واسط کاربر مدیریت دردسترس نیست.


فرایند ارتقا SmartDocs

اگر قبلاً در دوره بتا از «سندهای هوشمند» استفاده کرده‌اید، ویژگی‌ها و قابلیت‌های جدید در نسخه دردسترس عمومی نیازمند این است که «سندهای هوشمند» را در درگاه توسعه‌دهنده ارتقا دهید.

هر صفحه SmartDocs که قبلاً در درگاه توسعه‌دهندگان شما منتشر شده است به کار خود ادامه خواهد داد، اما قبل‌از ویرایش یا انتشار هرگونه تغییر در صفحات موجود یا جدید، باید فرایند به‌روزرسانی را دنبال کنید.

به‌خاطر داشته باشید که اگرچه می‌توانید SmartDocs را در درگاه توسعه‌دهندگان خود پردازش و منتشر کنید، SmartDocs از مدل API که در «خدمات مدیریت API» در Apigee's Edge API Management قرار دارد تولید می‌شود. هر تغییری که در مدل API در Edge ایجاد کنید در همه محیط‌های Pantheon شما یکسان خواهد بود (مشابه با نحوه وجود توسعه‌دهندگان در محیط‌های Pantheon).

برای ارتقا از نسخه بتای SmartDocs به دردسترس بودن عمومی

  1. نسخه 15.05.27 را در محیط‌های توسعه‌دهنده یا آزمایشی در Pantheon به‌روزرسانی و آزمایش کنید.
  2. مدل جدیدی ایجاد کنید تا جایگزین هر مدل API موجودی شود که استفاده می‌کرده‌اید.
    • اگر اسناد Swagger یا WADL را وارد کرده‌اید، آن‌ها را دوباره در نسخه جدیدی وارد کنید.
    • اگر مدل API خود را ازطریق واحد SmartDocs حفظ کرده‌اید، آن را به‌صورت SmartDocs JSON صادر کنید و بااستفاده از پیوست فایل در مدل جدیدتان وارد کنید.
  3. ویژگی‌های امنیتی نسخه اصلاح‌شده مدل را تنظیم کنید. در صفحه محتوا > SmartDocs > مدل، تنظیمات امنیتی را انتخاب کنید.
  4. با کلیک کردن روی تنظیمات در ستون «عملیات»، هرگونه اصالت‌سنجی ازپیش پیکربندی‌شده را در صفحه تنظیمات مدل (محتوا > SmartDocs) بررسی کنید.
  5. همه الگوهای سفارشی را به‌روز کنید تا از نسخه ۶ دارایی‌های CSS و JS استفاده کنند و تغییراتی ایجاد کنید تا نام‌های شیء جدید، مثل authSchemes و apiSchema، را منعکس کنند. برای کسب اطلاعات درباره به‌روزرسانی الگوهای «سندهای هوشمند»، به استفاده از «سندهای هوشمند» برای مستندسازی میاناهای برنامه‌سازی کاربردی مراجعه کنید.
  6. نسخه اصلاح‌شده مدل را مجدداً پرداز و منتشر کنید.
  7. پس‌از اعتبارسنجی اسناد جدید، درگاه تولید خود را به نسخه 15.05.27 به‌روز کنید.

اگر مشتری سازمانی Edge هستید و درباره فرایند ارتقا سؤال یا نگرانی دارید، لطفاً به marsh@apigee.com و cnovak@apigee.com ایمیل ارسال کنید. درغیراین‌صورت، لطفاً برای دریافت بهترین پاسخ از انجمن Apigee استفاده کنید.

اشکالات رفع شد

اشکالات زیر در این نسخه پخش برطرف شده است.

شناسه مشکل شرح
TBD-72 مشکل خط‌مشی گزارش پیام
MGMT-2124 اجازه‌های نقش مشتری هنگام ذخیره کردن اجازه‌ها در واسط کاربر بازنشانی می‌شود
MGMT-2048 کاربری با نقش سفارشی که اجازه‌های استقرار را به یک محیط محدود می‌کند می‌تواند در محیط‌های دیگر مستقر کند
MGMT-2041 برداشتن عنصر FaultRules از الگوی پیوست پیش‌فرض
عنصر FaultRules که در خط‌مشی‌ها یا مراحل پراکسی API استفاده نمی‌شود، دیگر هنگام ایجاد پراکسی‌های API یا افزودن خط‌مشی‌ها به‌طور خودکار اضافه نمی‌شود.
MGMT-2034 واکشی WSDL ناموفق بود: «خطای واکشی WSDL: خطای پردازش WSDL.»
MGMT-1812 افزودن اعتبارسنجی TargetEndpoint درطول وارد کردن
مشابه ProxyEndpoint،‏ TargetEndpoint برای طرحواره صحیح و عبارات استفاده‌شده در شرایط درطول وارد کردن پراکسی API اعتبارسنجی خواهد شد.
MGMT-1345 وارد کردن WSDL با چندین فضای نام منجر به «ساختن SOAP» نادرست می‌شود مرحله
MGMT-800 ایجاد منبع با نام «پیش‌فرض» منجر به خرابی میانای کاربر می‌شود
MGMT-602 نمای توسعه «پراکسی میانای برنامه‌سازی کاربردی»: وقتی نقطه پایانی PreFlow/PostFlow ندارد، خط‌مشی «حافظه نهان پاسخ» را اضافه کنید که باعث خطا می‌شود
MGMT-460 تغییر نام خط‌مشی منجر به رفتار پرخطا، خط‌مشی تکراری که نمی‌تواند برداشته شود
DEVRT-1565 فاصله‌های ۱۵ دقیقه‌ای برای «شارژها»
AXAPP-1728 نادیده گرفتن متغیرهای درآمدزایی در Analytics
AXAPP-1690 «خطای نامعتبر API» در گزارش‌های سفارشی
AXAPP-1533 ‫Analytics Geomap خطای «فراخوانی نامعتبر API» را برمی‌گرداند
APIRT-52 گزارش‌های سفارشی: کد وضعیت پاسخ برای بسیاری از «میاناهای برنامه‌سازی کاربردی» تهی است