4.17.01 - Edge for Private Cloud یادداشت های انتشار

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

در روز چهارشنبه، 25 ژانویه 2017، نسخه جدیدی از Apigee Edge را برای Private Cloud منتشر کردیم.

از زمان انتشار قبلی Edge برای Private Cloud Feature Release، نسخه‌های زیر رخ داده است و در این ویژگی گنجانده شده است:

• Cloud: 16.08.24.01 (UI) , 16.10.05 (UI) , 16.09.21 , 16.09.21_9 , 16.10.26 (UI)

برای درک اینکه چگونه می توانید بفهمید که آیا نسخه ابری خاصی در نسخه Edge برای Private Cloud شما گنجانده شده است، به «درباره شماره گذاری نسخه» مراجعه کنید.

نمای کلی انتشار

این نسخه شامل تعدادی ویژگی قابل توجه است که به شما کمک می کند API های خود را بهتر کنترل و ایمن کنید.

جریان‌های مشترک و قلاب‌های جریان به شما امکان می‌دهند مجموعه‌ای از خط‌مشی‌ها و رفتارهای قابل استفاده مجدد را در چندین پراکسی API ایجاد کنید.

نقشه‌های ارزش کلیدی (KVM) که قبلاً یک ویژگی Edge برای تداوم طولانی‌مدت جفت‌های کلید-مقدار بودند، اکنون می‌توانند برای امنیت داده‌های قوی‌تر رمزگذاری شوند.

برای کنترل انعطاف‌پذیرتر بر دسترسی توسعه‌دهندگان به API‌های شما، رابط کاربری مدیریت Edge گزینه‌های بیشتری را برای ایجاد و مدیریت کلیدها و اسرار API (مدارک اعتباری)، لغو برنامه‌های توسعه‌دهنده و غیرفعال کردن توسعه‌دهندگان فراهم می‌کند. این پیشرفت‌ها به شما امکان می‌دهند تا استراتژی‌هایی مانند چرخش کلید API را آسان‌تر پیاده‌سازی کنید و با لغو یک برنامه توسعه‌دهنده (همه کلیدهای آن غیرفعال هستند) یا غیرفعال کردن یک برنامه‌نویس (همه برنامه‌ها و کلیدهای توسعه‌دهنده غیرفعال هستند)، چندین کلید API را غیرفعال کنید.

در بخش منسوخ شدن، ویژگی محدودیت‌های درآمدزایی بازنشسته شد.

باقی‌مانده این مبحث شامل جزئیات مربوط به تمام ویژگی‌های جدید، به‌روزرسانی‌ها و رفع اشکالات موجود در نسخه است.

محرومیت ها و بازنشستگی ها

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

بازنشسته شده: محدودیت‌های کسب درآمد (Cloud 16.10.26 UI)

ویژگی محدودیت های کسب درآمد از رابط کاربری مدیریت حذف شده است ( Admin > Limits ). برای جزئیات بیشتر، از جمله موارد استفاده به جای آن، به اطلاعیه انحلال مراجعه کنید: http://docs.apigee.com/monetization/content/limit-feature-deprecation-notice . (DEVRT-3259)

پشتیبانی از RedHat/CentOS نسخه 6.5 حذف شد

اگر در حال حاضر از RedHat/CentOS نسخه 6.5 استفاده می کنید، باید سیستم عامل خود را قبل از به روز رسانی به Edge 4.17.01 به نسخه 6.6 یا بالاتر به روز کنید.

ویژگی ها و به روز رسانی های جدید

در ادامه ویژگی ها و پیشرفت های جدید در این نسخه آورده شده است. علاوه بر پیشرفت‌های زیر، این نسخه همچنین دارای چندین بهبود قابلیت استفاده، عملکرد، امنیت و ثبات است.

برای جزئیات و دستورالعمل‌های بیشتر، به مستندات Edge for Private Cloud مراجعه کنید.

ابر خصوصی

اکنون می توانید یک بنر رضایت را در رابط کاربری Edge نمایش دهید

هنگامی که کاربر برای اولین بار به رابط کاربری Edge دسترسی پیدا می کند، می توانید یک بنر رضایت را نمایش دهید. بنر رضایت متنی با قالب HTML و دکمه ای را نمایش می دهد که کاربر برای رفتن به صفحه ورود به سیستم انتخاب می کند. برای اطلاعات بیشتر به فعال کردن بنر رضایت مراجعه کنید.

API BaaS از چندین مرکز داده پشتیبانی می کند

اکنون می توانید API BaaS را در چندین مرکز داده نصب کنید. برای اطلاعات بیشتر به نصب چند مرکز داده برای API BaaS مراجعه کنید.

پارامترهای پیکربندی نصب API BaaS جدید

دو پارامتر پیکربندی جدید به فایل پیکربندی API BaaS اضافه شده است:

• BAAS_CASS_DC_LIST - نام منطقه مراکز داده BaaS را مشخص می کند. برای یک مرکز داده، همان مقدار BAAS_CASS_LOCALDC را مشخص کنید.
• BAAS_CLUSTER_SEEDS - گره های پشته BaaS را که برای تعریف دانه های خوشه BaaS استفاده می شوند، مشخص می کند.

برای اطلاعات بیشتر به آپدیت Apigee Edge 4.16.09 تا 4.17.01 مراجعه کنید.

دیگر گزینه "deploy" را با دستور apigee-service برای API BaaS اجرا نکنید

گزینه Deploy برای دستور apigee-service دیگر برای API BaaS Stack و Portal پشتیبانی نمی شود. در عوض، از گزینه های پیکربندی و راه اندازی مجدد استفاده می کنید. برای اطلاعات بیشتر به نصب API BaaS مراجعه کنید.

مورد نیاز پورت جدید برای API BaaS

همه گره های پشته BaaS اکنون باید پورت 2551 را برای دسترسی از سایر گره های پشته باز کنند. اگر چندین مرکز داده BaaS دارید، پورت باید از تمام گره‌های پشته در همه مراکز داده قابل دسترسی باشد.

برای اطلاعات بیشتر به نصب API BaaS و الزامات نصب مراجعه کنید.

پورتال Developer Services اکنون از Postgres به عنوان پایگاه داده و Nginx به عنوان وب سرور خود استفاده می کند

برای تمام نصب های جدید، پورتال از Postgres به عنوان پایگاه داده خود به جای MySQL و MariaDB استفاده می کند. مشتریانی که از نسخه قبلی به 4.17.01 ارتقاء می دهند همچنان از MySQL یا MariaDB استفاده می کنند.

نصب های جدید برای 4.17.01 نیز Nginx را به عنوان وب سرور نصب می کنند. مشتریانی که از نسخه قبلی به 4.17.01 ارتقاء می دهند همچنان از آپاچی استفاده می کنند.

پورتال Developer Services دیگر SmartDocs را به طور پیش فرض فعال نمی کند

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

پورتال Developer Services اکنون از RPM نصب شده است

نسخه 4.17.01 پورتال Developer Services از RPM با استفاده از مخزن و ابزار مشابه Edge و API BaaS نصب می شود. برای اطلاعات بیشتر به نصب پورتال خدمات توسعه دهنده مراجعه کنید.

نصب مبتنی بر RPM و به‌روزرسانی‌کننده مبتنی بر tar از اجزای مختلفی استفاده می‌کنند:

Qpid به نسخه 1.35 ارتقا یافت

این نسخه شامل Qpid نسخه 1.35 است.

کاساندرا به نسخه 2.1.16 ارتقا یافت

این نسخه شامل Cassandra نسخه 2.1.16 است.

بازی به نسخه 2.4 ارتقا یافته است

این نسخه شامل چارچوب Play 2.4 UI است.

پشتیبانی از RedHat/CentOS نسخه 7.3 اضافه شد

Edge اکنون از RedHat/CentOS نسخه 7.3 پشتیبانی می کند.

به‌روزرسانی‌های داشبورد مانیتورینگ بتا

نسخه بتا داشبورد مانیتورینگ Edge به‌روزرسانی شده است:

• داشبوردهای جدیدی را برای Cassandra، Zookeeper، OpenLDAP، Postgres و Qpid قرار دهید.
• نسخه Influx در 4.16.09 از 0.11 به 1.0.2 ارتقا یافته است.
• تعدادی اصلاحات پایداری اضافه شده است.

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

اکنون می توانید رمز عبور Postgres را در فایل پیکربندی نصب تنظیم کنید

از ویژگی PG_PWD برای تنظیم رمز عبور Postgres در فایل پیکربندی نصب استفاده کنید. برای اطلاعات بیشتر به مرجع فایل پیکربندی لبه مراجعه کنید.

EPEL repo را فعال کنید

برای نصب یا به‌روزرسانی Edge باید بسته‌های اضافی برای لینوکس سازمانی (یا EPEL) را فعال کنید. برای اطلاعات بیشتر به الزامات نصب مراجعه کنید.

دستوری که استفاده می کنید به نسخه RedHat/CentOS شما بستگی دارد:

• برای RedHat/CentOS 7.x:
  > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm؛ rpm -ivh epel-release-latest-7.noarch.rpm
• برای RedHat/CentOS 6.x:
  wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

غیرفعال کردن جستجوی DNS در IPv6 هنگام استفاده از NSCD (Name Service Cache Daemon)

اگر NSCD (Name Service Cache Daemon) را نصب و فعال کرده باشید، Message Processors دو جستجوی DNS را انجام می دهد: یکی برای IPv4 و دیگری برای IPv6. هنگام استفاده از NSCD باید جستجوی DNS را در IPv6 غیرفعال کنید. برای اطلاعات بیشتر به الزامات نصب مراجعه کنید.

برای غیرفعال کردن جستجوی DNS در IPv6:

1. در هر گره پردازشگر پیام، /etc/nscd.conf را ویرایش کنید.
2. ویژگی زیر را تنظیم کنید:
   هاست های enable-cache no

خدمات API

جریان های مشترک و قلاب های جریان برای عملیاتی کردن پراکسی های API (Cloud 16.09.21)

ویژگی جدید "جریان های مشترک" به شما امکان می دهد عملکرد را در پراکسی های API عملیاتی کنید. با ترکیب خط مشی ها و منابع شرطی شده در یک جریان مشترک، می توانید آن را از هر پروکسی API برای اجرای منطق تک منبعی و قابل استفاده مجدد ارجاع دهید. به عنوان مثال، یک جریان مشترک ممکن است کلید API را تأیید کند، در برابر دستگیری اسپایک محافظت کند، و داده‌های ثبت نام را ثبت کند.

شما جریان های مشترک را در رابط کاربری مدیریت تعریف می کنید ( APIs > جریان های مشترک )، سپس به دو روش مختلف به آنها ارجاع می دهید:

• با یک خط مشی جدید Flow Callout در یک پراکسی API
  یا

• در یک مصنوع جدید به نام Flow Hooks که در مکان‌های زیر قرار دارند:

  این نقاط پیوست به شما امکان می دهند منطق عملیاتی را قبل یا بعد از نقاط جریان اصلی پراکسی مجزا اجرا کنید. جریان‌های مشترک را به این مکان‌های Flow Hook در رابط کاربری مدیریت اختصاص می‌دهید ( APIs > Environment Configuration > Flow Hooks ).

  • درخواست : قبل از ProxyEndpoint PreFlow، بعد از TargetEndpoint PostFlow
  • پاسخ : قبل از TargetEndpoint PreFlow، بعد از ProxyEndpoint PostFlow

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

نقشه های ارزش کلید رمزگذاری شده (Cloud 16.09.21)

شما می توانید نقشه های ارزش کلیدی رمزگذاری شده (KVM) را برای ذخیره اطلاعات حساس مانند اعتبارنامه ها یا داده های PII/HIPAA ایجاد کنید. این ویژگی با فروشگاه امن Edge (طاقچه) متفاوت است و به گونه ای طراحی شده است که جایگزین آن شود، زیرا مقادیر vault فقط با Node.js (علاوه بر API مدیریت) قابل دسترسی است. می توانید با Node.js یا خط مشی عملیات نقشه ارزش کلیدی به مقادیر KVM رمزگذاری شده دسترسی پیدا کنید.

ایجاد KVM های رمزگذاری شده

• از APIهای مدیریت KVM موجود استفاده کنید. هنگامی که هنگام ایجاد KVM “encrypted”: “true” را در تعریف محموله وارد می‌کنید، Edge یک کلید رمزگذاری ایجاد می‌کند که دامنه مشابهی با KVM دارد و KVM را با استفاده از آن کلید رمزگذاری می‌کند.
• شما نمی توانید از خط مشی عملیات نقشه ارزش کلیدی برای ایجاد KVM رمزگذاری شده استفاده کنید. قبل از استفاده از آن در خط مشی، باید یک KVM رمزگذاری شده با استفاده از APIهای مدیریت KVM ایجاد کنید.
• شما نمی توانید KVM رمزگذاری نشده موجود را رمزگذاری کنید.

استفاده از KVM های رمزگذاری شده

• از خط مشی عملیات نقشه ارزش کلیدی برای دریافت و به روز رسانی مقادیر KVM رمزگذاری شده استفاده کنید.
• هنگام دریافت یک مقدار کلید رمزگذاری شده، پیشوند متغیر را برای نگه داشتن مقدار با کلمه کلیدی "خصوصی" قرار دهید. به عنوان مثال: <Get assignTo="private.secretVar"> . آن متغیر private.secretVar مقدار رمزگشایی شده را نگه می دارد.
• هنگام به روز رسانی یک مقدار با خط مشی، نیازی به انجام کار خاصی ندارید. مقدار به طور خودکار در KVM های رمزگذاری شده رمزگذاری می شود.
• همچنین می توانید با استفاده از ماژول apigee-access در کد Node.js به مقدار رمزگشایی شده دسترسی پیدا کنید. از تابع getKeyValueMap() برای بازیابی KVM بر اساس نام و محدوده استفاده کنید. دو تابع در شیء برگشتی موجود است: getKeys(callback) برای دریافت آرایه ای از نام کلیدها و get(key, callback) برای دریافت مقدار یک کلید خاص. به عنوان مثال، کد زیر یک KVM با دامنه apiproxy به نام VerySecureKVM دریافت می کند و مقدار رمزگذاری شده key1 را بازیابی می کند:

  var apigee = require('apigee-access');
    var encryptedKVM = apigee.getKeyValueMap('VerySecureKVM', 'apiproxy'); 
    encryptedKVM.get('key1', function(err, secretValue) { 
    // use the secret value here 
  });
  

برای اطلاعات بیشتر، به کار با نقشه‌های ارزش کلیدی و دسترسی به نقشه‌های ارزش کلیدی در Node.js مراجعه کنید.

(APIRT-1197)

ایجاد نقشه های ارزش کلید رمزگذاری شده در UI (16.10.26 UI)

هنگام ایجاد یک نقشه ارزش کلید با محدوده محیطی (KVM) در UI مدیریت ( APIs > Environment Configuration > Key Value Maps )، یک چک باکس جدید رمزگذاری شده به شما امکان می دهد یک KVM رمزگذاری شده ایجاد کنید. پس از افزودن کلیدها به KVM، مقادیر رمزگذاری شده در رابط کاربری مدیریت به صورت ستاره (*****) ظاهر می شوند. شما کلیدها/مقادیر را دقیقاً به یک KVM رمزگذاری شده اضافه می کنید، همانطور که برای KVM های غیر رمزگذاری شده انجام می دهید. پشتیبانی کامل Backend برای KVM های رمزگذاری شده در نسخه ابری 160921 موجود بود. (EDGEUI-764)

نشانی‌های وب مشخصات OpenAPI موجود در ابرداده‌های پراکسی API (Cloud 16.09.21)

هنگامی که یک پروکسی API بر اساس مشخصات OpenAPI ایجاد می کنید، مکان مشخصات OpenAPI در فراداده پروکسی API ذخیره می شود. به عنوان مثال، اگر از API مدیریت برای دریافت جزئیات یک ویرایش پراکسی استفاده می‌کنید، ابرداده شامل مسیر مشخصات OpenAPI در قالب زیر می‌شود:

"spec" : "https://raw.githubusercontent.com/apigee/api-platform-samples/master/default-proxies/helloworld/openapi/mocktarget.yaml"

این ارتقاء از نسخه نسل بعدی Edge پشتیبانی می‌کند که مشخصات OpenAPI را به پراکسی‌های API، محصولات API و اسناد مرجع API در پورتال توسعه‌دهنده جدید پیوند می‌دهد. (MGMT-2913)

تولید OpenAPI Spec برای پراکسی های SOAP (واسطه کاربری Cloud 16.10.05)

هنگامی که یک پروکسی "REST to SOAP to REST" را بر اساس WSDL ایجاد می کنید، Edge به طور خودکار یک OpenAPI Spec میزبانی شده را بر اساس منابع پراکسی ایجاد می کند. می‌توانید در http(s)://[edge_domain]/[proxy_base_path]/openapi.json به مشخصات دسترسی داشته باشید. با این حال، تبدیل همیشه دقیق نیست، زیرا همه قوانین یک طرحواره XML را نمی توان در یک OpenAPI Spec نمایش داد. (EDGEUI-718)

WSDL میزبان لبه برای پراکسی‌های SOAP عبوری (واسطه کاربری Cloud 16.10.05)

هنگامی که یک پروکسی "Pass-Through SOAP" بر اساس WSDL ایجاد می کنید، Edge میزبان WSDL است و جریانی را در پروکسی ایجاد می کند تا به شما امکان دسترسی به آن را بدهد. می‌توانید به WSDL میزبانی‌شده در http(s)://[edge_domain]/[proxy_base_path]?wsdl دسترسی داشته باشید، که URL نقطه پایانی سرویس جدید برای مشتریانی است که از طریق پروکسی با سرویس SOAP تماس می‌گیرند. (EDGEUI-718)

نمونه جدید قیمت سهام WSDL در جادوگر پراکسی API (Cloud 16.08.24.01)

هنگام ایجاد یک API سرویس SOAP با جادوگر پراکسی API، یک قیمت سهام جایگزین WSDL در این مثال ها موجود است: https://ws.cdyne.com/delayedstockquote/delayedstockquote.asmx?WSDL. (EDGEUI-655)

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

حسن مدیریت برنامه توسعه‌دهنده در رابط کاربری (واسطه کاربری Cloud 16.10.05)

مدیریت برنامه‌های توسعه‌دهنده در رابط کاربری Edge با تعدادی از پیشرفت‌ها قدرتمندتر شده است:

• می‌توانید برنامه‌ها را (در حالت ویرایش) در فیلد «وضعیت برنامه» جدید لغو و تأیید کنید. در حالت نمایش، فیلد وضعیت فعلی برنامه را نیز نمایش می دهد. اگر برنامه ای لغو شود، هیچ یک از کلیدهای API آن برای تماس های API معتبر نیست. خود کلیدها باطل نمی شوند و در صورت تأیید مجدد توسعه دهنده، دوباره برای استفاده در دسترس هستند. برچسب "تأیید شده" برای کلیدهای API به صورت متن خطی نمایش داده می شود در حالی که یک برنامه در حالت لغو است.
• تاریخ انقضای کلید API اکنون در صفحه جزئیات برنامه برنامه‌نویس نشان داده می‌شود، و کلیدها بر اساس تاریخ انقضا در بخش «اعتبارنامه‌ها» سازمان‌دهی می‌شوند. به عنوان مثال، یک کلید بدون انقضا در یک گروه با محصولات API مرتبط آن نشان داده می‌شود و کلیدی که در ۹۰ روز منقضی می‌شود در گروهی دیگر با محصولات مرتبط آن نشان داده می‌شود. شما نمی توانید تاریخ انقضای اعتبار موجود را تغییر دهید.
• با یک دکمه افزودن اعتبار جدید در حالت ویرایش برنامه برنامه‌نویس، می‌توانید کلیدهای API را با زمان یا تاریخ‌های انقضا خاص (یا بدون انقضا) ایجاد کنید. به عنوان (یا پس از) ایجاد اعتبار، می توانید محصولات API را به آن اضافه کنید.
  این قابلیت جایگزین دکمه «بازسازی کلید» در صفحه جزئیات برنامه برنامه‌نویس می‌شود. آن دکمه حذف شده است.

این پیشرفت‌ها ویژگی‌هایی را در رابط کاربری اضافه می‌کنند که قبلاً در API مدیریت موجود بود. (EDGEUI-104)

فعال/غیرفعال کردن برنامه‌نویس برنامه در رابط کاربری (واسط کاربری Cloud 16.10.05)

در Edge UI (صفحه جزئیات برنامه‌نویس، حالت ویرایش، دکمه فعال/غیرفعال) می‌توانید وضعیت توسعه‌دهنده برنامه را بین فعال و غیرفعال تغییر دهید. هنگامی که یک برنامه‌نویس غیرفعال است، هیچ یک از کلیدهای API برنامه توسعه‌دهنده او یا نشانه‌های OAuth تولید شده با آن کلیدها در تماس با پراکسی‌های API معتبر نیستند. (EDGEUI-304)

نشانگرهای توسعه دهنده غیرفعال در رابط کاربری (UI 16.10.26)

وقتی برنامه‌نویس برنامه روی «غیرفعال» تنظیم می‌شود، برنامه‌ها و اعتبارنامه‌های برنامه‌نویس دیگر معتبر نیستند، حتی اگر در وضعیت «تأیید شده» باقی بمانند. اکنون هنگام مشاهده برنامه‌ها و اعتبارنامه‌های یک توسعه‌دهنده غیرفعال در رابط کاربری مدیریت، برچسب وضعیت «تأیید شده» روی برنامه‌ها و اعتبارنامه‌ها به صورت متن خطی نمایش داده می‌شود و یک راهنمای ابزار روی برچسب نشان می‌دهد که توسعه‌دهنده غیرفعال است. اگر برنامه‌نویس به «فعال» بازیابی شود، برنامه‌ها و اعتبارنامه‌های تأییدشده او بار دیگر معتبر می‌شوند و متن خط‌دار روی برچسب «تأیید شده» حذف می‌شود. (EDGEUI-728)

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

تغییر نام داشبورد «تجزیه و تحلیل کد خطا» (UI 16.10.26)

داشبورد "تحلیل خطا" به "تحلیل کد خطا" تغییر نام داده است. داشبورد شامل تماس‌های API با کدهای وضعیت HTTP 4xx و 5xx است. (EDGEUI-738)

داده های TPS در داشبوردهای پراکسی (UI 16.10.26)

داده‌های میانگین تراکنش‌ها در هر ثانیه ("متوسط ​​TPS") به داشبورد اصلی ترافیک پروکسی اضافه شده است. علاوه بر این، هنگامی که ماوس را روی نقاط داده جداگانه در نمودارهای ترافیک پراکسی و عملکرد پروکسی نگه دارید، TPS برای آن بازه زمانی در راهنمای ابزار نمایش داده می شود. (EDGEUI-668)

نمایش خطای تجزیه و تحلیل (16.10.26 UI)

وقتی یک داشبورد تجزیه و تحلیل خطای 500 دریافت می‌کند، رابط کاربری مدیریت بدون توجه به خطا، «گزارش به پایان رسیده است» را نمایش می‌دهد. برای ارائه قابلیت های بهتر عیب یابی، رابط کاربری اکنون خطای واقعی را نمایش می دهد. (EDGEUI-753)

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

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

Edge برای Private Cloud 4.17.01

Cloud 16.10.26 (UI)

Cloud 16.09.21_9

ابر 16.09.21

Cloud 16.10.05 (UI)

ابر 16.08.24.01