‫۱۷/۰۸/۱۶ - یادداشت‌های انتشار Apigee Edge برای «ابر عمومی»

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

در سه‌شنبه ۳۰ اوت ۲۰۱۶، نسخه جدیدی از Apigee Edge را برای «ابر عمومی» منتشر کردیم.

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

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

بار JSON در «اختصاص دادن پیام» و «ایجاد خطا»

با این بهبود، برای اطمینان از قالب‌بندی صحیح پیام JSON، دیگر نیازی به راه‌حل‌های موقت نیست و متغیرها را می‌توان بااستفاده از آکولاد بدون ایجاد JSON نامعتبر مشخص کرد. برای مثال، عبارت زیر مقدار message.content را در پیام JSON درج می‌کند:

<Payload contentType="application/json">{"message" : "{message.content}"}</Payload>

اگر از راهکاری استفاده کرده‌اید، کد شما همچنان به همان شکل کار خواهد کرد. همچنین می‌توانید به‌جای آکولاد از variablePrefix و variableSuffix برای نشان دادن متغیرها استفاده کنید.

عنصر <Set><Payload> را در خط‌مشی «اختصاص پیام» و اسناد مرجع خط‌مشی «ایجاد خطا» ببینید. (APIRT-1160)

بهبودهای خط‌مشی XML به JSON

خط‌مشی XML به JSON با قابلیت‌های زیر بهبود یافته است. می‌توانید خط‌مشی را برای انجام کارهای زیر پیکربندی کنید:

• برخی‌از عناصر XML را درطول تبدیل به‌عنوان آرایه درنظر بگیرید، که مقادیر را در کروشه «[ ]» در سند JSON قرار می‌دهد.
• سطوح سلسله‌مراتب سند XML را در سند نهایی JSON حذف یا ازبین ببرید.

برای اطلاعات بیشتر، خط‌مشی XML به JSON را ببینید. ‫(APIRT-1144)

چندین نویسه عام در مسیرهای منبع «محصول میانای برنامه‌سازی کاربردی»

هنگام تعریف مسیرهای منبع در «محصول API»، می‌توانید در چندین مکان در مسیر منبع از نویسه‌های عام استفاده کنید. برای مثال، /team/*/invoices/** فراخوانی‌های API را با هر مقدار بعداز /team و هر مسیر منبع بعداز invoices/ مجاز می‌کند. نشانی وب مجاز در تماس با «میانای برنامه‌سازی کاربردی» proxyBasePath/team/finance/invoices/company/a خواهد بود.

اگر پس‌از این انتشار، مسیرهای منبع «محصول میانای برنامه‌سازی کاربردی» موجود شما طبق انتظار کار نکرد، دارایی زیر را در سازمانتان تنظیم کنید تا به عملکرد قبلی برگردید: features.enableStandardWildCardMatchForAPIProductResources = true

(MGMT-3273)

کارکردهای رمزنگاری در جاوا اسکریپت

مجموعه جدیدی از توابع crypto جاوا اسکریپت با عملکرد بالا برای ایجاد، دریافت، و به‌روزرسانی موارد زیر دردسترس است: MD5،‏ SHA-1،‏ SHA256،‏ SHA512. شیء رمزارز همچنین به شما امکان می‌دهد تاریخ را در قالب‌های مختلف دریافت کنید. برای اطلاعات بیشتر، به مدل شیء جاوا اسکریپت مراجعه کنید. ‫(APIRT-2886)

بررسی نسخه JAR نوشته راهنمای جاوا

هنگام بارگذاری منبع Java JAR در پراکسی API، اگر نسخه منبع Java با نسخه Java پشتیبانی‌شده در Edge که در نرم‌افزار پشتیبانی‌شده و نسخه‌های پشتیبانی‌شده فهرست شده است سازگار نباشد، کد وضعیت HTTP 400 (به‌جای 500) برگردانده می‌شود. (MGMT-3420)

اعتبارسنجی منابع پراکسی میانای برنامه‌سازی کاربردی

وقتی فایل‌های منبع کارگزار API (مثل جاوا اسکریپت یا JAR جاوا) در محدوده محیط یا سازمان ذخیره شده باشد، چارچوب اعتبارسنجی دیگر از شما نمی‌خواهد که آن منابع را در سطح کارگزار API در بسته کارگزار برای وارد کردن و گذراندن اعتبارسنجی اضافه کنید. اعتبارسنجی منبع اکنون در زمان استقرار انجام می‌شود، نه در زمان وارد کردن. (MGMT-1430)

مهلت زمانی را برای پراکسی‌های میانای برنامه‌سازی کاربردی جداگانه پیکربندی کنید

می‌توانید کارگزاران نیابتی API را پیکربندی کنید تا پس‌از مدت زمان مشخصی (با وضعیت ۵۰۴ gateway timeout) زمان‌بندی شوند. مورد استفاده اصلی برای مشتریان «ابر خصوصی» است که کارگزاران میانای برنامه‌سازی کاربردی دارند که اجرای آن‌ها بیشتر طول می‌کشد. برای مثال، فرض کنید به پراکسی‌های خاصی نیاز دارید که پس‌از ۳ دقیقه زمان آن‌ها به‌پایان برسد. می‌توانید از دارایی api.timeout جدیدی در پیکربندی برای پراکسی میانای برنامه‌سازی کاربردی استفاده کنید. در اینجا نحوه انجام آن با مثال ۳ دقیقه‌ای آورده شده است:

1. ابتدا، مطمئن شوید که ترازکننده بار، رهیاب، و پردازشگر پیام را پیکربندی کرده باشید تا پس‌از ۳ دقیقه زمان‌بندی شوند.
2. سپس پراکسی‌های مربوطه را پیکربندی کنید تا پس‌از ۳ دقیقه زمان آن‌ها به‌پایان برسد. مقدار را به میلی‌ثانیه مشخص کنید. برای مثال:

   <ProxyEndpoint name="default">
     <HTTPProxyConnection>
       <BasePath>/v1/weather</BasePath>
       <Properties>
         <!-- api.timeout is in milliseconeds -->
         <Property name="api.timeout">180000</Property>
       </Properties>
       ...

3. بااین‌حال، توجه داشته باشید که افزایش زمان‌های وقفه سیستم می‌تواند منجر به مشکلات عملکرد شود، زیرا همه پراکسی‌های بدون تنظیم api.timeout از زمان‌های وقفه جدید، بالاتر، ترازکننده بار، مسیریاب، و پردازشگر پیام استفاده می‌کنند. بنابراین پراکسی‌های میانای برنامه‌سازی کاربردی دیگری را که به زمان‌های انتظار طولانی‌تر نیاز ندارند پیکربندی کنید تا از زمان‌های انتظار کوتاه‌تر استفاده کنند. برای مثال، مجموعه زیر کارگزار پراکسی API را تنظیم می‌کند تا پس‌از ۱ دقیقه زمان آن به‌پایان برسد:
   <Property name="api.timeout">60000</Property>

مشتریان Cloud که نمی‌توانند زمان‌های اتمام Edge را تغییر دهند، می‌توانند زمان اتمام پراکسی API را نیز پیکربندی کنند، به‌شرطی که زمان اتمام کوتاه‌تر از زمان اتمام استاندارد پردازشگر پیام Edge (۵۷ ثانیه) باشد.

نمی‌توانید مقدار را با متغیر پر کنید. این دارایی در مرجع دارایی‌های نقطه پایانی پوشش داده شده است. ‫(APIRT-1778)

خط‌مشی «امنیت لایه انتقال»/ پوسته ایمن برای ثبت پیام

<KeyStore> و <TrustStore> را می‌توان در پیکربندی SSLInfo در خط‌مشی «گزارش‌گیری پیام» تنظیم کرد و «امنیت لایه انتقال»/ SSL یک‌طرفه و دوطرفه را با سرویس گزارش‌گیری مجاز کرد. SSLInfo را در خط‌مشی «گزارش‌گیری پیام» به همان روشی پیکربندی می‌کنید که در پراکسی TargetEndpoint پیکربندی می‌کنید. بااین‌حال، «گزارش‌گیری پیام» TLS/SSL فقط از پروتکل TCP پشتیبانی می‌کند. ‫(APIRT-1858)

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

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