‫۲۰.۰۴.۰۶ - یادداشت‌های انتشار Apigee Edge برای «ابر عمومی»

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

در تاریخ‌های زیر، انتشار به‌روزرسانی‌های مؤلفه برای Apigee Edge ویژه «ابر عمومی» را شروع کردیم:

  • پردازشگر پیام: جمعه، ۱ مه ۲۰۲۰
  • مدیریت میانای برنامه‌سازی کاربردی: دوشنبه ۲۰ آوریل ۲۰۲۰
  • مدیریت درآمدزایی: دوشنبه، ۲۰ آوریل ۲۰۲۰
  • انتشار وصله «مدیریت میانای برنامه‌سازی کاربردی»: دوشنبه، ۲۲ ژوئن ۲۰۲۰
  • انتشار وصله مدیریت درآمدزایی: دوشنبه، ۶ ژوئیه ۲۰۲۰
  • به‌روزرسانی امنیتی سرور مدیریت: دوشنبه، ۲۴ اوت ۲۰۲۰
  • انتشار وصله «پردازشگر پیام» با رفع اشکال‌ها: پنج‌شنبه، ۲۴ سپتامبر ۲۰۲۰
  • انتشار وصله «پردازشگر پیام» با رفع اشکال‌ها: دوشنبه، ۲۶ اکتبر ۲۰۲۰
  • انتشار وصله «پردازشگر پیام» با رفع اشکال‌ها: دوشنبه ۱ فوریه ۲۰۲۱

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

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

خط‌مشی‌های JWT

  • رمزگذاری JWT

    خط‌مشی‌های JWT به شما امکان می‌دهد نشان‌های رمزگذاری‌شده را تولید، درستی‌سنجی، و رمزگشایی کنید. عناصر جدید در خط‌مشی‌ها عبارتند از:

    • <Type> - به شما امکان می‌دهد تعیین کنید که آیا نشان‌ها امضا شده یا رمزگذاری شده باشند.
    • <EncryptionAlgorithms> - به شما امکان می‌دهد الگوریتم‌های رمزگذاری <Key> و <Content> را تنظیم کنید.

    (67165581)

  • پشتیبانی از الگوریتم‌های PSS در نشان‌های امضاشده

    خط‌مشی‌های تولید و تأیید JWT و JWS اکنون از الگوریتم‌های PS256،‏ PS384، و PS512 پشتیبانی می‌کنند، همان‌طور که در IETF RFC 7518 توضیح داده شده است. (119856499)

  • تولید زمان شروع نسبی JWT برای رمز

    هنگام تولید JWT با خط‌مشی GenerateJWT، عنصر <NotBefore> به شما امکان می‌دهد زمان نسبی بین زمانی که یک کد تولید می‌شود و زمانی که معتبر می‌شود را مشخص کنید. برای مثال، مقدار <NotBefore> برابر با ۲ ساعت یعنی رمز تا ۲ ساعت پس‌از تولید معتبر نیست. می‌توانید زمان <NotBefore> را در میلی‌ثانیه (ms)، ثانیه (s)، دقیقه (m)، ساعت (h)، روز (d)، یا هفته (w) تنظیم کنید. (126261970)

  • ارجاع دادن به PublicKey/Certificate در VerifyJWT

    در خط‌مشی VerifyJWT، عنصر <PublicKey> / <Certificate> به شما امکان می‌دهد به گواهی با قالب PEM که با آن امضاهای JWT ورودی را درستی‌سنجی می‌کنید ارجاع دهید. برای مثال:

    <PublicKey>
      <Certificate ref='public.certificate_pem'/>
    </PublicKey>

    (132918033)

کارکردهای الگوی پیام

عملکردهای الگوی پیام جدید زیر با این نسخه پخش دردسترس است:

  • firstnonull - مقدار اولین (سمت راست‌ترین) آرگومان غیرتهی را برمی‌گرداند. (139698514)
  • xpath - به شما امکان می‌دهد عبارت «مسیر XML» (XPath) را برای تجزیه متغیرهای XML اعمال کنید. (123246424)

خط‌مشی AssignMessage: با AssignVariable می‌توانید به الگوی پیام ارجاع دهید

در خط‌مشی AssignMessage، عنصر <AssignVariable> / <Template> مشخصه ref را مجاز می‌کند و به شما امکان می‌دهد الگوی ازپیش‌تعریف‌شده‌ای را در زمان اجرا تزریق کنید که می‌تواند بدون نیاز به اصلاح خط‌مشی تغییر کند. (۱۱۸۳۹۶۰۸۲)

چندین نام مستعار گواهینامه

وقتی «امنیت لایه انتقال» را پیکربندی می‌کنید و از چندین گواهینامه در یک انبار کلید استفاده می‌کنید، هرکدام با نام مستعار متفاوت، Edge به شما امکان می‌دهد به نام‌های مستعار گواهینامه خاص در پیکربندی <SSLInfo><KeyAlias> خود ارجاع دهید. برای فعال کردن این رفتار به‌روزشده، دارایی جدید HTTPClient.choose.alias.by.keyalias را در فایل http.properties در پردازشگرهای پیام روی درست تنظیم کنید. کاربران Edge برای «ابر عمومی» باید برای افزودن این دارایی با پشتیبانی تماس بگیرند. (142141620)

خط‌مشی JSONtoXML: اظهارنامه XML را حذف کنید، خروجی را تورفتگی دهید

دو گزینه بولی جدید در خط‌مشی JSONtoXML کنترل بیشتری بر برونداد XML به شما می‌دهد.

  • <Options> <OmitXmlDeclaration> - وقتی روی درست تنظیم شود (پیش‌فرض نادرست است)، عنصر <OmitXmlDeclaration> اظهارنامه پیش‌فرض <?xml version="1.0" encoding="UTF-8"?> XML تولیدشده توسط خط‌مشی را حذف می‌کند.
  • <Options> <Indent> - وقتی روی درست تنظیم شود (پیش‌فرض نادرست است)، عنصر <Indent> برونداد XML را تورفتگی می‌دهد. برای مثال، به‌جای این برونداد:

    <Array><n>1</n><n>2</n><n>3</n></Array>

    عنصر «تورفتگی» این را تولید می‌کند:

    <Array>
     <n>1</n>
     <n>2</n>
     <n>3</n>
    </Array>

(۶۵۱۴۲۳۹۴)

پاسخ‌های اسکن میزبان مجازی

اگر درخواستی به نشانی IP نقطه پایانی Apigee ارسال شده باشد (بدون میزبان مجازی مشخص‌شده)، ‫Edge پاسخ HTTP 200 و سند HTML خالی از میزبان مجازی پیش‌فرض Apigee منسوب به آن نشانی IP برمی‌گرداند. برای جلوگیری از این تصور نادرست که چنین پاسخی ممکن است نشان‌دهنده آسیب‌پذیری بالقوه‌ای باشد که می‌تواند مورد بهره‌برداری قرار گیرد، اتصال قطع می‌شود و هیچ پاسخی برگردانده نمی‌شود. (140005396)

ویژگی‌های سرور هدف در «ردیابی» برای کمک به عیب‌یابی

ویژگی‌های ردیابی جدید زیر با نشان دادن اینکه آیا HTTPClient برای سرور هدف ذخیره شده است یا نه، به عیب‌یابی مشکلات اتصال هدف کمک می‌کند: isHttpClientCached و isFromClientPool. (140574604)

خط‌مشی MessageLogging: پیام Syslog

در خط‌مشی MessageLogging، عنصر جدید <Syslog> / <PayloadOnly> (بولی) به شما امکان می‌دهد تعیین کنید آیا چیزی به‌طور خودکار به <Message> که تعریف می‌کنید اضافه شود یا نه. اگر <PayloadOnly> را روی درست تنظیم کنید، هیچ‌چیز به تعریف پیام شما اضافه نمی‌شود (صرف‌نظر از تنظیم <FormatMessage> ). اگر روی false (پیش‌فرض) تنظیم شود، تنظیم <FormatMessage> تعیین می‌کند چه چیزی به پیام گزارش اضافه شود. (68722102)

انقضای خط‌مشی‌های حافظه نهان

عنصر انقضای <TimeoutInSeconds> جدید در خط‌مشی ResponseCache و خط‌مشی PopulateCache به‌گونه‌ای عمل می‌کند که عنصر <TimeoutInSecs> موجود در ابتدا برای آن درنظر گرفته شده بود. لطفاً از عنصر جدید استفاده کنید. عنصر منسوخ‌شده <TimeoutInSecs> همچنان برای سازگاری با نسخه قدیمی وجود دارد. اگر هر دو عنصر <TimeoutInSecs> و <TimeoutInSeconds> پیکربندی شده باشند، Edge از <TimeoutInSeconds> استفاده می‌کند. (119172893)

متغیر جریان virtualhost.aliases.values

متغیر جریان پیام virtualhost.aliases.values فقط خواندنی جدید آرایه‌ای با قالب JSON از همه نام‌های مستعار اختصاص‌داده‌شده به میزبان مجازی که در درخواست ورودی فراخوانده شده است برمی‌گرداند. (128453178)

پارامتر جدید برای اطمینان از حذف نسخه بازبینی پراکسی

پارامتر پُرسمان جدیدی force به حذف نسخه میانای API اضافه شده است. در مواردی که نسخه اصلاح‌شده در List API Proxies API فهرست شده است اما درواقع نمی‌تواند پُرسمان شود، این پارامتر تضمین می‌کند که نسخه اصلاح‌شده پراکسی حذف شود. (111691721)

برای مثال:

DELETE /v1/organizations/myorg/apis/myproxy/revisions/2?force=true

متغیر جریان جدید برای مقادیر نام مستعار میزبان مجازی

متغیر جریان پیام فقط خواندنی virtualhost.aliases.values جدید آرایه‌ای با قالب JSON از همه نام‌های مستعار اختصاص‌داده‌شده به میزبان مجازی که در درخواست ورودی فراخوانده شده است برمی‌گرداند. (128453178)

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

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

شناسه مشکل نام عنصر شرح
143313772 پردازشگر پیام

مشکلی در خط‌مشی SpikeArrest برطرف شد که وقتی UseEffectiveCount فعال بود و بازراه‌اندازی چرخشی اتفاق می‌افتاد رخ می‌داد.

(در نسخه وصله ۲۰۲۱/۱/۲.)

154428338 زمان اجرای API

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

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

149507805 مدیریت میانای برنامه‌سازی کاربردی

فعال کردن استقرار/پیکربندی ازطریق HTTP برای همه سرورهای MGMT تولید

به‌روزرسانی‌های پیکربندی به‌جای RPC ازطریق HTTP انجام می‌شود که قابلیت اطمینان و ثبت خطاهای گزارش را بهبود می‌بخشد.

137217974 مدیریت میانای برنامه‌سازی کاربردی

هنگام پیکربندی «نقطه اندازه‌گیری» ازطریق HTTP، وقتی سرور مقصد هنوز درحال استفاده است، خطا را به‌درستی منتشر کنید

درنتیجه بهبودهای قابلیت اطمینان که در شماره ۱۴۹۵۰۷۸۰۵ معرفی شد، خطاهای پاسخ از حذف سرور هدف به‌اشتباه به‌عنوان وضعیت ۲۰۰ (موفقیت) گزارش می‌شدند، درحالی‌که حذف ناموفق بود. با این اصلاح، اگر حذف ناموفق باشد، خطاهای پاسخ اکنون به‌درستی به‌عنوان «وضعیت ۴۰۰» گزارش می‌شود. توجه داشته باشید که اگر سرور هدف توسط یک پراکسی که درحال حاضر مستقر است ارجاع داده شود، حذف سرور هدف ممکن است با شکست مواجه شود. قبل‌از حذف سرور هدف، بررسی کنید که سرور هدف توسط هیچ‌یک از پراکسی‌های API که درحال‌حاضر مستقر هستند ارجاع داده نشده باشد.

69765558 مدیریت میانای برنامه‌سازی کاربردی

‫Resource Permissions API کد ۴۰۳ برمی‌گرداند

149545506 مدیریت میانای برنامه‌سازی کاربردی

مشکل امنیتی در API مربوط به افزودن کاربر به نقش را برطرف می‌کند.

131246911 مدیریت میانای برنامه‌سازی کاربردی برای ایمیل‌های توسعه‌دهنده در یک درگاه، پشتیبانی از دامنه‌های جدیدتر مانند *.games، *.asia را فعال کنید

مشکلی برطرف شد که در آن برخی‌از نام‌های دامنه، مانند *.games، *.asia، و *.africa باعث می‌شد ایجاد توسعه‌دهنده در Edge ناموفق باشد زیرا اعتبارسنج دامنه آن‌ها را تشخیص نمی‌داد. ‫Edge اکنون فقط معتبر بودن قالب نشانی ایمیل را (شامل نماد «@») درستی‌سنجی می‌کند.

142217645 مدیریت میانای برنامه‌سازی کاربردی

‫PUT v1/o/{org_name}/apiproducts/{product_name} سهمیه‌ها را برنمی‌دارد quotas

162299668 سرور مدیریت

آسیب‌پذیری امنیتی بالقوه‌ای برطرف شد.

135856488 سرور مدیریت

کندی میانای کاربر

139407965 سرور مدیریت

مشکلی که باعث می‌شد KVM بدون نام ایجاد شود برطرف شد.

112488235 سرور مدیریت

درستی‌سنجی اضافه شد تا از ایجاد میزبان‌های مجازی با فاصله در نام جلوگیری شود. نویسه‌های فاصله برای استفاده در نام‌های میزبان مجازی معتبر نیستند.

132433193 مدیریت درآمدزایی

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

152514520 مدیریت درآمدزایی

مشکلی در تماس‌های «میانای برنامه‌سازی کاربردی مدیریت» برای حذف نهادها برطرف شد.

128450374 زمان اجرای API

خط‌مشی‌های JWT/JWS باید IgnoreUnresolvedVariables را رعایت کنند - اگر متغیر تعریف نشده است، خطای مناسبی ایجاد کنند

135354517 زمان اجرای API

سازمان در «نسخه پخش_۱۹۰۳۰۱» به‌دلیل اجرای دقیق نوع داده «رشته» در BasicAuth ناموفق است

131763486 زمان اجرای API

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

135972575 زمان اجرای API

‫Private Cloud نسخه 4.19.01 درطول استقرار با override=true&delay=300 رفتار متفاوتی نشان می‌دهد

این اصلاح در نسخهٔ پخش بعدی Edge for Private Cloud گنجانده خواهد شد.

141601836 زمان اجرای API

تصحیح نام میزبان در پیام گزارش

116834109 زمان اجرای API

مقادیر نادرست برای متغیرهای fault.cause و fault.name در «پیگیری» ناموفق بود، خطا

130653816 زمان اجرای API

خطاهای متناوب ۴۰۴ در ترافیک زمان اجرا

132777537 زمان اجرای API

خط‌مشی ExtractVariables برای JSONPath معتبر ناموفق بود

133713555 زمان اجرای API

رهیاب لبه‌ای درحال تغییر دادن سرایند تاریخ

133253435 زمان اجرای API

استفاده بالای CPU توسط رشته Apigee-Main

111553402 زمان اجرای API

محصول میانای برنامه‌سازی کاربردی با نویسه‌های نامعتبر در مسیر تا زمان اجرا شناسایی نمی‌شود

126240341 زمان اجرای API

بهبود پیام عمومی «تولید ناموفق بود» درصورت ناموفق بودن خط‌مشی GenerateJWT

119854424 زمان اجرای API

‫LoadBalancer با سرور هدف تکی نباید درصورت عدم موفقیت در اتصال غیرفعال شود

129275412 زمان اجرای API

افزودن سرایندهای HTTP به میزبان مجازی برگشتی برای اسکن‌های IP عمومی

129351507 زمان اجرای API

خط‌مشی «احراز هویت پایه» وقتی گذرواژه دارای دونقطه است رمزگشایی نمی‌شود

65852874 زمان اجرای API

مطمئن شوید که HTTPClient سعی نمی‌کند از اتصالی که سرایند پاسخ Connection:close داشته است دوباره استفاده کند

138951646 زمان اجرای API

حد زمانی در جاوا اسکریپت برای httpClient کار نمی‌کند

139051927 زمان اجرای API

تأخیر بالای پردازش درخواست

132443137 زمان اجرای API

تغییر رفتار پردازشگر پیام برای مدیریت سرایندهای داخلی ناشناخته x-apigee

138310777 زمان اجرای API

تماس استقرار جاری‌سازی هم‌رسانی‌شده به‌طور تصادفی کد ۵۰۴ برمی‌گرداند

67170148 زمان اجرای API

تفاوت‌های «زمان سپری‌شده» و «زمان صرف‌شده» در «خدمات تماس»

124049692 زمان اجرای API

‫NullPointerException در خط‌مشی VerifyApiKey

135031506 زمان اجرای API

افزودن پیام گزارش برای قالب کلید JWT غیرمنتظره

137312366 زمان اجرای API

اعتبارسنجی محتوا براساس سرایند Content-Type

109871907 زمان اجرای API

تأخیرهای اجرای «خدمات پیامک» بدون عنصر «پاسخ»

143722867 زمان اجرای API

‫JWT باید محدودیت پیکربندی‌پذیری را برای تعداد تکرارهای PBKDF2 اعمال کند

144286363 ردیابی ترکیبی

عیب‌یابی پوشش در env.json داده‌های پاسخ را در Apigee hybrid نمی‌پوشاند

147769812 زمان اجرای API

اعلام کردن دارایی‌های درهم‌سازی OAuth به‌عنوان تغییرپذیر در پرچم‌های ویژه

149037704 زمان اجرای API

مشکلی برطرف شد که در آن مقدار اختصاص‌داده‌شده به متغیر جریان proxy.url ممکن بود نام مستعار میزبان نادرستی برگرداند.

148972262 زمان اجرای API

‫DecodeJWS محموله را به متغیر زمینه‌ای در قالبی بی‌فایده منتشر می‌کند

116580622 زمان اجرای API

پاسخ ناسازگار

149739904 زمان اجرای API

پوشش داده برای سرصفحه‌های HTTP باید به حروف بزرگ و کوچک حساس نباشد

149431545 زمان اجرای API

‫GenerateJWT و VerifyJWT با SecretKey هیچ کدبندی‌ای به‌جز UTF-8 را نمی‌پذیرد

155448596 مدیریت میانای برنامه‌سازی کاربردی- وصله

اجازه‌های نقش پیش‌فرض apimonitoringadmin وجود ندارد

اجازه‌های جاافتاده به نقش apimonitoringadmin اضافه شد.

158592076 مدیریت میانای برنامه‌سازی کاربردی- وصله

اجازه‌های نقش مدیر توسعه‌دهنده پیش‌فرض وجود ندارد

اجازه‌های جاافتاده به نقش مدیر توسعه‌دهنده اضافه شد.

152856311 مدیریت میانای برنامه‌سازی کاربردی- وصله

اعتبارسنجی‌ها برای رد کردن گواهینامه‌های PKCS7 و DER در انبار کلید و انبار اعتماد درطول ایجاد و به‌روزرسانی میزبان مجازی

درطول ایجاد یا به‌روزرسانی میزبان مجازی، اعتبارسنجی‌ها برای بررسی اینکه آیا گواهی‌های اضافه‌شده در نام مستعار keystore و truststore در قالب PEM هستند و نه در قالب‌های ناسازگار مانند PKCS7، DER و غیره، اعمال می‌شوند.

155478545 مدیریت درآمدزایی- وصله

مشکلی در به‌روزرسانی‌های وضعیت اعلان‌های ایمیلی برطرف شد.

154121499 مدیریت درآمدزایی- وصله

مشکلی که در آن /mint/org/orgname/delete-org-data API خطای وضعیت ۴۰۴ را برمی‌گرداند برطرف شد.

152356393 مدیریت درآمدزایی- وصله

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

138542921 مدیریت درآمدزایی- وصله

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

150948843 مدیریت درآمدزایی- وصله

مشکلی برطرف شد که در آن «میانای برنامه‌سازی کاربردی» /sync-developers «درآمدزایی» تعارض‌های پایداری ایجاد می‌کرد.

155443118 مدیریت درآمدزایی- وصله

فیلد jsonMailProperties برداشته شد.

150948843 مدیریت درآمدزایی- وصله

مشکلی برطرف شد که در آن «میانای برنامه‌سازی کاربردی» /sync-developers «درآمدزایی» تعارض‌های پایداری ایجاد می‌کرد.