‫4.17.09 - یادداشت‌های انتشار Edge for Private Cloud

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

از زمان انتشار ویژگی قبلی Edge for Private Cloud، نسخه‌های پخش زیر منتشر شده‌اند و در این «انتشار ویژگی» گنجانده شده‌اند:

برای اینکه بفهمید آیا نسخه ابری خاصی در نسخه Edge for Private Cloud شما گنجانده شده است یا نه، به درباره شماره‌گذاری نسخه مراجعه کنید.

نمای کلی نسخه پخش

مهم‌ترین ویژگی جدید در این نسخهٔ پخش، افزودن پشتیبانی از «زبان نشانه‌گذاری بیانیه امنیتی» (SAML) 2.0 به‌عنوان سازوکار اصالت‌سنجی برای Edge،‏ API BaaS، و درگاه «خدمات توسعه‌دهندگان» است. بااستفاده از SAML با Edge، می‌توانید از SSO برای «میانای کاربری Edge» و API علاوه‌بر هر سرویس دیگری که ارائه می‌دهید و از SAML پشتیبانی می‌کند، پشتیبانی کنید.

اصالت‌سنجی SAML مزایای متعددی دارد. بااستفاده از SAML می‌توانید:

• کنترل کامل مدیریت کاربر را دردست بگیرید. وقتی کاربران سازمانتان را ترک می‌کنند و به‌صورت مرکزی لغو تخصیص می‌شوند، دسترسی آن‌ها به Edge به‌طور خودکار رد می‌شود.
• نحوه اصالت‌سنجی کاربران برای دسترسی به Edge را کنترل کنید. می‌توانید انواع مختلفی از اصالت‌سنجی را برای سازمان‌های مختلف Edge انتخاب کنید.
• خط‌مشی‌های اصالت‌سنجی را کنترل کنید. ارائه‌دهنده SAML شما ممکن است از خط‌مشی‌های اصالت‌سنجی که بیشتر با استانداردهای شرکت شما مطابقت دارند پشتیبانی کند.
• می‌توانید ورودها، خروج‌ها، تلاش‌های ناموفق برای ورود به سیستم، و فعالیت‌های پرخطر را در استقرار Edge خود پایش کنید.
• توجه داشته باشید که SAML فقط برای اصالت‌سنجی استفاده می‌شود. مجوز همچنان توسط نقش‌های کاربر Edge کنترل می‌شود.

برای اطلاعات بیشتر، پشتیبانی از SAML در Edge برای «ابر خصوصی» را ببینید.

این نسخه شامل تعدادی ویژگی قابل‌توجه دیگر نیز می‌شود، ازجمله:

• امکان انتقال دادن درگاه «خدمات توسعه‌دهندگان» از Apache/MySQL به Postgres/Nginx
• فرمان غیرفعال کردن «امنیت لایه انتقال» در «واسط کاربر Edge»
• دارایی‌های جدید برای پیکربندی نصب Edge
• قوانین نام‌گذاری کلید مصرف‌کننده سفارشی و رمز
• پشتیبانی از Red Hat/CentOS نسخه ۷.۴

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

منسوخ شدن و بازنشستگی

ویژگی‌های زیر در این نسخه منسوخ یا بازنشسته شده‌اند. برای اطلاعات بیشتر، خط‌مشی منسوخ شدن Edge را ببینید.

منسوخ‌سازی‌ها

منسوخ شدن فروشگاه ایمن Apigee (گاوصندوق‌ها)

فروشگاه امن Apigee که با نام «گاوصندوق» نیز شناخته می‌شود، درحال منسوخ شدن است و در آوریل ۲۰۱۸ بازنشسته خواهد شد. گاوصندوق‌ها که فضای ذخیره‌سازی رمزگذاری‌شده جفت‌های کلید/مقدار را فراهم می‌کنند، بااستفاده از مدیریت API ایجاد می‌شوند و در زمان اجرا با توابع موجود در واحد apigee-access Node.js به آن‌ها دسترسی پیدا می‌شود.

به‌جای استفاده از فروشگاه امن، از نقشه‌های مقدار کلید رمزگذاری‌شده (KVM) استفاده کنید، همان‌طور که در کار با نقشه‌های مقدار کلید توضیح داده شده است. «KVM» رمزگذاری‌شده به‌اندازه گاوصندوق‌ها ایمن است و گزینه‌های بیشتری برای ایجاد و بازیابی ارائه می‌دهد. (MGMT-3848)

منسوخ شدن افزودن مسیرها در زبانه «عملکرد» کارگزار میانای برنامه‌سازی کاربردی

تا پیش‌از این نسخه، می‌توانستید در میانای کاربری مدیریت به یک پراکسی API پیمایش کنید، به برگه «عملکرد» بروید، و مسیرهای مختلفی برای مقایسه نموداری در برگه «عملکرد» پراکسی و در داشبورد «تراکنش‌های کسب‌وکار» ایجاد کنید. این ویژگی اکنون منسوخ شده است و دیگر در واسط کاربر دردسترس نیست. برای جایگزینی این عملکرد، مقاله زیر از Apigee Community را ببینید: جایگزین میانای برنامه‌سازی کاربردی تراکنش‌های کسب‌وکار. (EDGEUI-902)

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

در این نسخه پخش، ویژگی‌های جدید و موارد بهبودیافته زیر ارائه شده است. علاوه‌بر بهبودهای زیر، این نسخهٔ پخش شامل چندین بهبود در کارایی، عملکرد، امنیت، و پایداری نیز می‌شود.

فضای ابری خصوصی

پشتیبانی از SAML به Edge،‏ API BaaS، و درگاه «خدمات توسعه‌دهندگان» اضافه شد

اکنون Edge از «زبان نشانه‌گذاری بیانیه امنیتی» (SAML) 2.0 به‌عنوان سازوکار اصالت‌سنجی برای Edge،‏ API BaaS، و درگاه «خدمات توسعه‌دهنده» پشتیبانی می‌کند. ‫SAML از محیط ورود به سیستم یک‌بار (SSO) پشتیبانی می‌کند. بااستفاده از SAML، می‌توانید علاوه‌بر هر سرویس دیگری که ارائه می‌دهید و از SAML پشتیبانی می‌کند، از SSO برای Edge نیز پشتیبانی کنید.

پشتیبانی از SAML در Edge برای «ابر خصوصی» را ببینید.

ابزار apigee-ssoadminapi.sh اضافه شد

پس‌از فعال کردن SAML، اکنون از apigee-ssoadminapi.sh جدید برای انجام بسیاری از وظایف مدیریتی، مانند ایجاد کاربران و سازمان‌ها، استفاده می‌کنید.

استفاده از apigee-ssoadminapi.sh را ببینید.

(DOS-5118)

اکنون می‌توانید درگاه «سرویس‌های توسعه‌دهندگان» را از Apache/MySQL/MariaDB به Nginx/postgres انتقال دهید

نصب مبتنی بر tar درگاه «خدمات توسعه‌دهندگان» از Apache و MySQL یا MariaDB استفاده می‌کند. اکنون می‌توانید نصب موجود درگاه را برای استفاده از Nginx و Postgres انتقال دهید. اگر می‌خواهید به نسخه ۴.۱۷.۰۹ درگاه به‌روزرسانی کنید، این انتقال الزامی است.

تبدیل درگاه مبتنی بر tar به درگاه مبتنی بر RPM را ببینید.

پشتیبانی از Red Hat/CentOS نسخه ۷.۴ اضافه شد

اکنون می‌توانید Edge را برای «ابر خصوصی»، API BaaS، و درگاه «خدمات توسعه‌دهنده» در Red Hat/CentOS نسخه ۷.۴ مستقر کنید.

نرم‌افزار پشتیبانی‌شده و نسخه‌های پشتیبانی‌شده را ببینید.

دارایی اضافه شد تا نصب‌کننده درطول نصب، الزامات CPU و حافظه را بررسی کند

فایل پیکربندی نصب Edge اکنون از ویژگی زیر پشتیبانی می‌کند:

ENABLE_SYSTEM_CHECK=y 

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

به مرجع فایل پیکربندی Edge مراجعه کنید.

(DOS-4772)

دارایی اضافه شد تا به شما امکان دهد نشانی IP مورداستفاده نصب‌کننده را در سروری که چندین کارت واسط دارد انتخاب کنید

اگر سروری چند کارت واسط داشته باشد، فرمان «hostname -i» فهرستی از نشانی‌های IP را که با فاصله از هم جدا شده‌اند برمی‌گرداند. به‌طور پیش‌فرض، نصب‌کننده Edge از اولین نشانی IP برگشتی استفاده می‌کند که ممکن است در همه شرایط صحیح نباشد. به‌عنوان جایگزین، می‌توانید دارایی زیر را در فایل پیکربندی نصب تنظیم کنید:

ENABLE_DYNAMIC_HOSTIP=y

با تنظیم این دارایی روی «y»، نصب‌کننده از شما می‌خواهد نشانی IP را برای استفاده به‌عنوان بخشی از نصب انتخاب کنید. مقدار پیش‌فرض «n» است.

به مرجع فایل پیکربندی Edge مراجعه کنید.

(DOS-5117)

گزینه‌های جدید واسط کاربر و میاناهای برنامه‌سازی کاربردی برای پیکربندی «امنیت لایه انتقال» دردسترس است

نسخه بتای ویژگی جدید خودیاری TLS/SSL برای Cloud اکنون در Private Cloud به‌عنوان ویژگی بتا دردسترس است. بااستفاده از این نسخه بتا می‌توانید:

• ایجاد، اصلاح، و حذف کردن keystore و truststore در واسط کاربر و همچنین API
• بارگذاری گواهینامه‌های «امنیت لایه انتقال» به‌عنوان PKCS12/PFX
• تولید گواهی‌های خودامضا از «میانای کاربر» یا «میانای برنامه‌سازی کاربردی»
• آزمایش اعتبار keystore یا truststore در واسط کاربر

مستندات نسخه بتا (PDF) برای این ویژگی‌ها در اینجا دردسترس است:

• استفاده از «واسط کاربر Edge Cloud» برای ایجاد «انبار کلید» و «انبار اعتماد»
• استفاده از Edge API برای ایجاد «فروشگاه کلید» و «فروشگاه اعتماد»

برای جزئیات کامل، به اسناد تکمیلی (PDF) مراجعه کنید:

• گزینه‌های پیکربندی «امنیت لایه انتقال»
• پیکربندی دسترسی «امنیت لایه انتقال» به یک API برای Cloud
• پیکربندی «امنیت لایه انتقال» از Edge به زیرینه
• به‌روزرسانی گواهینامه TLS برای Cloud

(EDGEUI-1058)

فرمان گذرواژه مبهم اضافه شد

فرمانی برای تولید گذرواژه مبهم اضافه شد تا هر مؤلفه‌ای بتواند گذرواژه رمزگذاری‌شده تولید کند. بااستفاده از دستور زیر در «سرور مدیریت Edge» می‌توانید گذرواژه مبهم‌سازی‌شده تولید کنید:

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server generate-obfuscated-password

گذرواژه جدید را وارد کنید و سپس آن را در پیام‌واره تأیید کنید. به‌دلایل امنیتی، نوشتار گذرواژه نمایش داده نمی‌شود. این فرمان گذرواژه را در قالب زیر برمی‌گرداند:

OBF:58fh40h61svy156789gk1saj
MD5:902fobg9d80e6043b394cb2314e9c6

پیکربندی «امنیت لایه انتقال»/ SSL برای Edge On Premises را ببینید.

(TBD-250)

فرمان جدیدی برای مبهم‌سازی گذرواژه جدید هنگام تغییر گذرواژه کاربر سازمان اضافه شد

برای بازنشانی گذرواژه کاربر سازمان، اکنون از ابزار apigee-service برای فراخوانی apigee-openldap استفاده می‌کنید:

> /opt/apigee/apigee-service/bin/apigee-service apigee-openldap change-ldap-user-password -u userEmail

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

بازنشانی گذرواژه‌های Edge را ببینید.

(DBS-1733)

افزودن فرمان برای غیرفعال کردن TLS در «واسط کاربر Edge»

اکنون می‌توانید از فرمان زیر برای غیرفعال کردن «امنیت لایه انتقال» در «واسط کاربر Edge» استفاده کنید:

/opt/apigee/apigee-service/bin/apigee-service edge-ui disable-ssl

پیکربندی «امنیت لایه انتقال» برای واسط کاربر مدیریت را ببینید.

(EDGEUI-1114)

خصوصیتی برای کنترل قالب مُهر زمان در پیام‌های گزارش اضافه شد

به‌طور پیش‌فرض، مُهر زمان در پیام‌های گزارش ایجادشده توسط خط‌مشی «گزارش‌گیری پیام» دارای قالب زیر است:

yyyy-MM-dd'T'HH:mm:ss.sssZ

برای مثال:

2017-05-08T13:33:00.000+0000

می‌توانید از دارایی conf_system_apigee.syslogger.dateFormat در «پردازشگر پیام Edge» برای کنترل آن قالب استفاده کنید.

خط‌مشی «گزارش پیام» را ببینید.

‫(APIRT-4196)

پارامتر پیکربندی SMTP موردنیاز جدید به نصب API BaaS اضافه شد

اکنون باید از پارامتر SMTPMAILFROM در فایل پیکربندی نصب API BaaS استفاده کنید. این پارامتر نشانی ایمیلی را که هنگام ارسال ایمیل‌های خودکارسازی‌شده توسط API BaaS استفاده می‌شود مشخص می‌کند، مثلاً زمانی که کاربر درخواست می‌کند گذرواژه‌اش بازنشانی شود.

به مرجع فایل پیکربندی BaaS مراجعه کنید.

(APIBAAS-2103)

پشتیبانی برای اجازه دادن به «رهیاب Edge» و کارساز وب Nginx برای دسترسی به درگاه‌های زیر ۱۰۰۰ به درگاه اضافه شد

اکنون می‌توانید از سرور وب «روتر» و Nginx برای درگاه استفاده کنید تا بدون نیاز به اجرای آن‌ها به‌عنوان کاربر متفاوت، به درگاه‌های زیر ۱۰۰۰ دسترسی داشته باشید. در نسخه‌های قبلی، سرور وب «روتر» و Nginx نمی‌توانستند بدون اجرای آن‌ها به‌عنوان کاربر ویژه، به درگاه‌های زیر ۱۰۰۰ دسترسی داشته باشند.

نحوه پیکربندی سطح گزارش‌گیری برای «واسط کاربر Edge» تغییر کرد

دارایی‌های مورداستفاده برای پیکربندی سطح گزارش‌گیری برای «واسط کاربر Edge» تغییر کرده است. برای ویژگی‌ها و رویه جدید، تنظیم سطح گزارش برای عنصر Edge را ببینید.

(EDGEUI-886)

سرویس‌های API

قوانین نام‌گذاری کلید مصرف‌کننده سفارشی و رمز

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

فرایند ایجاد کلید/رمز سفارشی به‌طور کامل در وارد کردن کلیدها و رمزهای مصرف‌کننده موجود مستند شده است. (MGMT-3916)

اعتبارسنجی نام «سرور هدف» و «انبار کلید»

نام‌های انبار کلید و «سرورهای هدف» می‌توانند حداکثر ۲۵۵ نویسه داشته باشند و می‌توانند حاوی حروف، اعداد، فاصله‌ها، خط تیره، زیرخط، و نقطه باشند. ‫Edge اکنون این را در زمان ایجاد اعتبارسنجی می‌کند. (MGMT-4098)

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

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

Private Cloud 4.17.09

connect.ranges.denied=
connect.ranges.allowed=
connect.ports.allowed=

Cloud 17.08.16 (UI)

Cloud 17.08.14 (مدیریت میانای برنامه‌سازی کاربردی و زمان اجرا)

Cloud 17.07.31 (مدیریت میانای برنامه‌سازی کاربردی)

Cloud 17.07.17 (مدیریت میانای برنامه‌سازی کاربردی و زمان اجرا)

Cloud 17.06.20 (UI)

Cloud 17.06.14 (UI)

Cloud 17.05.22.01 (درآمدزایی)

Cloud 17.05.22 (UI)

Cloud 2022/05/17 (مدیریت میانای برنامه‌سازی کاربردی)

Cloud 17.05.08 (UI)

Cloud 2022/04/17 (مدیریت میانای برنامه‌سازی کاربردی)

مشکلات شناخته‌شده

این نسخه پخش مشکلات شناخته‌شده زیر را دارد: