‫۱۹.۰۳.۰۱ - یادداشت‌های انتشار Apigee Edge برای «ابر عمومی»

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

روز سه‌شنبه، ۳ دسامبر ۲۰۱۹، انتشار به‌روزرسانی این نسخه از Apigee Edge برای Public Cloud را شروع کردیم. (نسخه اصلی در پنج‌شنبه ۱۸ آوریل ۲۰۱۹ منتشر شد.)

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

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

شناسه مشکل نام عنصر شرح
‫Apigee انتشار به‌روزرسانی‌های زیر را در تاریخ ۱ اکتبر ۲۰۱۹ شروع کرد
110995050 زمان اجرای API

توزیع بار - کنترل بیشتر برای برداشتن سرورهای ناموفق

هنگام پیکربندی توزیع‌کننده بار برای پراکسی API، می‌توانید تعیین کنید چند خطای پاسخ رخ دهد تا سرور از چرخش توزیع بار برداشته شود. عدم موفقیت در پاسخ یعنی Apigee هیچ پاسخی از سرور هدف دریافت نمی‌کند. وقتی این اتفاق می‌افتد، شمارنده عدم موفقیت یک واحد افزایش می‌یابد. وقتی Apigee از هدفی پاسخ دریافت می‌کند، حتی اگر پاسخ خطای HTTP (مثل ۵۰۰) باشد، این پاسخ به‌عنوان پاسخ از سرور هدف محسوب می‌شود، و شمارنده خرابی بازنشانی می‌شود. برای کمک به اطمینان از اینکه پاسخ‌های HTTP بد (مثل ۵۰۰) نیز شمارنده خرابی را افزایش می‌دهند تا سرور ناسالم را در اسرع وقت از چرخش تراز بار خارج کنند، می‌توانید عنصر <ServerUnhealthyResponse> جدیدی با عناصر فرزند <ResponseCode> به پیکربندی تراز بارتان اضافه کنید. ‫Edge پاسخ‌های دارای آن کدها را نیز به‌عنوان ناموفق درنظر می‌گیرد.

<HTTPTargetConnection>
  <LoadBalancer>
    <Algorithm>RoundRobin</Algorithm>
    <Server name="target1" />
    <Server name="target2" />
    <ServerUnhealthyResponse>
        <ResponseCode>500</ResponseCode>
        <ResponseCode>502</ResponseCode>
        <ResponseCode>503</ResponseCode>
    </ServerUnhealthyResponse>
    <MaxFailures>5</MaxFailures>
  </LoadBalancer>
</HTTPTargetConnection>
  
  
130416715 امنیت

بهبودهای خط‌مشی «کنترل دسترسی»

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

<IgnoreTrueClientIPHeader>: اختیاری (پیش‌فرض نادرست است). وقتی این را روی درست تنظیم می‌کنید، خط‌مشی سرصفحه True-Client-IP را نادیده می‌گیرد و نشانی‌های IP را در سرصفحه X-Forwarded-For ارزیابی می‌کند و از رفتار ارزیابی X-Forwarded-For که پیکربندی کرده‌اید پیروی می‌کند.

<AccessControl async="false" continueOnError="false"
    enabled="true" name="Access-Control-1">
    <DisplayName>Access Control-1</DisplayName>
    <IgnoreTrueClientIPHeader>true</IgnoreTrueClientIPHeader>
    ...
</AccessControl>
‫Apigee به‌روزرسانی‌های زیر را در تاریخ ۱۸ آوریل ۲۰۱۹ منتشر کرد
‫۱۱۷۵۵۸۸۱۵،
‫۱۱۹۸۵۶۴۹۹،
‫۱۱۰۵۴۸۱۳۷،
‫۷۹۵۲۶۷۴۸،
‫۷۲۹۸۹۴۴۹،
‫۷۰۷۱۲۸۵۹،
‫۶۹۰۴۹۰۴۱
زمان اجرای API JWS و JWT
خط‌مشی‌های جدیدی برای پشتیبانی از JWS اضافه کرده‌ایم و خط‌مشی‌های موجود JWT را بهبود داده‌ایم.

برای جزئیات، به این پست انجمن مراجعه کنید.

122610025 زمان اجرای API اجازه دادن به RaiseFault برای تنظیم دلیل خطا و متغیرهای اختیاری مانند AssignMessage

دو عنصر جدید در خط‌مشی RaiseFault دردسترس است تا مدیریت FaultRules را پاک‌تر و قدرتمندتر کند.

  • ‫ShortFaultReason یک مقدار منطقی است که وقتی روی درست تنظیم شود، نام خط‌مشی را در متغیر fault.reason قرار می‌دهد.
  • AssignVariable که در FaultResponse دردسترس است به شما امکان می‌دهد پاسخ خطا را به متغیری اختصاص دهید تا توسط خط‌مشی‌های دیگر در جریان پراکسی API استفاده شود.
121149811 هدف‌های میزبانی‌شده محدودیت‌های اعمال‌شده برای «هدف‌های میزبانی‌شده»

اکنون محدودیت‌ها برای «هدف‌های میزبانی‌شده» اعمال می‌شود. برای جزئیات محدودیت‌ها، محدودیت‌ها را ببینید.

117659213 زمان اجرای API پارامتربندی کردن محدوده‌های IP در خط‌مشی AccessControl

اکنون می‌توانید از متغیرهای الگوی پیام برای تنظیم نشانی‌های IP و ماسک‌های CIDR در خط‌مشی AccessControl استفاده کنید. برای مثال، اگر بخواهید نشانی IP و ماسک را در نقشه مقدار کلید (KVM) ذخیره کنید، می‌توانید آن مقادیر را از متغیری که در جریان پراکسی API تنظیم کرده‌اید بازیابی کنید. این کار به شما امکان می‌دهد مقادیر IP را در زمان اجرا بدون نیاز به تغییر پیکربندی خط‌مشی‌تان راحت‌تر تغییر دهید.

برای مثال، به‌جای:

<MatchRule action="DENY">
    <SourceAddress mask="24">198.51.100.1</SourceAddress>
</MatchRule>
     

می‌توانید خط‌مشی را به‌این‌صورت پیکربندی کنید، با این فرض که مقادیر در KVM ذخیره شده است، و از خط‌مشی KeyValueMapOperations برای بازیابی مقادیر و اختصاص دادن آن‌ها به متغیرهایی که در اینجا نشان داده شده است استفاده می‌کنید:

<MatchRule action="DENY">
    <SourceAddress mask="{kvm.mask.ref}">{kvm.ip.ref}</SourceAddress>
</MatchRule>
     
113599885 پایش میانای برنامه‌سازی کاربردی نقش‌های «پایش میانای برنامه‌سازی کاربردی»

«پایش میانای برنامه‌سازی کاربردی» دو نقش ارائه می‌دهد: «سرپرست پایش میانای برنامه‌سازی کاربردی» و «کاربر پایش میانای برنامه‌سازی کاربردی» که در دسترسی به پایش میانای برنامه‌سازی کاربردی توضیح داده شده است. این موارد در دسامبر ۲۰۱۸ دردسترس قرار گرفتند.

132256772 زمان اجرای API سرایند X-Apigee.Message-Timeout به درخواست اضافه شد

اکنون Edge سرایند X-Apigee.Message-Timeout را به هر درخواست اضافه می‌کند. این سرایند برای استفاده داخلی Edge است. به مقادیر موجود در سرایندهای X-Apigee.* در پراکسی‌های API خود تکیه نکنید زیرا این سرایندها برای استفاده مشتری درنظر گرفته نشده‌اند و Apigee می‌تواند آن‌ها را در هر زمانی حذف یا تغییر دهد.

78575018 فضای ابری خصوصی / OPDK وقتی چند غلاف دروازه وجود دارد، از سرور مدیریت رد شوید تا ثبت مخزن داده دروازه رد شود

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

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

شناسه مشکل نام عنصر شرح
‫Apigee از ۳ دسامبر ۲۰۱۹ شروع به انتشار اصلاحات زیر کرد
رفع اشکال‌های امنیتی.
‫Apigee از تاریخ ۲۹ اکتبر ۲۰۱۹ شروع به انتشار اصلاحات زیر کرد
139381794 سرور مدیریت

خطاهای حذف مخزن کلید را مدیریت کنید تا فراخوانی API ناموفق نباشد

‫Apigee از ۱ اکتبر ۲۰۱۹ شروع به انتشار اصلاحات زیر کرد
140761319 زمان اجرای API

x-apigee.edge.execution.sense.action همیشه روی null تنظیم می‌شود

139091614 زمان اجرای API

در خط‌مشی ResponseCache، NIOTheread بدون رد شدن از استخر رشته اجرا می‌شود

131331305 سرویس‌های اصلی

چندین صادرکننده گزارش در مسیریاب‌های Apigee باعث استفاده زیاد از CPU می‌شود

136690640 زمان اجرای API

خطاهای 404 متناوب در سازمان‌های خاص

140948100 زمان اجرای API

«جریان مشترک» پیاده‌سازی‌شده در برخی‌از پردازشگرهای پیام اجرا نمی‌شود

‫Apigee اصلاحات زیر را در تاریخ ۱۳ سپتامبر ۲۰۱۹ منتشر کرد
132654321 سرور مدیریت گزارش‌های ممیزی داده‌ها را نشان نمی‌دهد
131246911 سرور مدیریت برای ایمیل‌های توسعه‌دهنده در یک درگاه، پشتیبانی از دامنه‌های جدیدتر مانند *.games، *.asia را فعال کنید
‫Apigee در تاریخ ۱۸ آوریل ۲۰۱۹ اصلاحات زیر را منتشر کرد
123844598 سرور مدیریت کلیدهای برنامه حذف‌شده پس‌از گذشت >۲۴ ساعت دیگر قابل وارد کردن نیستند
123588156 زمان اجرای API برداشتن سرایند «طول محتوا» از پاسخ با خطای ۳۰۴ مواجه می‌شود
122732400 زمان اجرای API ‫api.timeout تنظیمات io.timeout.millis را ملغی می‌کند
122545281 زمان اجرای API پوشش داده «جلسه اشکال‌زدایی» برای JSON باید مواردی را که jsonPayload آرایه است درنظر بگیرد
122355807 سرور مدیریت عملکرد اجازه نادرست برای کاربران دارای نقش‌های متعدد
121393556 زمان اجرای API ‫x_apigee_fault_code روی «org/codehaus/jackson/map/ObjectMapper» تنظیم شده است
120998548 میانای کاربر Edge غلط املایی در پیام خطا: گواهینامه نامعتبر است یا نمی‌توان به آن اعتماد کرد
120990929 زمان اجرای API پاسخ HTTP-413 از Nginx/Apigee-Router نوع سرور را نشان می‌دهد
120799489 زمان اجرای API هنگام استفاده از httpClient با پاسخ‌گوی ناهمگام جاوا اسکریپت httpComplete()، برونداد debugsession (ردیابی) بی‌صدا می‌شود
120794339 زمان اجرای API ‫MPs برای سازمان تغییر کرده است
120277011 سرور مدیریت نیاز به اعتبارسنجی ورودی: اگر نام میزبان سرور مقصد ** داشته باشد، نمی‌توان پراکسی را مستقر کرد
119976417 پایش میانای برنامه‌سازی کاربردی «پایش API» زمان پاسخ کارگزار نیابتی بالا را نشان می‌دهد، درحالی‌که تجزیه‌وتحلیل‌ها زمان پاسخ هدف بالا را نشان می‌دهد
119947481 زمان اجرای API در سناریو استثنایی، پیام‌واره‌ای که باید پوشانده شود به‌عنوان نوشتار ساده ثبت می‌شود
119877164 فضای ابری خصوصی / OPDK روترها خطا تولید می‌کنند، پردازنده پیام با فعال بودن «امنیت لایه انتقال» آفلاین می‌شود

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

119816218 زمان اجرای API اگر سرصفحه «منقضی می‌شود» به ۰ یا عدد منفی تبدیل شود، حافظه نهان پاسخ آن را نادیده می‌گیرد
119770242 زمان اجرای API ارتباط «مسیریاب به MP» ناموفق بود و باعث ازکارافتادگی کامل شد: خطا در PostClientFlow باعث حلقه بی‌نهایت می‌شود
119443145 سرور مدیریت وقتی ProxyEndpoint تغییر نام می‌دهد و دوباره استقرار می‌یابد، پراکسی API کد ۴۰۴ برمی‌گرداند
119260281 زمان اجرای API خطای گزارش «نمی‌تواند به‌عنوان رشته ۳۰۰۰.۰ تجزیه کند»
118743407 سرور مدیریت مدت زمان استقرار پراکسی Apigee
118447966 زمان اجرای API خطا در «نوشته‌های راهنمای جاوا اسکریپت» در «نسخه MP 180608_07»
117549719 زمان اجرای API عدم تطابق بین نشانی وب درخواست و مسیر پایه پراکسی
117219520 زمان اجرای API MessageLogging: ثبت‌کننده Syslog از قالب تاریخ نادرستی به‌عنوان پیش‌فرض استفاده می‌کند، میلی‌ثانیه‌ها را به‌صورت نادرست نمایش می‌دهد
117116435 زمان اجرای API خطاهای متناوب از فایل جاوا اسکریپت
117091520 زمان اجرای API ‫JavaCallouts پس‌از انتشار پردازنده پیام نسخه ۱۸.۰۶.۰۸ ناموفق است
116165318 زمان اجرای API استقرار هم‌زمان بسته یکسان باعث بروز خطای RepositoryException می‌شود
116055025 سرویس Configstore پردازشگرهای پیام پس‌از راه‌اندازی مجدد میزبان‌های مجازی و برنامه‌ها را ازدست می‌دهند
115614498 زمان اجرای API به پشتیبانی برای ILB در OPDK نیاز دارید

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

113972537 زمان اجرای API چندین P1 - استثنای NullPointerException از کد Node.js در پراکسی‌های Trireme - خطای سرور داخلی ۵۰۰
113904969 پشتیبانی Apigee مشکل در حذف کارگزاران میانای برنامه‌سازی کاربردی در سازمان‌های نمایشی
113554802 زمان اجرای API ادعای SAML با NullPointerException نامعتبر است
113315737 سرور مدیریت استقرار پراکسی به‌دلیل نبودن سوابق استقرار در Zookeeper ناموفق بود
112767195 زمان اجرای API خطاهای متناوب DataStore هنگام دسترسی به خط‌مشی KVM
112162179 زمان اجرای API ذخیره کردن شیء جاوا اسکریپت بدون تبدیل آن به رشته می‌تواند منجر به بن‌بست شود
111860576 زمان اجرای API خطای ناموجود در خط‌مشی سهمیه
111671525 هدف‌های میزبانی‌شده کدهای پاسخ غیرموفق از هدف‌های میزبانی‌شده باعث راه‌اندازی جریان خطا در پراکسی می‌شود
111523933 افزونه‌ها(رابط‌ها) مشکل ذخیره کردن خط‌مشی «نوشتار راهنمای تماسی افزونه»
111420263 زمان اجرای API استثنای ConcurrentModification در MessageLogging
110843526 سرور مدیریت «میانای برنامه‌سازی کاربردی مدیریت» برای ایجاد/به‌روزرسانی قلاب جریان باید جریان هم‌رسانی‌شده را اعتبارسنجی کند
110805739 زمان اجرای API وقتی Reuserefreshtoken درست است و انقضای ژتون بازآوری به‌طور صریح تنظیم نشده است، TTL در جریان CPS روی -۱ تنظیم نشده است
110429629 زمان اجرای API خط‌مشی «احراز هویت پایه» متغیر request.headers.Authorization را در DebugSession منتشر می‌کند
110425503 زمان اجرای API بارگیری مجدد Nginx باعث بروز مشکل در دردسترس بودن MP می‌شود
110311540 زمان اجرای API NPE وقتی MP درحال خاموش شدن است
110161455 زمان اجرای API ‫AccessEntity باید به‌جای واکشی همه برنامه‌ها برای سازمان‌های CPS، از روش واکشی براساس نام برنامه استفاده کند
90695522 زمان اجرای API context.proxyRequest.asForm generates java.lang.ArrayIndexOutOfBoundsException: 1
79734096 سرور مدیریت گزارش‌های ممیزی برای پراکسی‌ها دیگر براساس پراکسی‌ها فیلتر نمی‌شوند
78105568 سرور مدیریت استقرار جاری‌سازی مشترک پس‌از به‌روزرسانی جاری‌سازی مشترک مستقرشده در فراخوانی‌های API مدیریت /org/{org}/sharedflows/{sharedflow}/deployments نشان داده نمی‌شود
77528868 Trireme پسرفت Trireme: سرور Script با کد وضعیت -۱ خارج شد: دارایی ۰ پیدا نشد
73766568 زمان اجرای API ارتقا دادن 170213_02 به 171117_01 باعث افزایش زیاد در تأخیر برای پراکسی با هدف Trireme/Node شد
72710481 زمان اجرای API CacheServiceImpl/CacheMemoryLimiter NullPointerException
68861063 زمان اجرای API مدیریت NPE درطول خاموش کردن رهیاب‌ها
68833699 زمان اجرای API اطلاعات مربوط به اینکه کارگزار میانای برنامه‌سازی کاربردی گاهی از «درخت طبقه‌بندی میانای برنامه‌سازی کاربردی» برداشته نمی‌شود
67377575 هدف‌های میزبانی‌شده عدم تطابق بین گزارش Analytics و آنچه در پراکسی Node.js به مشتری ارسال می‌شود
112481174 هدف‌های میزبانی‌شده عدم موفقیت در لغو استقرار پراکسی به‌دلیل خطای Turbo
117171470 هدف‌های میزبانی‌شده اصلاح پیام خطای نامعتبر بودن app.yaml
67169139 زمان اجرای API قالب مُهر زمان syslog خط‌مشی MessageLogging درست نیست
67165418 زمان اجرای API خطای پروانه درباره استفاده از پردازشگرهای پیام بیشتر حتی زمانی که از تعداد کمتر از پروانه استفاده می‌کنید

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

67165195 زمان اجرای API ‫ValidateSAMLAssertion امضای «ادعای» جاسازی‌شده در «پاسخ امضاشده» را درستی‌سنجی نمی‌کند
66214414 زمان اجرای API متغیر currentstep.flowstate همیشه مقدار \"SHARED_FLOW\" را هنگام ارجاع از یک جریان کار هم‌رسانی‌شده برمی‌گرداند
65731656 زمان اجرای API میانای برنامه‌سازی کاربردی «محافظت دربرابر تهدید» برای درخواست یکسان به‌صورت متناوب ناموفق است
133197060 زمان اجرای API دریافت خطای ۵۷ Gateway timeout از MP به هدف
110535186 زمان اجرای API ‫ServiceCallout بدون عنصر Response و HTTPTargetConnection که به پراکسی اشاره می‌کند: گاهی اوقات تماسی برقرار نمی‌شود
132443137 زمان اجرای API تغییر رفتار «پردازنده پیام» برای نادیده گرفتن سرایندهایی که با X-Apigee-* شروع می‌شوند. درنتیجه، باید هر کدی را که از X-Apigee-* سرایندها استفاده می‌کند بازسازی کنید و آن سرایندها را با سرایندهای پشتیبانی‌شده جایگزین کنید.
125709964 زمان اجرای API نامعتبر کردن حافظه نهان با purgeChildEntries طبق انتظار کار نمی‌کند