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

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

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

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

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

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

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

در ادامه ویژگی ها و پیشرفت های جدید در این نسخه آورده شده است.

OpenLDAP - نصب و ارتقاء

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

خدمات API

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

وب سوکت ها

برای فعال کردن ارتباطات بلادرنگ وب بین یک سرویس گیرنده وب و سرور، Edge از پروتکل WebSocket پشتیبانی می کند. Edge می تواند نقش مشتری یا سرور را در ارتباطات WebSocket ایفا کند. برای اطلاعات در مورد راه‌اندازی و استفاده از WebSockets در Edge، راهنمای Apigee Edge for Private Cloud Using WebSockets را ببینید.

پشتیبانی ارائه دهنده اعتبار خارجی برای مدیریت API

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

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

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

Node.js وارد Trace می شود

هنگام اشکال زدایی پراکسی های Node.js API، می توانید ویژگی 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 قفل شود.

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

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

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

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

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

متغیرهای خطای جدید 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 مراجعه کنید.

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

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

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

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

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

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

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

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

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

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

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

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

خدمات تجزیه و تحلیل

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

شش ماه داده در دسترس است

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

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

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

  • apigee.edge.execution.is_target_error - به شما امکان می دهد تشخیص دهید که آیا خطاهای API خطاهای سمت هدف هستند (مقدار "1") یا خطاهای غیر هدف برای پاسخ های ناموفق HTTP (مقدار "0"). مقدار برای یک پاسخ HTTP موفق تهی است.
  • apigee.edge.execution.is_policy_error - به شما امکان می دهد تشخیص دهید که آیا یک خط مشی شکست خورده است (مقدار "1") یا هیچ خط مشی در پاسخ ناموفق HTTP (مقدار "0") شکست خورده است. مقدار برای یک پاسخ HTTP موفق تهی است.
    متغیرهای مرتبط زیر جزئیات سیاستی را ارائه می دهند که ابتدا شکست خورد. اگر هیچ خط مشی شکست بخورد، مقادیر صفر هستند.
    • 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 نشان می دهد. به داشبورد تحلیل کد خطا مراجعه کنید.
  • این داشبوردهای موجود تغییر نام داده اند:
    • Endpoint Performance به Target Performance تغییر نام داد: الگوهای ترافیک و معیارهای عملکرد را برای اهداف باطن پروکسی API نشان می‌دهد. عملکرد هدف را ببینید.
    • Partner Engagement به Developer Engagement تغییر نام داد: به شما نشان می دهد که کدام یک از توسعه دهندگان برنامه ثبت شده شما بیشترین ترافیک API را ایجاد می کنند. برای هر یک از توسعه دهندگان خود، می توانید دریابید که چه کسی بیشترین ترافیک API و بیشترین خطا را ایجاد می کند. به تعامل با برنامه نویس مراجعه کنید.

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

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

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

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

کسب درآمد

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

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

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

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

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

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

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

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

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

Edge Cloud Edge برای Private Cloud

مسائل شناخته شده

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

شناسه شماره توضیحات
N/A

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

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

  • 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
CORERT-318 تماس‌های API با بارهای بزرگ (100 کیلوبایت) گاهی اوقات ممکن است قطع شوند. برای حل این مشکل، مقدار ویژگی زیر را در فایل router.properties خود تنظیم کنید:
HTTPServer.streaming.buffer.limit=0 (تنظیم پیش فرض 10 است)