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

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

سه‌شنبه، 3 دسامبر 2019، انتشار به‌روزرسانی این نسخه از Apigee Edge را برای Public Cloud آغاز کردیم. (نسخه اصلی پنجشنبه، 18 آوریل 2019 بود.)

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

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

شناسه شماره نام مؤلفه توضیحات
Apigee انتشار به روز رسانی های زیر را در 1 اکتبر 2019 آغاز کرد
110995050 API Runtime

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

هنگام پیکربندی یک متعادل کننده بار برای یک پروکسی 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>
130416715 امنیت

بهبود خط مشی AccessControl

خط مشی AccessControl تعیین می کند که کدام آدرس IP می تواند با یک پراکسی API تماس برقرار کند. یک عنصر جدید در آن خط مشی به توسعه دهندگان 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 به روز رسانی های زیر را در 18 آوریل 2019 منتشر کرد
117558815،
119856499،
110548137،
79526748،
72989449،
70712859،
69049041		 API Runtime JWS و JWT
ما خط‌مشی‌های جدیدی را برای پشتیبانی JWS اضافه کرده‌ایم و خط‌مشی‌های JWT موجود خود را بهبود بخشیده‌ایم.

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

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

دو عنصر جدید در خط مشی RaiseFault موجود است تا مدیریت خطاها را تمیزتر و قدرتمندتر کند.

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

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

117659213 API Runtime محدوده 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 مانیتورینگ API نقش های نظارت API

API Monitoring دو نقش را ارائه می دهد: مدیر نظارت API و کاربر نظارت بر API، که در Access API Monitoring توضیح داده شده است. اینها در دسامبر 2018 در دسترس قرار گرفتند.

132256772 API Runtime هدر X-Apigee.Message-Timeout به درخواست اضافه شد

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

78575018 ابر خصوصی / OPDK از سرور مدیریت پرش کنید تا در هنگام وجود چندین دروازه از ثبت نام در فروشگاه داده پرش کنید

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

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

شناسه شماره نام مؤلفه توضیحات
Apigee انتشار اصلاحات زیر را در 3 دسامبر 2019 آغاز کرد
اصلاحات امنیتی
Apigee انتشار اصلاحات زیر را در 29 اکتبر 2019 آغاز کرد
139381794 سرور مدیریت

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

Apigee شروع به انتشار اصلاحات زیر در 1 اکتبر 2019 کرد
140761319 API Runtime

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

139091614 API Runtime

در خط‌مشی ResponseCache، NIOTheread بدون رد شدن از Thread Pool اجرا می‌شود.

131331305 خدمات اصلی

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

136690640 API Runtime

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

140948100 API Runtime

اجرا نشدن جریان اشتراکی در برخی از پردازشگرهای پیام

Apigee اصلاحات زیر را در 13 سپتامبر 2019 منتشر کرد
132654321 سرور مدیریت گزارش‌های حسابرسی داده‌ها را نشان نمی‌دهند
131246911 سرور مدیریت برای ایمیل‌های برنامه‌نویس در پورتال، پشتیبانی از دامنه‌های جدیدتر مانند *.games، *.asia را فعال کنید.
Apigee اصلاحات زیر را در 18 آوریل 2019 منتشر کرد
123844598 سرور مدیریت کلیدهای برنامه حذف شده را نمی توان بعد از 24 ساعت دوباره وارد کرد
123588156 API Runtime حذف هدر Content-Length از پاسخ با 304 انجام نمی شود
122732400 API Runtime تنظیم api.timeout io.timeout.millis را لغو می کند
122545281 API Runtime DebugSession Data mask برای JSON باید مواردی را در نظر بگیرد که در آن jsonPayload یک آرایه است
122355807 سرور مدیریت رفتار مجوز نادرست برای کاربران با نقش های متعدد
121393556 API Runtime x_apigee_fault_code به عنوان "org/codehaus/jackson/map/ObjectMapper" تنظیم شده است
120998548 رابط کاربری لبه اشتباه تایپی در پیام خطا: گواهی نامعتبر است یا نمی توان به آن اعتماد کرد
120990929 API Runtime پاسخ HTTP-413 از Nginx/Apigee-Router نوع سرور را نشان می دهد
120799489 API Runtime هنگام استفاده از httpClient با پاسخ تماس ناهمزمان جاوا اسکریپت httpComplete()، خروجی Debugsession (trace) قطع می شود.
120794339 API Runtime نمایندگان مجلس را برای تشکیلات منحرف کردند
120277011 سرور مدیریت نیاز به اعتبارسنجی ورودی: اگر نام میزبان سرور هدف دارای ** باشد، قادر به استقرار پروکسی نیست.
119976417 مانیتورینگ API مانیتورینگ API زمان پاسخ پراکسی بالایی را نشان می دهد در حالی که تجزیه و تحلیل زمان پاسخ هدف بالا را نشان می دهد
119947481 API Runtime در سناریوی استثنایی، باری که قرار است پوشانده شود به عنوان متن ساده ثبت می شود
119877164 ابر خصوصی / OPDK روترها خطا ایجاد می کنند، پردازشگر پیام با فعال بودن TLS آفلاین می شود

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

119816218 API Runtime حافظه پنهان پاسخ، سرصفحه را نادیده می گیرد اگر به عدد 0 یا منفی تبدیل شود، منقضی می شود
119770242 API Runtime ارتباط روتر به MP شکست خورد و باعث از کار افتادن کامل شد: خطا در PostClientFlow باعث ایجاد حلقه بی نهایت می شود
119443145 سرور مدیریت پروکسی API زمانی که ProxyEndpoint تغییر نام داده و مجدداً مستقر می شود، 404 را برمی گرداند
119260281 API Runtime خطای گزارش "تجزیه به عنوان string3000.0 ممکن نیست".
118743407 سرور مدیریت مدت زمان استقرار پروکسی Apigee
118447966 API Runtime خطا در Callouts جاوا اسکریپت تحت MP Release 180608_07
117549719 API Runtime عدم تطابق بین URI درخواست و مسیر پایه پروکسی
117219520 API Runtime MessageLogging: Logger Syslog از قالب تاریخ نادرست به عنوان پیش فرض استفاده می کند، میلی ثانیه را به اشتباه نمایش می دهد.
117116435 API Runtime خطاهای متناوب از فایل جاوا اسکریپت
117091520 API Runtime JavaCallout پس از انتشار پردازشگر پیام در تاریخ 18.06.08 با شکست مواجه می شود
116165318 API Runtime استقرار همزمان یک بسته باعث ایجاد RepositoryException می شود
116055025 سرویس Configstore پردازنده‌های پیام پس از راه‌اندازی، میزبان‌ها و برنامه‌های مجازی را از دست داده‌اند
115614498 API Runtime نیاز به پشتیبانی برای ILB در OPDK

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

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

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

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