‫4.15.01.00 - یادداشت‌های انتشار Apigee Edge در محل

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

در سه‌شنبه ۲۷ ژانویه ۲۰۱۵، نسخه فصلی Apigee Edge on-premises را منتشر کردیم.

نسخه ۴.۱۵.۰۱.۰۰ شامل تعداد زیادی ویژگی جدید است که بسیاری از آن‌ها در زمینه آخرین فصل تعطیلات و در نسخه‌های پخش ابری قبلی مورد توجه قرار گرفته‌اند. حوزه‌های ویژگی جدید شامل چارچوب واسط کاربر مدیریت، LDAP، نصب و ارتقا، تجزیه‌وتحلیل، و پیکربندی خطای پاسخ و فشرده‌سازی می‌شود. فهرست کامل موارد زیر را ببینید.

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

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

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

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

  • ‫OpenLDAP جایگزین ApacheDS می‌شود
    اکنون Edge برای اصالت‌سنجی کاربران در محیط مدیریت API شما،‏ OpenLDAP را ارائه می‌دهد. ازجمله مزایای OpenLDAP، خط‌مشی گذرواژه‌ای است که به شما امکان می‌دهد گزینه‌های اصالت‌سنجی گذرواژه مختلفی را پیکربندی کنید، مثلاً تعداد تلاش‌های ناموفق متوالی برای ورود به سیستم که پس‌از آن دیگر نمی‌توان از گذرواژه برای اصالت‌سنجی کاربر در فهرست راهنما استفاده کرد. برای اطلاعات بیشتر، راهنمای عملیات Edge OPDK را ببینید.

    اکنون OpenLDAP تنها سرور LDAP است که Edge برای نصب‌های جدید پشتیبانی می‌کند. نصب‌های موجود Edge که به نسخه ۴.۱۵.۰۱.۰۰ ارتقا می‌یابند می‌توانند همچنان از ApacheDS استفاده کنند، اما همه نصب‌های جدید نسخه ۴.۱۵.۰۱.۰۰ از OpenLDAP استفاده می‌کنند.

    اگر انتخاب کنید که به‌عنوان بخشی از فرایند نصب نسخه 4.15.01.00 به OpenLDAP ارتقا دهید، همه داده‌های ApacheDS به OpenLDAP منتقل می‌شود. برای اطلاعات بیشتر درباره ارتقا، به بخش مشکلات شناخته‌شده مراجعه کنید.
  • بهبودهای امنیتی
    بهبودهای امنیتی در این نسخه به آسیب‌پذیری‌های تزریق مسیر و پیمایش، اجازه‌های دسترسی مبتنی بر نقش، آسیب‌پذیری‌های جعل درخواست بین‌سایتی، دور زدن مجوز در واسط کاربر مدیریت Edge، و آسیب‌پذیری‌های نهاد خارجی می‌پردازد.
  • بهبود عملکرد و پایداری Apache Cassandra
    این نسخه شامل بهبود عملکرد در نحوه دسترسی محصول Edge به پایگاه داده NoSQL Cassandra، و همچنین بهبودهایی در خود Cassandra است که از نسخه 1.2.11 به 1.2.19 ارتقا می‌یابد.
  • بهبودهای مدیریت کد
    علاوه‌بر بهبودهای مربوط به برگرداندن ژتون‌های OAuth و پاک‌سازی آن‌ها در پایگاه داده، اکنون می‌توانید ژتون‌های دسترسی OAuth 2.0 را براساس شناسه کاربر نهایی، شناسه برنامه، یا هر دو بازیابی و باطل کنید. برای اطلاعات بیشتر، موارد زیر را ببینید:
  • بهبودهای Analytics
    این نسخه شامل بهبودهای زیادی در تجزیه‌وتحلیل است، ازجمله:
    • سنجه‌های گسترده درباره استفاده از حافظه نهان در پراکسی‌های API.
    • تجزیه‌وتحلیل تأخیر. علاوه‌بر داشبورد تجزیه‌وتحلیل تأخیر (فقط طرح Apigee Edge)، سنجه‌های جدید صدک برتر (TP*) در گزارش‌های سفارشی به شما امکان می‌دهد آستانه زمانی را که درصد معینی از تراکنش‌ها در آن تکمیل می‌شوند ببینید. برای مثال، سنجه TP99 آستانه زمانی را نشان می‌دهد که در آن ۹۹٪ تراکنش‌ها تکمیل می‌شوند.
    • ابعاد مجازی - عامل‌های کاربر، مُهرهای زمان، و نشانی‌های IP به‌طور خودکار به ابعادی مثل نسخه سیستم‌عامل، خانواده دستگاه، روز هفته، شهر، کشور، و منطقه زمانی نگاشت می‌شوند.
    • واسط کاربری تازه طراحی‌شده برای «گزارش‌های سفارشی» (نسخه بتا)
    • پشتیبانی برای پراکسی‌های داخلی Apigee 127
    • پرچم‌های بولی جدید «خطای Apigee» و «خطای هدف» که توسط Analytics ضبط می‌شوند
  • بهبودهای انعطاف‌پذیری زمان اجرا
    این نسخه شامل بهبودهای انعطاف‌پذیری زمان اجرای زیادی است، ازجمله دردسترس بودن خط‌مشی در خرابی Cassandra، پایداری مسیریاب Netty، و پایداری رشته SSL.
  • بهبودهای Node.js
    بهبودهای Node.js زیر در این نسخهٔ پخش گنجانده شده است:
    • میانای برنامه‌سازی کاربردی جدید دریافت گزارش‌های Node.js ذخیره‌شده در حافظه نهان که به شما امکان می‌دهد چند صد گزارش آخر را از یک دستورگان Node.js بازیابی کنید.
    • پشتیبانی از واحد «trireme-support» (واحدهای Node.js که به زبان جاوا نوشته شده‌اند). برای اطلاعات بیشتر، به https://www.npmjs.com/package/trireme-support مراجعه کنید.
    • نام‌های سازمان و محیط از مسیرهای مجازی برداشته شد و به متغیرها منتقل شد.
    • به Java 7 ارتقا دهید.
    • به Trireme 0.8.4 ارتقا دهید، که مشکلات مربوط به تجزیه و تحلیل درخواست HTTP و مدیریت مجموعه‌های نویسه غیر UTF-8 را برطرف می‌کند.
  • ‫Play Framework به نسخه ۲.۰ ارتقا یافت
    ‫Play Framework مورداستفاده Edge، ازجمله درآمدزایی، به Play 2.0 ارتقا یافته است.
  • اکنون می‌توان آمار پایش JMX را به‌گونه‌ای پیکربندی کرد که به گذرواژه نیاز داشته باشد
    فرایند پایش برای «سرور مدیریت»، «مسیریاب»، «پردازشگر پیام»، QPID، و Postgres همگی از JMX استفاده می‌کنند. ‫JMX به‌طور پیش‌فرض فعال است و دسترسی ازراه‌دور به JMX به گذرواژه نیاز ندارد. بااین‌حال، اکنون می‌توانید محافظت با گذرواژه را برای آمار JMX اعمال کنید تا دسترسی را کنترل کنید. برای اطلاعات بیشتر، راهنمای عملیات Edge را ببینید.
  • کارت‌های جوکر در منابع پراکسی API
    هنگام تعریف منابع پراکسی API می‌توانید از نویسه‌های کارت جوکر (ستاره *) استفاده کنید. برای مثال، /developers/*/apps یا /developers/**. برای کسب اطلاعات بیشتر درباره منابع پراکسی API، به نگاشت جریان‌های شرطی به منابع API زیرینه مراجعه کنید.
  • منبع «/» در محصولاتAPIRT-667
    وقتی منبعی را به محصول API به‌عنوان یک اسلش «/» اضافه می‌کنید، Apigee به‌طور پیش‌فرض آن را همانند «/**» درنظر می‌گیرد، که به توسعه‌دهندگان امکان دسترسی به همه نشانی‌های وب زیر مسیر پایه را می‌دهد. یک دارایی features.isSingleForwardSlashBlockingEnabled سطح سازمانی جدید به شما امکان می‌دهد رفتار پیش‌فرض «/» را تغییر دهید. با تغییر دادن دارایی به «true» (مشتریان فضای ابری باید برای انجام این کار با «پشتیبانی Apigee» تماس بگیرند)، «/» به توسعه‌دهندگان امکان می‌دهد فقط به مسیر پایه به‌عنوان منبع دسترسی داشته باشند.

    برای اطلاعات بیشتر، پیکربندی رفتار مسیر منبع را ببینید.
  • پیکربندی خطای پاسخ HTTP برای «سهمیه» و «مهار جهش»APIRT-664
    اکنون می‌توان سازمان‌های Apigee Edge را پیکربندی کرد تا برای همه درخواست‌هایی که از حد نرخ تعیین‌شده توسط خط‌مشی «سهمیه» یا «مهار جهش» فراتر می‌روند، کد وضعیت HTTP‏ ۴۲۹ (درخواست‌های بسیار زیاد) برگردانند. پیکربندی پیش‌فرض کد وضعیت HTTP 500 (خطای سرور داخلی) را برمی‌گرداند.

    برای اینکه نقض‌های «سهمیه» و «مهار جهش» برای سازمان‌هایی که می‌خواهید کد وضعیت HTTP‏ ۴۲۹ برگردانند، ویژگی features.isHTTPStatusTooManyRequestEnabled روی درست تنظیم شود، با «پشتیبانی Apigee» تماس بگیرید.
  • ‫HealthMonitor اکنون از SSL پشتیبانی می‌کند
    ‫HealthMonitor که به ترازکننده بار اختصاص داده شده است اکنون از SSL پشتیبانی می‌کند. برای اطلاعات بیشتر، توزیع بار در سرورهای پشتیبان را ببینید.
  • نصب‌کننده «درآمدزایی Edge» اکنون از نصب بی‌صدا پشتیبانی می‌کند
    «درآمدزایی» اکنون از نصب بی‌صدا یا بدون حضور پشتیبانی می‌کند. برای اطلاعات بیشتر، راهنمای نصب و پیکربندی Edge را ببینید.
  • فشرده‌سازی gzip در پاسخ‌های میانای برنامه‌سازی کاربردیMGMT-1127
    تماس با میانای برنامه‌سازی کاربردی مدیریت از فشرده‌سازی gzip در پاسخ‌هایی که «طول محتوا» آن‌ها حداقل ۱۰۲۴ بایت است پشتیبانی می‌کند. استفاده از:
    'Accept-Encoding: gzip, deflate'

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

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

موضوع شناسه مشکل شرح
بهره‌وری بالای حافظه CORERT-362 استفاده زیاد از حافظه به‌دلیل توقف دستورات پوسته‌ای بود که پیش‌از تکمیل فرایند توسط پردازشگرهای پیام راه‌اندازی می‌شدند. این مشکل برطرف شده است.
ایجاد پراکسی SOAP WSDL MGMT-1526 ایجاد پراکسی API مبتنی بر SOAP در واسط کاربر مدیریت باعث می‌شد مرورگر هنگ کند. این مشکل برطرف شده است.
برنامه توسعه‌دهنده با نقطه در نام MGMT-1236 در واسط کاربر مدیریت، اگر نام برنامه توسعه‌دهنده حاوی نقطه بود، برنامه نمی‌توانست به‌روزرسانی شود. این مشکل برطرف شده است.
افزایش CPU و تأخیر MP CORERT-384 هرگاه پاسخ‌های هدف حاوی سرایند «اتصال: بسته» بود، تأخیرهای پاسخ و CPU پردازشگر پیام افزایش می‌یافت. این مشکل برطرف شده است.
آمار درخواست و پاسخ HTTP CORERT-364 آمار مربوط به درخواست‌ها و پاسخ‌های اچ‌تی‌تی‌پی تجمعی نادرست بود. این مشکل برطرف شده است.
اجرای خط‌مشی سهمیه APIRT-909 خط‌مشی‌های سهمیه مبتنی بر تقویم به‌اشتباه تماس‌های «میانای برنامه‌سازی کاربردی» را که قبل‌از شروع دوره سهمیه برقرار شده بودند رد می‌کردند. این مشکل برطرف شده است.

این نسخهٔ پخش همچنین شامل رفع اشکال از نسخه‌های پخش زیر است. برای جزئیات، یادداشت‌های انتشار تکی را ببینید.

Edge Cloud Edge On-premises

مشکلات شناخته‌شده

این نسخه پخش مشکلات شناخته‌شده زیر را دارد.

موضوع شناسه مشکل شرح
ارتقای LDAP DOC-1262

هنگام ارتقا از نسخه ۴.۱۴.۰۷ به ۴.۱۵.۰۱ و ارتقا از ApacheDS به OpenLDAP، نام نقش‌هایی که حاوی فاصله هستند (مثل «فقط خواندنی») در OpenLDAP به‌درستی بازسازی نمی‌شوند.

قبل‌از ارتقا دادن، نقش‌هایی را که در نامشان فاصله دارند حذف کنید و دوباره بسازید.

اگر قبلاً ارتقا داده‌اید، فرمان زیر را برای حذف نقش‌های مشکل‌دار در OpenLDAP اجرا کنید:

ldapdelete -H ldap://localhost:10389 -D 'cn=manager,dc=apigee,dc=com' -r -W 'cn=<role>,ou=userroles,o=<org>,ou=organizations,dc=apigee,dc=com'

سپس نقش‌ها را بازآفرینی کنید.
خطای ایمیل SMTP OPDK-900 اگر خطای اعتبارسنجی ایمیل SMTP رخ داد، بررسی کنید که مقادیر ویژگی‌های زیر در apigee4/conf/ui/apigee.conf روی مقدار یکسانی تنظیم شده باشد: apigee.mgmt.mailFrom and mail.smtp.user. یا اعتبارسنجی ایمیل SMTP را غیرفعال کنید.
قبلی
4.15.01.01
بعدی
4.14.07.07