19.03.01 - Apigee Edge برای یادداشت های انتشار عمومی Cloud

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

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

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

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

شناسه مسئله نام کامپوننت توضیحات
شرکت Apigee از اول اکتبر ۲۰۱۹ شروع به انتشار به‌روزرسانی‌های زیر کرد.
۱۱۰۹۹۵۰۵ زمان اجرای API

متعادل‌سازی بار - کنترل بیشتر برای حذف سرورهای خراب

هنگام پیکربندی متعادل‌کننده بار برای یک پروکسی API، می‌توانید تعیین کنید که قبل از حذف یک سرور از چرخش متعادل‌کننده بار، چند شکست پاسخ رخ می‌دهد. شکست پاسخ به این معنی است که Apigee هیچ پاسخی از سرور هدف دریافت نمی‌کند. وقتی این اتفاق می‌افتد، شمارنده شکست یک واحد افزایش می‌یابد. وقتی Apigee پاسخی از یک هدف دریافت می‌کند، حتی اگر پاسخ یک خطای HTTP (مانند 500) باشد، آن پاسخ به عنوان پاسخی از سرور هدف محسوب می‌شود و شمارنده شکست بازنشانی می‌شود. برای اطمینان از اینکه پاسخ‌های HTTP بد (مانند 500) نیز شمارنده شکست را افزایش می‌دهند تا یک سرور ناسالم را در اسرع وقت از چرخش متعادل‌کننده بار خارج کنند، می‌توانید یک عنصر جدید <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>
۱۳۰۴۱۶۷۱۵ امنیت

بهبود سیاست‌های کنترل دسترسی

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

<IgnoreTrueClientIPHeader> : اختیاری (پیش‌فرض false است). وقتی این گزینه را روی true تنظیم می‌کنید، سیاست، هدر 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 موجود خود را بهبود بخشیده‌ایم.

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

۱۲۲۶۱۰۲۵ زمان اجرای API به RaiseFault اجازه دهید دلیل خطا و متغیرهای دلخواه را نیز مانند AssignMessage تنظیم کند

دو عنصر جدید در سیاست RaiseFault موجود است تا مدیریت FaultRules را تمیزتر و قدرتمندتر کند.

  • ShortFaultReason یک مقدار بولی است که وقتی روی true تنظیم شود، نام سیاست را در متغیر fault.reason قرار می‌دهد.
  • AssignVariable که در FaultResponse موجود است، به شما امکان می‌دهد پاسخ خطا را به متغیری اختصاص دهید که توسط سایر سیاست‌های موجود در جریان پروکسی API مورد استفاده قرار گیرد.
۱۲۱۱۴۹۸۱۱ اهداف میزبانی شده محدودیت‌های اعمال‌شده برای اهداف میزبانی‌شده

اکنون محدودیت‌ها برای Hosted Targets اعمال می‌شوند. برای جزئیات محدودیت‌ها به بخش محدودیت‌ها مراجعه کنید.

۱۱۷۶۵۹۲۱ زمان اجرای 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>
۱۱۳۵۹۹۸۸۵ نظارت بر API نقش‌های نظارتی API

نظارت بر API دو نقش ارائه می‌دهد: مدیر نظارت بر API و کاربر نظارت بر API، که در Access API Monitoring شرح داده شده‌اند. این نقش‌ها در دسامبر ۲۰۱۸ در دسترس قرار گرفتند.

۱۳۲۲۵۶۷۷۲ زمان اجرای API هدر X-Apigee.Message-Timeout به درخواست اضافه شد

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

۷۸۵۷۵۰۱۸۸ ابر خصوصی / OPDK برای رد کردن ثبت نام فروشگاه داده دروازه، وقتی چندین پاد دروازه وجود دارد، از سرور مدیریت صرف نظر کنید

اشکالات برطرف شد

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

شناسه مسئله نام کامپوننت توضیحات
شرکت Apigee از تاریخ ۳ دسامبر ۲۰۱۹ شروع به انتشار اصلاحات زیر کرد:
اصلاحات امنیتی.
شرکت Apigee از ۲۹ اکتبر ۲۰۱۹ شروع به انتشار اصلاحات زیر کرد:
۱۳۹۳۸۱۷۹۴ سرور مدیریت

خطاهای حذف keystore را مدیریت کنید تا فراخوانی API با شکست مواجه نشود

شرکت Apigee از اول اکتبر ۲۰۱۹ شروع به انتشار اصلاحات زیر کرد:
۱۴۰۷۶۱۳۱۹ زمان اجرای API

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

۱۳۹۰۹۱۶۱۴ زمان اجرای API

در سیاست ResponseCache، NIOTheread بدون رد شدن از سوی thread pool اجرا می‌شود.

۱۳۱۳۳۱۳۰۵ خدمات اصلی

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

۱۳۶۶۹۰۶۴۰ زمان اجرای API

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

۱۴۰۹۴۸۱۰۰ زمان اجرای API

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

Apigee اصلاحات زیر را در ۱۳ سپتامبر ۲۰۱۹ منتشر کرد.
۱۳۲۶۵۴۳۲۱ سرور مدیریت گزارش‌های حسابرسی، داده‌ها را نشان نمی‌دهند
۱۳۱۲۴۶۹۱۱ سرور مدیریت برای ایمیل‌های توسعه‌دهندگان در پورتال، پشتیبانی از دامنه‌های جدیدتر مانند *.games، *.asia را فعال کنید.
Apigee اصلاحات زیر را در ۱۸ آوریل ۲۰۱۹ منتشر کرد.
۱۲۳۸۴۴۵۹۸ سرور مدیریت کلیدهای برنامه حذف شده پس از >24 ساعت دوباره قابل وارد کردن نیستند
۱۲۳۵۸۸۱۵۶ زمان اجرای API حذف هدر Content-Length از پاسخ با خطای 304 مواجه می‌شود.
۱۲۲۷۳۲۴۰ زمان اجرای API تنظیم api.timeout، io.timeout.millis را لغو می‌کند.
۱۲۲۵۴۵۲۸۱ زمان اجرای API ماسک داده DebugSession برای JSON باید حالتی را در نظر بگیرد که jsonPayload یک آرایه باشد.
۱۲۲۳۵۵۸۰۷ سرور مدیریت رفتار نادرست مجوز برای کاربرانی با چندین نقش
۱۲۱۳۹۳۵۵۶ زمان اجرای API x_apigee_fault_code به صورت "org/codehaus/jackson/map/ObjectMapper" تنظیم شده است.
۱۲۰۹۹۸۵۴۸ رابط کاربری اج اشتباه تایپی در پیام خطا: گواهی نامعتبر است یا قابل اعتماد نیست
۱۲۰۹۹۰۹۲۹ زمان اجرای API پاسخ HTTP-413 از Nginx/Apigee-Router نوع سرور را آشکار می‌کند
۱۲۰۷۹۴۸۹ زمان اجرای API هنگام استفاده از httpClient با فراخوانی ناهمزمان جاوا اسکریپت httpComplete()، خروجی debugsession (trace) بی‌صدا می‌شود.
۱۲۰۷۹۴۳۳۹ زمان اجرای API نمایندگان مجلس را به سمت سازماندهی سوق داد
۱۲۰۲۷۷۰۱۱ سرور مدیریت نیاز به اعتبارسنجی ورودی: اگر نام میزبان سرور هدف ** باشد، نمی‌توان پروکسی را مستقر کرد.
۱۱۹۹۷۶۴۱۷ نظارت بر API مانیتورینگ API زمان پاسخ پروکسی بالایی را نشان می‌دهد در حالی که تجزیه و تحلیل زمان پاسخ هدف بالایی را نشان می‌دهد.
۱۱۹۹۴۷۴۸۱ زمان اجرای API در سناریوی استثنا، بار داده‌ای که باید پوشانده شود به صورت متن ساده ثبت می‌شود.
۱۱۹۸۷۷۱۶۴ ابر خصوصی / OPDK روترها خطا می‌دهند، پردازنده پیام با فعال بودن TLS آفلاین می‌شود

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

119816218 زمان اجرای API کش پاسخ، هدر Expires را در صورت رسیدن به ۰ یا عدد منفی نادیده می‌گیرد.
۱۱۹۷۷۰۲۴۲ زمان اجرای API ارتباط روتر با MP ناموفق بود و باعث از کار افتادن کامل شد: خطا در PostClientFlow باعث حلقه بی‌نهایت می‌شود.
۱۱۹۴۴۳۱۴۵ سرور مدیریت پروکسی API هنگام تغییر نام و استقرار مجدد ProxyEndpoint، خطای ۴۰۴ را برمی‌گرداند.
۱۱۹۲۶۰۲۸۱ زمان اجرای API خطای گزارش \"قادر به تجزیه به عنوان string3000.0\" نیست
۱۱۸۷۴۳۴۰۷ سرور مدیریت مدت زمان استقرار پروکسی Apigee
۱۱۸۴۴۷۹۶۶ زمان اجرای API خطا در فراخوانی‌های جاوا اسکریپت تحت نسخه MP 180608_07
۱۱۷۵۴۹۷۱۹ زمان اجرای API عدم تطابق بین URI درخواست و مسیر پایه پروکسی
۱۱۷۲۱۹۵۲۰ زمان اجرای API ثبت پیام: ثبت‌کننده‌ی گزارش سیستم (Syslog logger) از قالب تاریخ نادرستی به عنوان پیش‌فرض استفاده می‌کند و میلی‌ثانیه‌ها را به اشتباه نمایش می‌دهد.
۱۱۷۱۱۶۴۳۵ زمان اجرای API خطاهای متناوب از فایل جاوا اسکریپت
۱۱۷۰۹۱۵۲۰ زمان اجرای API JavaCallouts پس از انتشار پردازنده پیام در تاریخ ۱۸.۰۶.۰۸ از کار می‌افتد
۱۱۶۱۶۵۳۱۸ زمان اجرای API استقرار همزمان یک بسته نرم‌افزاری باعث خطای RepositoryException می‌شود.
116055025 سرویس کانفیگ‌استور پردازشگرهای پیام، میزبان‌های مجازی و برنامه‌های کاربردی را پس از بوت شدن از دست می‌دهند.
۱۱۵۶۱۴۴۹۸ زمان اجرای API Need support for ILB in OPDK

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

۱۱۳۹۷۲۵۳۷ زمان اجرای API چندین P1 - NullPointerException ناشی از کد Node.js در پروکسی‌های Trireme - خطای ۵۰۰ سرور داخلی
113904969 پشتیبانی آپیجی مشکل حذف پروکسی‌های API در سازمان‌های آزمایشی
۱۱۳۵۵۴۸۰۲ زمان اجرای API اعتبارسنجی ادعای SAML با NullPointerException ناموفق بود
۱۱۳۳۱۵۷۳۷ سرور مدیریت استقرار پروکسی به دلیل عدم وجود رکوردهای استقرار در Zookeeper با شکست مواجه شد.
۱۱۲۷۶۷۱۹۵ زمان اجرای API خطاهای متناوب DataStore هنگام دسترسی به خط‌مشی KVM
112162179 زمان اجرای API ذخیره سازی یک شیء جاوا اسکریپت بدون رشته بندی آن می تواند منجر به بن بست شود.
۱۱۱۸۶۰۵۷۶ زمان اجرای API Missing error in Quota policy
۱۱۱۶۷۱۵۲ Hosted Targets کدهای پاسخ ناموفق از اهداف میزبانی‌شده، جریان خطا را در پروکسی فعال می‌کنند.
111523933 Extensions(Connectors) ExtensionCallout policy caching Issue
111420263 API Runtime استثنای ConcurrentModification در MessageLogging
110843526 Management Server API مدیریت برای ایجاد/به‌روزرسانی هوک جریان باید جریان مشترک را اعتبارسنجی کند.
110805739 API Runtime وقتی Reuserefreshtoken مقدار true داشته باشد و تاریخ انقضای توکن refresh به طور صریح تنظیم نشده باشد، TTL در جریان CPS روی -1 تنظیم نمی‌شود.
110429629 API Runtime سیاست BasicAuthentication متغیر request.headers.Authorization را در DebugSession منتشر می‌کند.
۱۱۰۴۲۵۵۰۳ API Runtime Nginx reload causes MP availability issues
110311540 API Runtime NPE when MP is shutting down
110161455 API Runtime AccessEntity باید به جای واکشی همه برنامه‌ها برای سازمان‌های CPS، از روش واکشی بر اساس نام برنامه استفاده کند.
۹۰۶۹۵۵۲۲ زمان اجرای API context.proxyRequest.asForm خطای java.lang.ArrayIndexOutOfBoundsException را با مقدار ۱ تولید می‌کند.
79734096 سرور مدیریت گزارش‌های حسابرسی برای پروکسی‌ها دیگر روی پروکسی‌ها فیلتر نمی‌شوند
۷۸۱۰۵۵۶٨ Management Server پس از به‌روزرسانی یک جریان مشترک مستقر شده، فراخوانی‌های API مدیریت /org/{org}/sharedflows/{sharedflow}/deployments برای استقرارهای جریان مشترک نمایش داده نمی‌شوند.
۷۷۵۲۸۸۶۸ تریریم رگرسیون Trireme: اسکریپت server.js با کد وضعیت -1 خارج شد: ویژگی 0 یافت نشد
۷۳۷۶۵۶۸ API Runtime ارتقاء ۱۷۰۲۱۳_۰۲ به ۱۷۱۱۱۷_۰۱ باعث افزایش شدید تأخیر برای پروکسی با هدف Trireme/Node شد.
72710481 API Runtime خطای NullPointerException در CacheServiceImpl/CacheMemoryLimiter
68861063 زمان اجرای API Handle NPE during shutdown of routers
۶۸۸۳۳۶۹ زمان اجرای API اطلاعات مربوط به پروکسی API که گاهی اوقات از درخت طبقه‌بندی API حذف نمی‌شود
۶۷۳۷۷۵۷۵ اهداف میزبانی شده عدم تطابق بین رکورد تحلیلی و آنچه در پروکسی Node.js به مشتری ارسال می‌شود
۱۱۲۴۸۱۱۷۴ اهداف میزبانی شده به دلیل خطای توربو، پراکسی را از حالت نصب خارج نکنید.
۱۱۷۱۷۱۴۷۰ اهداف میزبانی شده رفع پیام خطای app.yaml نامعتبر
۶۷۱۶۹۱۳۹ زمان اجرای API قالب مهر زمانی syslog مربوط به سیاست MessageLogging صحیح نیست.
۶۷۱۶۵۴۱۸ زمان اجرای API خطای مجوز در مورد استفاده از پردازنده‌های پیام بیشتر حتی هنگام استفاده کمتر از مقدار مجوز

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

۶۷۱۶۵۱۹۵ زمان اجرای API ValidateSAMLAsertion امضای یک Assertion که در یک پاسخ امضا شده تعبیه شده است را تأیید نمی‌کند.
۶۶۲۱۴۴۱۴ زمان اجرای API متغیر currentstep.flowstate همیشه وقتی از یک جریان مشترک ارجاع داده شود، \"SHARED_FLOW\" را برمی‌گرداند
۶۵۷۳۱۶۵۶ زمان اجرای API API محافظت در برابر تهدید برای همان درخواست به طور متناوب از کار می‌افتد.
۱۳۳۱۹۷۰۶۰ زمان اجرای API دریافت ۵۷ تایم اوت دروازه از نماینده مجلس به هدف
۱۱۰۵۳۵۱۸۶ زمان اجرای API ServiceCallout بدون عنصر پاسخ و HTTPTargetConnection که به پروکسی اشاره می‌کند: گاهی اوقات فراخوانی انجام نمی‌شود
۱۳۲۴۴۳۱۳۷ زمان اجرای API رفتار پردازشگر پیام را طوری تغییر دهید که هدرهایی که با X-Apigee-* شروع می‌شوند را نادیده بگیرد. در نتیجه، شما باید هر کدی را که از هدرهای X-Apigee-* استفاده می‌کند، اصلاح کرده و آن هدرها را با هدرهای پشتیبانی‌شده جایگزین کنید.
۱۲۵۷۰۹۶۴ زمان اجرای API نامعتبر کردن حافظه پنهان با purgeChildEntries که طبق انتظار کار نمی‌کند