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

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

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

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

مرور کلی انتشار

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

احراز هویت SAML مزایای متعددی را ارائه می‌دهد. با استفاده از SAML می‌توانید:

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

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

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

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

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

استهلاک و بازنشستگی

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

منسوخ‌شده‌ها

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

مخزن امن Apigee که با نام "vaults" نیز شناخته می‌شود، منسوخ شده و در آوریل ۲۰۱۸ بازنشسته خواهد شد. Vaults که ذخیره‌سازی رمزگذاری‌شده جفت‌های کلید/مقدار را فراهم می‌کنند، با API مدیریت ایجاد می‌شوند و در زمان اجرا با توابعی در ماژول apigee-access Node.js قابل دسترسی هستند.

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

منسوخ شدن افزودن مسیرها در تب عملکرد پروکسی API

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

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

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

ابر خصوصی

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

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

به بخش پشتیبانی از SAML در Edge برای Private Cloud مراجعه کنید.

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

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

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

(داس-۵۱۱۸)

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

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

به تبدیل یک پورتال مبتنی بر tar به یک پورتال مبتنی بر RPM مراجعه کنید.

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

اکنون می‌توانید Edge را برای Private Cloud، API BaaS و پورتال خدمات توسعه‌دهندگان در Red Hat/CentOS نسخه ۷.۴ پیاده‌سازی کنید.

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

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

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

ENABLE_SYSTEM_CHECK=y 

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

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

(داس-۴۷۷۲)

ویژگی اضافه شده است تا به شما امکان دهد آدرس IP مورد استفاده توسط نصب کننده را روی سروری که چندین کارت رابط دارد، انتخاب کنید.

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

ENABLE_DYNAMIC_HOSTIP=y

با تنظیم این ویژگی روی "y"، نصب‌کننده از شما می‌خواهد که آدرس IP مورد استفاده در فرآیند نصب را انتخاب کنید. مقدار پیش‌فرض "n" است.

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

(داس-۵۱۱۷)

گزینه‌های رابط کاربری و APIهای جدید برای پیکربندی TLS در دسترس هستند.

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

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

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

• استفاده از رابط کاربری Edge Cloud برای ایجاد Keystoreها و Truststoreها
• استفاده از Edge API برای ایجاد Keystoreها و Truststoreها

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

• گزینه‌های پیکربندی TLS
• پیکربندی دسترسی TLS به یک API برای فضای ابری
• پیکربندی TLS از Edge تا backend
• به‌روزرسانی گواهی TLS برای فضای ابری

(EDGEUI-1058)

دستور رمز عبور مبهم اضافه شد

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

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

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

OBF:58fh40h61svy156789gk1saj
MD5:902fobg9d80e6043b394cb2314e9c6

به پیکربندی TLS/SSL برای Edge On Premises مراجعه کنید.

(تاریخ انتشار نامشخص-۲۵۰)

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

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

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

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

به بازنشانی رمزهای عبور Edge مراجعه کنید.

(DBS-1733)

دستور غیرفعال کردن TLS را در رابط کاربری Edge اضافه کنید

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

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

برای رابط کاربری مدیریت، به پیکربندی TLS مراجعه کنید.

(EDGEUI-1114)

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

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

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

برای مثال:

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

شما می‌توانید از ویژگی conf_system_apigee.syslogger.dateFormat در Edge Message Processor برای کنترل آن فرمت استفاده کنید.

به سیاست ثبت پیام مراجعه کنید.

(APIRT-4196)

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

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

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

(APIBAAS-2103)

پشتیبانی اضافه شده است تا به Edge Router و وب سرور Nginx برای پورتال اجازه دسترسی به پورت‌های زیر ۱۰۰۰ را بدهد.

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

نحوه پیکربندی سطح ثبت وقایع برای رابط کاربری Edge تغییر کرد.

ویژگی‌های مورد استفاده برای پیکربندی سطح ثبت وقایع برای رابط کاربری Edge تغییر کرده‌اند. برای ویژگی‌ها و رویه‌های جدید ، به تنظیم سطح ثبت وقایع برای یک مؤلفه Edge مراجعه کنید.

(EDGEUI-886)

خدمات API

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

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

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

اعتبارسنجی نام Keystore و سرور هدف

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

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

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

ابر خصوصی ۴.۱۷.۰۹

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

ابر ۱۷.۰۸.۱۶ (رابط کاربری)

ابر ۱۷.۰۸.۱۴ (مدیریت API و زمان اجرا)

ابر ۱۷.۰۷.۳۱ (مدیریت API)

ابر ۱۷.۰۷.۱۷ (مدیریت API و زمان اجرا)

فضای ابری ۱۷.۰۶.۲۰ (رابط کاربری)

ابر ۱۷.۰۶.۱۴ (رابط کاربری)

ابر ۱۷.۰۵.۲۲.۰۱ (کسب درآمد)

ابر ۱۷.۰۵.۲۲ (رابط کاربری)

ابر ۱۷.۰۵.۲۲ (مدیریت API)

ابر ۱۷.۰۵.۰۸ (رابط کاربری)

ابر ۱۷.۰۴.۲۲ (مدیریت API)

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

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