درحال مشاهده اسناد Apigee Edge هستید.
به
اسناد Apigee X بروید. اطلاعات
روز سه‌شنبه، ۱۹ مه ۲۰۱۵، نسخه فصلی Apigee Edge for Private Cloud را منتشر کردیم.
نام محصول قبلی «Apigee Edge On-premises» یا «OPDK» اکنون «Apigee Edge for Private Cloud» است.
اگر سؤالی دارید، با پشتیبانی Apigee Edge تماس بگیرید.
برای مشاهده فهرستی از همه یادداشت‌های انتشار Apigee Edge، به یادداشت‌های انتشار Apigee مراجعه کنید.
ویژگی‌های جدید و بهبودها
در این نسخه پخش، ویژگی‌های جدید و موارد بهبودیافته زیر ارائه شده است.
OpenLDAP - نصب و ارتقا
اکنون OpenLDAP تنها سرور LDAP است که Edge برای نصب‌های جدید و ارتقا پشتیبانی می‌کند.
سرویس‌های API
در زیر ویژگی‌های جدید و بهبودهای «سرویس‌های Edge API» آورده شده است.
WebSockets
برای فعال کردن ارتباطات وب بی‌درنگ بین کارخواه وب و سرور، Edge از پروتکل WebSocket پشتیبانی می‌کند. Edge می‌تواند در ارتباطات WebSocket نقش کارخواه یا سرور را ایفا کند. برای اطلاعات درباره راه‌اندازی و استفاده از WebSockets در Edge، راهنمای Apigee Edge for Private Cloud Using WebSockets را ببینید.
پشتیبانی از ارائه‌دهنده احراز هویت خارجی برای مدیریت میانای برنامه‌سازی کاربردی
Edge با Active Directory و دیگر ارائه‌دهندگان اصالت‌سنجی خارجی/سیستم‌های LDAP که شامل کاربران سرپرست API شما هستند ادغام می‌شود. برای اطلاعات بیشتر، راهنمای پیکربندی اصالت‌سنجی خارجی Edge for Private Cloud را ببینید.
نمانام‌سازی مشترک در واسط کاربر مدیریت
می‌توانید واسط کاربر مدیریت Edge را با نمانام مشترک و با نشان‌واره سفارشی خودتان نمانام‌گذاری کنید. نشان‌واره سفارشی شما در کنار نشان‌واره Apigee نمایش داده می‌شود. برای اطلاعات بیشتر، به «افزودن نشان‌واره سفارشی به منو «میانای کاربری Apigee»» در راهنمای عملیات Apigee Edge برای «ابر خصوصی» مراجعه کنید.
گزارش‌های Node.js در Trace
هنگام اشکال‌زدایی کردن پراکسی‌های API در Node.js، می‌توانید ویژگی «گزارمان Node.js» را در نمای «پیگیری» ویرایشگر پراکسی API فعال کنید. برای فعال کردن این ویژگی،
apigee.feature.disableNodeJSLogs="false" را در فایل apigee-base.conf یا
apigee-onpremise.conf در نصب خود تنظیم کنید. برای اطلاعات بیشتر درباره «گزارش Node.js»، به
عیب‌یابی و رفع مشکل
پراکسی‌های Node.js مراجعه کنید.
انقضای گذرواژه
در Edge نسخه 4.15.01.x، گذرواژه‌های Edge به‌طور خودکار پس‌از ۳۰ روز منقضی می‌شدند. این یعنی کاربر قفل می‌شد، مگر اینکه گذرواژه‌اش را قبل‌از منقضی شدن تغییر می‌داد. بااین‌حال، این کار باعث شد گذرواژه سرپرست سیستم منقضی شود و سرپرست سیستم از Edge محروم شود.
وقتی به نسخه 4.15.04.00 ارتقا دهید، پیش‌فرض تغییر می‌کند و گذرواژه‌ها منقضی نمی‌شوند. درصورت
نیاز، می‌توانید گذرواژه‌های Edge را بااستفاده از
برنامه /opt/apigee4/bin/apigee-enable-pwlockout.sh پیکربندی کنید تا منقضی شوند. برای اطلاعات بیشتر،
راهنمای عملیات Apigee Edge برای «ابر خصوصی» را ببینید.
محدود کردن دسترسی سرپرست سیستم به دامنه‌های ایمیل خاص
می‌توانید عضویت در نقش‌های sysadmin یا sysadmin فقط خواندنی را به کاربران در دامنه‌های ایمیل خاص محدود کنید. برای فعال کردن این ویژگی، دامنه‌های مجاز را به فایل apigee4/conf/apigee/management-server/security.properties اضافه کنید، همان‌طور که در راهنمای عملیات Apigee Edge برای «ابر خصوصی» توضیح داده شده است.
پیام‌های خطای میانای کاربر مدیریت
نمایش پیام خطا در «میانای کاربر» مدیریت مجدداً طراحی شده است تا از فضای صفحه به‌طور کارآمدتری استفاده شود.
متغیرهای خطای OAuthV2 جدید
این متغیرهای جدید مرتبط با خطا توسط خط‌مشی OAuthV2 تنظیم می‌شوند:
- oauthV2.<policy-name>.failed - اگر خط‌مشی ناموفق بود روی درست تنظیم کنید.
- 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 است.
خدمات Analytics
در زیر ویژگی‌های جدید و بهبودها در «سرویس‌های تجزیه‌وتحلیل لبه‌ای» آورده شده است.
داده‌های شش ماه دردسترس است
هنگام تولید گزارش‌های تجزیه‌وتحلیل با رابط کاربری مدیریت یا API، داده‌های قدیمی‌تر از شش ماه از تاریخ فعلی به‌طور پیش‌فرض قابل‌دسترسی نیستند. اگر می‌خواهید به داده‌های قدیمی‌تر از شش ماه دسترسی داشته باشید، با پشتیبانی Apigee Edge تماس بگیرید.
متغیرها به تجزیه‌وتحلیل‌ها اضافه شد
متغیرهای جدید زیر به تجزیه‌وتحلیل Edge منتقل می‌شوند و در مرحله AX پنجره ردیابی پراکسی API قابل‌مشاهده هستند.
- apigee.edge.execution.is_target_error - به شما امکان می‌دهد مشخص کنید آیا خطاهای API خطاهای سمت هدف هستند (مقدار «۱») یا خطاهای غیرهدف برای پاسخ‌های ناموفق HTTP (مقدار «۰»). مقدار برای پاسخ HTTP موفق تهی است.
-
apigee.edge.execution.is_policy_error - به شما امکان می‌دهد تشخیص دهید که آیا خط‌مشی
ناموفق بوده است (مقدار «۱») یا هیچ خط‌مشی‌ای در پاسخ HTTP ناموفق ناموفق نبوده است (مقدار «۰»). مقدار برای پاسخ 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.
داشبوردها
- نمودارهای عملکرد برای «میاناهای برنامه‌سازی کاربردی»، «توسعه‌دهندگان»، «محصولات»، و «برنامه‌های توسعه‌دهنده» منتقل شده است. از آن‌ها برای نمایش در پایین صفحات اصلی این نهادها استفاده می‌شد. اکنون با انتخاب برگه Analytics در بالای هر صفحه به نمودارها دسترسی پیدا می‌کنید.
- این نسخه شامل کار عمده روی این داشبوردهای موجود یا جدید است:
- داشبورد Apigee (اصلاح‌شده): شامل سه نمودار سنجه است: ترافیک پراکسی، مشارکت توسعه‌دهنده، و برنامه‌های توسعه‌دهنده. هر نمودار نمای «جزئیات بیشتر» را ارائه می‌دهد که به شما امکان می‌دهد در هر سنجه‌ای دقیق شوید. داشبورد Apigee را ببینید.
- عملکرد پراکسی (جدید): الگوهای ترافیک پراکسی API و زمان‌های پردازش را نشان می‌دهد. جایگزین داشبورد «عملکرد پراکسی API» می‌شود. عملکرد پراکسی میانای برنامه‌سازی کاربردی را ببینید.
- ترکیب ترافیک (اصلاح‌شده): ظاهر و احساس داشبورد و محتوا به‌طور کامل اصلاح شده است. سهم نسبی میاناهای برنامه‌سازی کاربردی، برنامه‌ها، توسعه‌دهندگان، و محصولات برتر شما را در برنامه کلی میانای برنامه‌سازی کاربردی شما اندازه‌گیری می‌کند. ترکیب ترافیک را ببینید.
- تجزیه‌وتحلیل خطا (اصلاح‌شده): ظاهر و احساس و محتوای کاملاً اصلاح‌شده. نرخ‌های خطا را برای پراکسی‌های API و هدف‌ها نشان می‌دهد. داشبورد «تجزیه‌وتحلیل کد خطا» را ببینید.
-
نام این داشبوردهای موجود تغییر کرده است:
- نام عملکرد نقطه پایانی به عملکرد هدف تغییر کرد: الگوهای ترافیک و سنجه‌های عملکرد را برای هدف‌های پشتیبان پراکسی API نشان می‌دهد. عملکرد هدف را ببینید.
- نام تعامل شریک به تعامل توسعه‌دهنده تغییر کرد: نشان می‌دهد کدام‌یک از توسعه‌دهندگان نرم‌افزار ثبت‌شده شما بیشترین ترافیک میانای برنامه‌سازی کاربردی را تولید می‌کنند. برای هریک از توسعه‌دهندگان خود، می‌توانید متوجه شوید که چه کسی بیشترین ترافیک API و بیشترین خطاها را تولید می‌کند. تعامل توسعه‌دهنده را ببینید.
سرویس‌های توسعه‌دهندگان
در زیر ویژگی‌ها و بهبودهای جدید در «سرویس‌های توسعه‌دهنده Edge» آورده شده است.
پشتیبانی از Swagger 2.0 برای SmartDocs
SmartDocs از وارد کردن اسناد مشخصات Swagger 2.0 پشتیبانی می‌کند و سازگاری با Swagger 1.2 را حفظ می‌کند. پشتیبانی از اشیای طرح امنیتی و طرحواره‌های متمرکز در نسخه پخش بعدی دردسترس خواهد بود.
درآمدزایی
در زیر ویژگی‌های جدید و بهبودهای درآمدزایی Edge آورده شده است. همچنین برای اطلاعات بیشتر درباره درآمدزایی، بخش «مشکلات شناخته‌شده» را ببینید.
رسیدگی جداگانه به «شرکت‌ها» و «توسعه‌دهندگان»
اکنون شرکت‌ها و توسعه‌دهندگان به‌صورت جداگانه مدیریت می‌شوند که این امر انعطاف‌پذیری بیشتری در افزودن چندین شرکت به توسعه‌دهندگان و چندین توسعه‌دهنده به شرکت‌ها فراهم می‌کند. «میانای کاربر مدیریت» اکنون پنجره‌های جداگانه‌ای برای «شرکت‌ها» و «توسعه‌دهندگان» ارائه می‌دهد (از منو «انتشار» قابل‌دسترس است).
مدیریت شرکت‌ها و توسعه‌دهندگان را ببینید.
در گزارش‌های درآمدزایی، شرکت‌ها همچنان فیلتر اصلی باقی می‌مانند، اگرچه برچسب فیلتر از «توسعه‌دهندگان» به «شرکت‌ها» تغییر کرده است.
اشکالات رفع شد
اشکالات زیر در این نسخه پخش برطرف شده است.
| شناسه مشکل | شرح |
|---|---|
| OPDK-954 | طرحواره Cassandra نسخه ۴.۱۵.۰۱ ارتقا نیافته است |
| MGMT-1986 | خطای میانای کاربر هنگام افزودن توسعه‌دهنده |
| MGMT-1983 | دریافت کد مجوز OAuth 2.0 API وضعیت اشتباهی برمی‌گرداند |
| MGMT-1962 | خطا در ورود به سیستم واسط کاربر مدیریت با گذرواژه قوی ورود به سیستم واسط کاربر با نویسه‌های خاص معین، مثل علامت درصد، دیگر با خطا مواجه نمی‌شود. |
| MGMT-1894 | صفحه «برنامه‌های توسعه‌دهنده» برای ستون توسعه‌دهنده هرگز بارگیری نمی‌شود |
| MGMT-1872 | عدم امکان بارگیری گزارش‌های سفارشی |
| MGMT-1777 | نمی‌توان کاربر را با نشانی ایمیلی که دارای دامنه سطح بالای acn .است اضافه کرد |
| MGMT-1362 | اگر «نشانی ایمیل» حاوی
«_» باشد، ایمیل «گذرواژه را فراموش کرده‌ام» کار نمی‌کند مشکل بازنشانی گذرواژه در «ابر خصوصی» با نشانی‌های ایمیل حاوی خط زیر را برطرف می‌کند. |
| CORERT-613 | خطاهای دست‌دهی SSL به‌دلیل «unrecognized_name» |
| APIRT-1346 | OAuth2.0 - وقتی hash.oauth.tokens.enabled درست باشد، مقدار درهم‌سازی‌شده در پاسخ کد دسترسی برگردانده می‌شود |
این نسخهٔ پخش همچنین شامل رفع اشکال از نسخه‌های پخش زیر است:
| Edge Cloud | Edge برای فضای ابری خصوصی |
|---|---|
مشکلات شناخته‌شده
این نسخه پخش مشکلات شناخته‌شده زیر را دارد.
| شناسه مشکل | شرح |
|---|---|
| موجود نیست |
دو دستورگان Cassandra که نصب‌کننده در نصب یا ارتقا درآمدزایی از آن‌ها استفاده می‌کند در نسخه پخش گنجانده نشده است. برای دور زدن این مشکل، پس‌از نصب یا ارتقای Cassandra، فرمان‌های زیر را اجرا کنید تا نصب/ارتقای درآمدزایی تکمیل شود:
|
| CORERT-318 | فراخوانی‌های API با بار مفید بزرگ (صدها کیلوبایت) گاهی‌اوقات ممکن است معلق شوند. برای دور زدن این مشکل، مقدار ویژگی زیر را در فایل router.properties تنظیم کنید:HTTPServer.streaming.buffer.limit=0 (تنظیم پیش‌فرض ۱۰ است) |