این بخش راهنمایی‌هایی برای انتقال از Classic UI به Edge UI با IDP مانند LDAP یا SAML ارائه می‌دهد.
برای اطلاعات بیشتر، به اینجا مراجعه کنید:
چه کسی می‌تواند انتقال را انجام دهد
برای انتقال به Edge UI، باید به‌عنوان کاربری که در ابتدا Edge را نصب کرده است یا به‌عنوان کاربر ریشه به سیستم وارد شده باشید. پس‌از اجرای نصب‌کننده برای Edge UI، هر کاربری می‌تواند آن‌ها را پیکربندی کند.
قبل‌از شروع
قبل‌از انتقال از «واسط کاربر کلاسیک» به «واسط کاربر Edge»، دستورالعمل‌های کلی زیر را بخوانید:
- از گره‌های Classic UI موجود پشتیبان‌گیری کنید
Apigee توصیه می‌کند قبل‌از به‌روزرسانی، از سرور «رابط کاربری کلاسیک» موجود پشتیبان‌گیری کنید.
- درگاه‌ها/دیوارهای آتش
به‌طور پیش‌فرض، «رابط کاربری کلاسیک» از درگاه ۹۰۰۰ استفاده می‌کند. میانای کاربر Edge از درگاه ۳۰۰۱ استفاده می‌کند.
- ماشین مجازی جدید
نمی‌توان Edge UI را در همان VM که Classic UI نصب شده است نصب کرد.
برای نصب Edge UI، باید ماشین جدیدی به پیکربندی‌تان اضافه کنید. اگر می‌خواهید از همان دستگاهی که برای Classic UI استفاده می‌کردید استفاده کنید، باید Classic UI را کاملاً حذف نصب کنید.
- ارائه‌دهنده هویت (LDAP یا SAML)
Edge UI کاربران را با SAML یا LDAP IDP اصالت‌سنجی می‌کند:
- LDAP: برای LDAP، می‌توانید از یک IDP LDAP خارجی استفاده کنید یا می‌توانید از پیاده‌سازی OpenLDAP داخلی که با Edge نصب شده است استفاده کنید.
- SAML: SAML IDP باید IDP خارجی باشد.
برای اطلاعات بیشتر، به نصب و پیکربندی ارائه‌دهندگان هویت مراجعه کنید.
- همان ارائه‌دهنده هویت
این بخش فرض می‌کند که پس‌از انتقال از همان IDP استفاده خواهید کرد. برای مثال، اگر درحال‌حاضر از IDP LDAP خارجی با «رابط کاربری کلاسیک» استفاده می‌کنید، همچنان از IDP LDAP خارجی با «رابط کاربری Edge» استفاده خواهید کرد.
انتقال با ارائه‌دهنده هویت LDAP داخلی
هنگام انتقال از «رابط کاربری کلاسیک» به «رابط کاربری Edge» در پیکربندی‌ای که از پیاده‌سازی LDAP داخلی (OpenLDAP) به‌عنوان IDP استفاده می‌کند، از دستورالعمل‌های زیر استفاده کنید:
- پیکربندی اتصال غیرمستقیم
بااستفاده از این دستورالعمل‌ها، Edge UI را نصب کنید و تغییر زیر را در فایل پیکربندی بی‌صدا اعمال کنید:
LDAP را برای استفاده از جستجو و اتصال (غیرمستقیم) پیکربندی کنید، همان‌طور که در مثال زیر نشان داده شده است:
SSO_LDAP_PROFILE=indirect SSO_LDAP_BASE_URL=ldap://localhost:10389 SSO_LDAP_ADMIN_USER_DN=uid=admin,ou=users,ou=global,dc=apigee,dc=com SSO_LDAP_ADMIN_PWD=Secret123 SSO_LDAP_SEARCH_BASE=dc=apigee,dc=com SSO_LDAP_SEARCH_FILTER=mail={0} SSO_LDAP_MAIL_ATTRIBUTE=mail - اصالت‌سنجی پایه برای Management API
وقتی «ورود به سیستم تک‌عاملی Apigee» فعال باشد، اصالت‌سنجی پایه برای میاناهای برنامه‌سازی کاربردی به‌طور پیش‌فرض برای همه کاربران LDAP همچنان کار می‌کند. می‌توانید اصالت‌سنجی «پایه» را به‌طور اختیاری غیرفعال کنید، همان‌طور که در غیرفعال کردن اصالت‌سنجی «پایه» در Edge شرح داده شده است.
- اصالت‌سنجی OAuth2 برای Management API
وقتی «تک‌ورودی» را فعال می‌کنید، اصالت‌سنجی مبتنی بر شناسه فعال می‌شود.
- جریان کاربر/گذرواژه جدید
باید کاربران جدید را با میاناهای برنامه‌سازی کاربردی ایجاد کنید زیرا جریان‌های گذرواژه دیگر در Edge UI کار نخواهند کرد.
انتقال با ارائه‌دهنده هویت LDAP خارجی
هنگام انتقال از «میانای کاربر قدیمی» به «میانای کاربر Edge» در پیکربندی‌ای که از پیاده‌سازی LDAP خارجی به‌عنوان IDP استفاده می‌کند، از دستورالعمل‌های زیر استفاده کنید:
- پیکربندی LDAP
بااستفاده از این دستورالعمل‌ها، Edge UI را نصب کنید. می‌توانید اتصال مستقیم یا غیرمستقیم را در فایل پیکربندی بی‌صدا پیکربندی کنید.
- پیکربندی سرور مدیریت
پس‌از فعال کردن Apigee SSO، باید همه ویژگی‌های LDAP خارجی را که در فایل
/opt/apigee/customer/application/management-server.propertiesتعریف شده‌اند بردارید و Management Server را بازراه‌اندازی کنید. - اصالت‌سنجی پایه برای Management API
اصالت‌سنجی پایه برای کاربران ماشین کار می‌کند اما برای کاربران LDAP کار نمی‌کند. اگر فرایند CI/CD شما همچنان از اصالت‌سنجی «پایه» برای دسترسی به سیستم استفاده می‌کند، این موارد بسیار مهم خواهند بود.
- اصالت‌سنجی OAuth2 برای Management API
کاربران LDAP فقط بااستفاده از توکن‌ها می‌توانند به API مدیریت دسترسی داشته باشند.
انتقال با SAML IDP خارجی
هنگام انتقال به Edge UI، هیچ تغییری در دستورالعمل‌های نصب برای SAML IDP وجود ندارد.