4.15.04.00 - یادداشت‌های انتشار Apigee Edge برای Private Cloud

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

در روز سه‌شنبه، ۱۹ می ۲۰۱۵، ما نسخه سه‌ماهه Apigee Edge را برای فضای ابری خصوصی منتشر کردیم.

نام قبلی محصول «Apigee Edge On-premises» یا «OPDK» اکنون «Apigee Edge for Private Cloud» است.

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

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

ویژگی‌ها و پیشرفت‌های جدید

در ادامه به ویژگی‌ها و بهبودهای جدید این نسخه اشاره خواهیم کرد.

نصب و ارتقاء OpenLDAP

OpenLDAP اکنون تنها سرور LDAP است که توسط Edge برای نصب‌های جدید و ارتقا یافته پشتیبانی می‌شود.

خدمات API

در ادامه ویژگی‌ها و پیشرفت‌های جدید در سرویس‌های Edge API آمده است.

وب‌سوکت‌ها

برای فعال کردن ارتباطات وب در لحظه بین یک کلاینت وب و سرور، Edge از پروتکل WebSocket پشتیبانی می‌کند. Edge می‌تواند نقش کلاینت یا سرور را در ارتباطات WebSocket ایفا کند. برای اطلاعات بیشتر در مورد راه‌اندازی و استفاده از WebSockets در Edge، به راهنمای Apigee Edge برای ابر خصوصی با استفاده از WebSockets مراجعه کنید.

پشتیبانی از ارائه دهنده احراز هویت خارجی برای مدیریت API

Edge با Active Directory و سایر ارائه دهندگان احراز هویت خارجی/سیستم‌های LDAP که شامل کاربران مدیریتی API شما هستند، ادغام می‌شود. برای اطلاعات بیشتر، به راهنمای پیکربندی احراز هویت خارجی Edge برای Private Cloud مراجعه کنید.

برندسازی مشترک در رابط کاربری مدیریت

شما می‌توانید رابط کاربری مدیریت Edge را با لوگوی سفارشی خود که در کنار لوگوی Apigee ظاهر می‌شود، هماهنگ کنید. برای اطلاعات بیشتر، به «افزودن لوگوی سفارشی به منوی رابط کاربری Apigee» در راهنمای عملیات Apigee Edge برای ابر خصوصی مراجعه کنید.

لاگ‌های Node.js در Trace

هنگام اشکال‌زدایی پروکسی‌های API Node.js، می‌توانید ویژگی Node.js Log را در نمای Trace ویرایشگر پروکسی API فعال کنید. برای فعال کردن این ویژگی، apigee.feature.disableNodeJSLogs="false" را در فایل apigee-base.conf یا apigee-onpremise.conf در نصب خود تنظیم کنید. برای اطلاعات بیشتر در مورد Node.js Log، به اشکال‌زدایی و عیب‌یابی پروکسی‌های Node.js مراجعه کنید.

انقضای رمز عبور

در Edge 4.15.01.x، رمزهای عبور Edge به طور خودکار پس از 30 روز منقضی می‌شدند. این بدان معناست که کاربر قفل می‌شد مگر اینکه رمز عبور خود را قبل از انقضا تغییر می‌داد. با این حال، این امر باعث می‌شد رمز عبور مدیر سیستم نیز منقضی شود، به طوری که مدیر سیستم از Edge قفل می‌شد.

وقتی به نسخه ۴.۱۵.۰۴.۰۰ ارتقا می‌دهید، پیش‌فرض تغییر می‌کند تا رمزهای عبور منقضی نشوند. در صورت لزوم، می‌توانید با استفاده از اسکریپت /opt/apigee4/bin/apigee-enable-pwlockout.sh ، رمزهای عبور Edge را طوری پیکربندی کنید که منقضی شوند. برای اطلاعات بیشتر، به راهنمای عملیات Apigee Edge برای ابر خصوصی مراجعه کنید.

محدود کردن دسترسی مدیر سیستم به دامنه‌های ایمیل خاص

شما می‌توانید عضویت در نقش‌های sysadmin یا sysadmin فقط خواندنی را به کاربرانی در دامنه‌های ایمیل خاص محدود کنید. برای فعال کردن این ویژگی، دامنه‌های مجاز را به فایل apigee4/conf/apigee/management-server/security.properties اضافه کنید، همانطور که در راهنمای عملیات Apigee Edge برای ابر خصوصی توضیح داده شده است.

پیام‌های خطای رابط کاربری مدیریت

نمایش پیام خطا در رابط کاربری مدیریت، دوباره طراحی شده است تا از فضای صفحه نمایش به طور کارآمدتری استفاده شود.

متغیرهای خطای جدید OAuthV2

این متغیرهای جدید مرتبط با خطا توسط سیاست OAuthV2 تنظیم شده‌اند:

  • oauthV2.<policy-name>.failed - اگر سیاست شکست خورد، روی true تنظیم شود.
  • oauthv2.<policy_name>.<fault_name> - نام خطا. برای مثال، invalid_request
  • oauthv2.<policy_name>.<fault_cause> - دلیل خطا. برای مثال: توکن منقضی شده است

به http://apigee.com/docs/api-services/content/oauthv2-policy مراجعه کنید.

ایجاد محصول

هنگام ایجاد یک محصول جدید، اکنون می‌توانید علاوه بر نام نمایشی، نام محصول را نیز مشخص کنید.

به http://apigee.com/docs/developer-services/content/creating-api-products مراجعه کنید.

رابط کاربری برای حذف کاربران از یک سازمان

در صفحه کاربران سازمان در رابط کاربری، دکمه حذف با دکمه حذف جایگزین شده است. این کار برای روشن شدن این موضوع است که وقتی کاربری را از یک سازمان حذف می‌کنید، حساب کاربری Apigee آن کاربر همچنان فعال باقی می‌ماند.

به http://apigee.com/docs/api-services/content/managing-organization-users مراجعه کنید.

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

در صفحات پروکسی‌های API، محصولات، توسعه‌دهندگان و برنامه‌ها در رابط کاربری مدیریت، گزینه‌های فیلتر جدیدی برای جستجو در دسترس هستند.

ابزار ردیابی آفلاین

ابزار ردیابی آفلاین به شما امکان می‌دهد جلسات ردیابی که قبلاً ذخیره شده‌اند را مشاهده و تجزیه و تحلیل کنید. یک جلسه ردیابی ذخیره شده اساساً "ضبط" یک جلسه ردیابی است و می‌تواند برای مواردی که عیب‌یابی و تجزیه و تحلیل بیشتر مورد نیاز است، مفید باشد. رابط کاربری ابزار ردیابی آفلاین مشابه ابزار ردیابی "زنده" است.

برای اطلاعات بیشتر، به استفاده از ابزار ردیابی آفلاین مراجعه کنید.

نقش‌های کاربری نمایش داده شده در تنظیمات کاربر

در صفحه تنظیمات کاربر در رابط کاربری مدیریت (نام کاربری > تنظیمات کاربر)، نقش‌های کاربر اکنون نمایش داده می‌شوند.

بهبودهای رابط کاربری مدیریت لبه

این نسخه شامل تعدادی بهبود کوچک در قابلیت استفاده و ثبات در رابط کاربری مدیریت Edge است.

خدمات تحلیلی

در ادامه ویژگی‌ها و پیشرفت‌های جدید در سرویس‌های Edge Analytics آمده است.

شش ماه داده موجود است

هنگام تولید گزارش‌های تحلیلی با رابط کاربری یا API مدیریت، داده‌های قدیمی‌تر از شش ماه از تاریخ فعلی به طور پیش‌فرض قابل دسترسی نیستند. اگر می‌خواهید به داده‌های قدیمی‌تر از شش ماه دسترسی داشته باشید، با پشتیبانی Apigee Edge تماس بگیرید.

متغیرهای اضافه شده به تجزیه و تحلیل

متغیرهای جدید زیر به Edge analytics منتقل می‌شوند که در مرحله AX از پنجره ردیابی پروکسی API قابل مشاهده هستند.

  • apigee.edge.execution.is_target_error - به شما امکان می‌دهد تشخیص دهید که آیا خطاهای API، خطاهای سمت هدف (مقدار "1") هستند یا خطاهای غیر هدف برای پاسخ‌های ناموفق HTTP (مقدار "0"). برای پاسخ موفق HTTP، مقدار null است.
  • apigee.edge.execution.is_policy_error - به شما امکان می‌دهد در یک پاسخ HTTP ناموفق (مقدار "1") یا عدم موفقیت هیچ سیاستی (مقدار "0") را شناسایی کنید. برای یک پاسخ HTTP موفق، مقدار null است.
    متغیرهای مرتبط زیر جزئیاتی از سیاستی که ابتدا شکست خورده است را ارائه می‌دهند. اگر هیچ سیاستی شکست نخورد، مقادیر تهی هستند.
    • apigee.edge.execution.fault_policy_name - نام سیاستی که با شکست مواجه شد.
    • apigee.edge.execution.fault_flow_name - نام جریان در سیاستی که با شکست مواجه شده است (مانند PreFlow، PostFlow یا یک جریان تعریف شده توسط کاربر).
    • apigee.edge.execution.fault_flow_state - مکانی که پالیسی در جریان پیوست شده است. مقادیر ممکن: PROXY_REQ_FLOW، TARGET_REQ_FLOW، TARGET_RESP_FLOW، PROXY_RESP_FLOW.

داشبوردها

  • نمودارهای عملکرد برای APIها، توسعه‌دهندگان، محصولات و برنامه‌های توسعه‌دهندگان جابجا شده‌اند. قبلاً این نمودارها در پایین صفحات اصلی این موجودیت‌ها نشان داده می‌شدند. اکنون، با انتخاب برگه Analytics در بالای هر صفحه، به نمودارها دسترسی پیدا می‌کنید.
  • این نسخه شامل کارهای عمده‌ای روی داشبوردهای موجود یا جدید است:
    • داشبورد Apigee (اصلاح‌شده): شامل سه نمودار معیار است: ترافیک پروکسی، مشارکت توسعه‌دهندگان و برنامه‌های توسعه‌دهندگان. هر نمودار یک نمای «جزئیات بیشتر» ارائه می‌دهد که به شما امکان می‌دهد هر معیار را به‌طور دقیق بررسی کنید. به داشبورد Apigee مراجعه کنید.
    • عملکرد پروکسی (جدید): الگوهای ترافیک پروکسی API و زمان پردازش را نشان می‌دهد. جایگزین داشبورد عملکرد پروکسی API می‌شود. به عملکرد پروکسی API مراجعه کنید.
    • ترکیب ترافیک (اصلاح‌شده): ظاهر، حس و محتوای داشبورد به‌طور کامل اصلاح‌شده. سهم نسبی APIها، برنامه‌ها، توسعه‌دهندگان و محصولات برتر شما را در کل برنامه API شما اندازه‌گیری می‌کند. به ترکیب ترافیک مراجعه کنید.
    • تحلیل خطا (اصلاح‌شده): ظاهر، حس و محتوا به‌طور کامل اصلاح‌شده. نرخ خطا را برای پروکسی‌ها و اهداف API نشان می‌دهد. به داشبورد تحلیل کد خطا مراجعه کنید.
  • این داشبوردهای موجود تغییر نام داده‌اند:
    • عملکرد نقطه پایانی به عملکرد هدف تغییر نام داد: الگوهای ترافیک و معیارهای عملکرد را برای اهداف پروکسی API backend نشان می‌دهد. به عملکرد هدف مراجعه کنید.
    • «مشارکت شرکا» به «مشارکت توسعه‌دهندگان» تغییر نام داد: به شما نشان می‌دهد کدام یک از توسعه‌دهندگان ثبت‌شده‌ی برنامه‌ی شما بیشترین ترافیک API را ایجاد می‌کنند. برای هر یک از توسعه‌دهندگانتان، می‌توانید بفهمید چه کسی بیشترین ترافیک API و بیشترین خطا را ایجاد می‌کند. به «مشارکت توسعه‌دهندگان» مراجعه کنید.

خدمات توسعه‌دهندگان

در ادامه ویژگی‌ها و بهبودهای جدید در خدمات توسعه‌دهندگان Edge آمده است.

پشتیبانی Swagger 2.0 برای SmartDocs

SmartDocs از وارد کردن اسناد مشخصات Swagger 2.0 پشتیبانی می‌کند و سازگاری معکوس با Swagger 1.2 را حفظ می‌کند. پشتیبانی از اشیاء طرح امنیتی و طرح‌های متمرکز در نسخه بعدی در دسترس خواهد بود.

کسب درآمد

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

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

اکنون شرکت‌ها و توسعه‌دهندگان به‌طور جداگانه مدیریت می‌شوند که انعطاف‌پذیری بیشتری را در افزودن چندین شرکت به توسعه‌دهندگان و چندین توسعه‌دهنده به شرکت‌ها فراهم می‌کند. رابط کاربری مدیریت اکنون پنجره‌های جداگانه‌ای برای «شرکت‌ها» و «توسعه‌دهندگان» ارائه می‌دهد (که از منوی «انتشار» قابل دسترسی هستند).

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

در گزارش‌های کسب درآمد، شرکت‌ها همچنان فیلتر اصلی هستند، اگرچه برچسب فیلتر از «توسعه‌دهندگان» به «شرکت‌ها» تغییر کرده است.

اشکالات برطرف شد

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

شناسه مسئله توضیحات
OPDK-954 ۴.۱۵.۰۱ طرح کاساندرا ارتقا نیافته است
MGMT-1986 خطای رابط کاربری هنگام اضافه کردن توسعه‌دهنده
MGMT-1983 دریافت کد مجوز OAuth 2.0، API وضعیت اشتباه را برمی‌گرداند
MGMT-1962 خطا در ورود به رابط کاربری مدیریت با رمز عبور قوی
ورود به رابط کاربری با کاراکترهای خاص، مانند علامت درصد، دیگر با خطا مواجه نمی‌شود.
MGMT-1894 صفحه برنامه‌های توسعه‌دهنده هرگز بارگذاری ستون توسعه‌دهنده را تمام نمی‌کند
MGMT-1872 عدم امکان دانلود گزارش‌های سفارشی
MGMT-1777 نمی‌توان کاربری با آدرس ایمیلی که TLD آن ‎.acn‎ است اضافه کرد
MGMT-1362 اگر آدرس ایمیل شامل '_' باشد، ایمیل فراموشی رمز عبور کار نمی‌کند.
مشکل تنظیم مجدد رمز عبور در Private Cloud با آدرس‌های ایمیل حاوی زیرخط (_) برطرف شد.
کوررت-613 عدم موفقیت در برقراری ارتباط SSL به دلیل "unrecognized_name"
APIRT-1346 OAuth2.0 - مقدار هش شده در پاسخ توکن دسترسی زمانی برگردانده می‌شود که hash.oauth.tokens.enabled برابر با true باشد.

این نسخه همچنین شامل رفع اشکالات نسخه‌های زیر است:

ابر لبه لبه برای ابر خصوصی

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

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

شناسه مسئله توضیحات
ناموجود

دو اسکریپت کاساندرا، که نصب‌کننده در نصب یا ارتقاء کسب درآمد از آنها استفاده می‌کند، در این نسخه گنجانده نشده‌اند.

برای حل این مشکل، پس از نصب یا ارتقاء کاساندرا، دستورات زیر را اجرا کنید تا نصب/ارتقاء کسب درآمد تکمیل شود:

  • apigee4/share/apache-cassandra/bin/cassandra-cli -h {host} -f apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/360-company-developers.txt
  • apigee4/share/apache-cassandra/bin/cassandra-cli -h {host} -f apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/320-update-notification-service_item.txt
کوررت-۳۱۸ فراخوانی‌های API با حجم بالای داده (صدها کیلوبایت) گاهی اوقات می‌توانند متوقف شوند. برای حل این مشکل، مقدار ویژگی زیر را در فایل router.properties خود تنظیم کنید:
HTTPServer.streaming.buffer.limit=0 (تنظیم پیش‌فرض ۱۰ است)