این بخش راهنمایی‌هایی برای انتقال از «میانای کاربر کلاسیک» به «میانای کاربر Edge» با IDP مثل LDAP یا SAML ارائه می‌دهد.
برای اطلاعات بیشتر، به اینجا مراجعه کنید:
چه کسی می‌تواند انتقال را انجام دهد
برای انتقال به «واسط کاربر Edge»، باید به‌عنوان کاربری که در ابتدا Edge را نصب کرده است یا به‌عنوان کاربر ریشه به سیستم وارد شوید. پس‌از اجرای نصب‌کننده برای «واسط کاربر Edge»، هر کاربری می‌تواند آن‌ها را پیکربندی کند.
قبل‌از شروع
قبل‌از انتقال از «واسط کاربر کلاسیک» به «واسط کاربر Edge»، دستورالعمل‌های کلی زیر را بخوانید:
- پشتیبان‌گیری از گره‌های «میانای کاربر کلاسیک» موجود
قبل‌از به‌روزرسانی، Apigee توصیه می‌کند که از سرور «میانای کاربر کلاسیک» فعلی‌تان پشتیبان‌گیری کنید.
- درگاه‌ها/دیوارهای آتش
به‌طور پیش‌فرض، «واسط کاربر کلاسیک» از درگاه ۹۰۰۰ استفاده می‌کند. «میانای کاربر Edge» از درگاه ۳۰۰۱ استفاده می‌کند.
- ماشین مجازی جدید
«میانای کاربری Edge» را نمی‌توان در همان ماشین مجازی «میانای کاربری کلاسیک» نصب کرد.
برای نصب «میانای کاربر Edge»، باید ماشین جدیدی به پیکربندی‌تان اضافه کنید. اگر می‌خواهید از همان ماشین به‌عنوان «واسط کاربر کلاسیک» استفاده کنید، باید «واسط کاربر کلاسیک» را به‌طور کامل حذف نصب کنید.
- ارائه‌دهنده هویت (LDAP یا SAML)
«میانای کاربر Edge» کاربران را با SAML یا LDAP IDP اصالت‌سنجی می‌کند:
- LDAP: برای LDAP، می‌توانید از یک LDAP IDP خارجی استفاده کنید یا می‌توانید از پیاده‌سازی داخلی OpenLDAP که با Edge نصب می‌شود استفاده کنید.
- SAML: «ارائه‌دهنده هویت» SAML باید «ارائه‌دهنده هویت» خارجی باشد.
برای اطلاعات بیشتر، نصب و پیکربندی ارائه‌دهندگان هویت را ببینید.
- ارائه‌دهنده هویت یکسان
این بخش فرض می‌کند که پس‌از انتقال از همان IDP استفاده خواهید کرد. برای مثال، اگر درحال‌حاضر از یک LDAP IDP خارجی با «واسط کاربر کلاسیک» استفاده می‌کنید، همچنان از یک LDAP IDP خارجی با «واسط کاربر Edge» استفاده خواهید کرد.
انتقال با IdP داخلی LDAP
هنگام انتقال از «واسط کاربر کلاسیک» به «واسط کاربر Edge» در پیکربندی‌ای که از پیاده‌سازی LDAP داخلی (OpenLDAP) به‌عنوان IDP استفاده می‌کند، از دستورالعمل‌های زیر استفاده کنید:
- پیکربندی اتصال غیرمستقیم
«واسط کاربر Edge» را بااستفاده از این دستورالعمل‌ها نصب کنید و تغییر زیر را در فایل پیکربندی بی‌صدای خود اعمال کنید:
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 - اصالت‌سنجی پایه برای «میانای برنامه‌سازی کاربردی مدیریت»
وقتی Apigee SSO فعال باشد، اصالت‌سنجی پایه برای APIها به‌طور پیش‌فرض برای همه کاربران LDAP کار می‌کند. می‌توانید اصالت‌سنجی «پایه» را به‌صورت اختیاری غیرفعال کنید، همان‌طور که در غیرفعال کردن اصالت‌سنجی «پایه» در Edge توضیح داده شده است.
- اصالت‌سنجی OAuth2 برای «میانای برنامه‌سازی کاربردی مدیریت»
وقتی «ورود به سیستم یکپارچه» را فعال می‌کنید، اصالت‌سنجی مبتنی بر نمودار فعال می‌شود.
- جریان کاربر/گذرواژه جدید
باید کاربران جدید را با «میاناهای برنامه‌سازی کاربردی» ایجاد کنید زیرا جریان‌های گذرواژه دیگر در واسط کاربر Edge کار نخواهد کرد.
انتقال با «ارائه‌دهنده هویت» ال‌دپ خارجی
هنگام انتقال از «واسط کاربر کلاسیک» به «واسط کاربر Edge» در پیکربندی‌ای که از پیاده‌سازی LDAP خارجی به‌عنوان IDP استفاده می‌کند، از دستورالعمل‌های زیر استفاده کنید:
- پیکربندی LDAP
«میانای کاربر Edge» را بااستفاده از این دستورالعمل‌ها نصب کنید. می‌توانید اتصال مستقیم یا غیرمستقیم را در فایل پیکربندی بی‌صدای خود پیکربندی کنید.
- پیکربندی «سرور مدیریت»
پس‌از فعال کردن Apigee SSO، باید همه دارایی‌های LDAP خارجی را که در فایل
/opt/apigee/customer/application/management-server.propertiesتعریف شده‌اند بردارید و «سرور مدیریت» را بازراه‌اندازی کنید. - اصالت‌سنجی پایه برای «میانای برنامه‌سازی کاربردی مدیریت»
اصالت‌سنجی پایه برای کاربران ماشین کار می‌کند اما برای کاربران LDAP کار نمی‌کند. اگر فرایند CI/CD شما هنوز از «احراز هویت پایه» برای دسترسی به سیستم استفاده می‌کند، این موارد حیاتی خواهند بود.
- اصالت‌سنجی OAuth2 برای «میانای برنامه‌سازی کاربردی مدیریت»
کاربران LDAP فقط با کد دسترسی می‌توانند به API مدیریت دسترسی داشته باشند.
انتقال با SAML IDP خارجی
هنگام انتقال به «واسط کاربر Edge»، هیچ تغییری در دستورالعمل‌های نصب برای «ارائه‌دهنده هویت SAML» وجود ندارد.