انتقال به «واسط کاربر Edge جدید»

با شروع Apigee Edge برای Private Cloud 4.54.00، واسط کاربر کلاسیک (edge-ui) برداشته شده است و واسط کاربر New Edge‏ (edge-management-ui) واسط مدیریت پیش‌فرض است. این بخش راهنمایی‌هایی برای انتقال از «واسط کاربر کلاسیک» به «واسط کاربر Edge جدید» ارائه می‌دهد، ازجمله استقرارهایی که از IDP مانند LDAP یا SAML استفاده می‌کنند.

برای اطلاعات بیشتر، به اینجا مراجعه کنید:

چه کسی می‌تواند انتقال را انجام دهد

برای انتقال به New Edge UI، باید به‌عنوان کاربری که در ابتدا Edge را نصب کرده است یا به‌عنوان کاربر ریشه به سیستم وارد شوید. پس‌از اجرای نصب‌کننده برای «رابط کاربری New Edge»، هر کاربر مجاز می‌تواند آن را پیکربندی کند.

قبل‌از شروع

قبل‌از انتقال از «میانای کاربری کلاسیک» به «میانای کاربری Edge جدید»، دستورالعمل‌های کلی زیر را بخوانید:

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

    قبل‌از ارتقا به نسخه ۴.۵۴.۰۰، Apigee توصیه می‌کند از فایل‌های پیکربندی «رابط کاربری کلاسیک» موجود پشتیبان‌گیری کنید تا بتوانید تنظیمات سفارشی (مانند SMTP،‏ TLS، مهلت جلسه، و ویژگی‌های نمانام‌سازی) را به /opt/apigee/customer/application/management-ui.properties منتقل کنید.

  • درگاه‌ها/دیوارهای آتش

    به‌طور پیش‌فرض، «رابط کاربری کلاسیک» از درگاه ۹۰۰۰ استفاده می‌کرد. «واسط کاربر Edge جدید» از درگاه ۳۰۰۱ استفاده می‌کند (بااستفاده از conf_uebe_port قابل پیکربندی است).

  • برداشتن میانای کاربر کلاسیک

    اگر «میانای کاربر Edge جدید» را روی گره‌ای نصب می‌کنید که قبلاً میزبان «میانای کاربر کلاسیک» بوده است، «میانای کاربر کلاسیک» (edge-ui) را قبل‌از نصب «میانای کاربر Edge جدید» (edge-management-ui) حذف نصب کنید.

  • اصالت‌سنجی (اصالت‌سنجی پایه، LDAP، یا SAML)

    در Edge برای Private Cloud نسخه ۴.۵۴.۰۰، «رابط کاربری New Edge» هم از اصالت‌سنجی «پایه» (AUTH_MODE=basic) و هم از اصالت‌سنجی IDP خارجی ازطریق Apigee SSO‏ (AUTH_MODE=sso) پشتیبانی می‌کند:

    • اصالت‌سنجی پایه: از پیاده‌سازی داخلی OpenLDAP (apigee-openldap) بدون نیاز به SSO استفاده می‌کند.
    • LDAP IDP (بااستفاده از Apigee SSO): از LDAP IDP خارجی یا پیاده‌سازی OpenLDAP (apigee-openldap) داخلی با Apigee SSO استفاده می‌کند.
    • SAML IDP (بااستفاده از Apigee SSO): از SAML IDP خارجی با Apigee SSO استفاده می‌کند.

    برای اطلاعات بیشتر، نصب و پیکربندی ارائه‌دهندگان هویت را ببینید.

  • ‫IDP یکسان

    این بخش فرض می‌کند که پس‌از انتقال از همان IDP استفاده خواهید کرد. برای مثال، اگر قبلاً از «ارائه‌دهنده هویت LDAP خارجی» با «میانای کاربر کلاسیک» استفاده می‌کردید، همچنان از «ارائه‌دهنده هویت LDAP خارجی» با «میانای کاربر New Edge» استفاده خواهید کرد.

انتقال با IdP داخلی LDAP

اگر از پیاده‌سازی داخلی OpenLDAP (apigee-openldap) استفاده می‌کنید، می‌توانید از اصالت‌سنجی «پایه» مستقیماً در میانای کاربر New Edge استفاده کنید (به پیکربندی میانای کاربر New Edge مراجعه کنید) یا بااستفاده از دستورالعمل‌های زیر، Apigee SSO را با LDAP داخلی پیکربندی کنید:

  • پیکربندی LDAP و New Edge UI

    بااستفاده از پیکربندی New Edge UI، نصب و پیکربندی Apigee SSO، و پیکربندی LDAP IDP، New Edge UI و Apigee SSO را نصب و پیکربندی کنید.

  • اصالت‌سنجی پایه برای Management API

    وقتی Apigee SSO فعال باشد، اصالت‌سنجی پایه برای میاناهای برنامه‌سازی کاربردی همچنان به‌طور پیش‌فرض برای همه کاربران LDAP کار می‌کند. می‌توانید اصالت‌سنجی «پایه» را به‌صورت اختیاری غیرفعال کنید، همان‌طور که در غیرفعال کردن اصالت‌سنجی «پایه» در Edge توضیح داده شده است.

  • اصالت‌سنجی OAuth2 برای «میانای برنامه‌سازی کاربردی مدیریت»

    وقتی «ورود به سیستم واحد Apigee» را فعال می‌کنید، اصالت‌سنجی مبتنی بر کد فعال می‌شود.

انتقال با «ارائه‌دهنده هویت» ال‌دپ خارجی

هنگام انتقال از «واسط کاربر قدیمی» به «واسط کاربر Edge جدید» در پیکربندی‌ای که از پیاده‌سازی LDAP خارجی به‌عنوان IDP استفاده می‌کند، از دستورالعمل‌های زیر استفاده کنید:

  • پیکربندی LDAP

    «میانای برنامه‌سازی کاربردی Apigee» و «میانای کاربر Edge جدید» را بااستفاده از پیکربندی «میانای کاربر Edge جدید»، نصب و پیکربندی «میانای برنامه‌سازی کاربردی Apigee»، و پیکربندی «ارائه‌دهنده هویت LDAP» پیکربندی کنید.

  • پیکربندی سرور مدیریت

    پس‌از فعال کردن «شناسایی یگانه Apigee»، همه دارایی‌های خارجی «میانای کاربر کلاسیک» قدیمی LDAP را از /opt/apigee/customer/application/management-server.properties فایل بردارید و «سرور مدیریت» را بازراه‌اندازی کنید.

  • اصالت‌سنجی پایه برای Management API

    اصالت‌سنجی پایه برای کاربران ماشین کار می‌کند اما برای کاربران خارجی LDAP کار نمی‌کند. اگر فرایند CI/CD شما از «اصالت‌سنجی پایه» برای دسترسی به سیستم استفاده می‌کند، این مورد حیاتی است.

  • اصالت‌سنجی OAuth2 برای «میانای برنامه‌سازی کاربردی مدیریت»

    کاربران LDAP خارجی بااستفاده از نشان‌های OAuth2 به مدیریت API دسترسی پیدا می‌کنند.

انتقال با SAML IDP خارجی

هنگام انتقال به New Edge UI، هیچ تغییری در دستورالعمل‌های نصب برای SAML IDP ایجاد نمی‌شود. پیکربندی ارائه‌دهنده هویت SAML را ببینید.