새 Edge UI로 이전

프라이빗 클라우드용 Apigee Edge 4.54.00부터 기본 UI (edge-ui)가 삭제되고 새 Edge UI (edge-management-ui)가 기본 관리 인터페이스가 됩니다. 이 섹션에서는 LDAP 또는 SAML과 같은 IDP를 사용하는 배포를 비롯하여 기존 UI에서 새 Edge UI로 마이그레이션하는 방법을 안내합니다.

자세한 내용은 다음을 참고하세요.

마이그레이션을 실행할 수 있는 사용자

새 Edge UI로 마이그레이션하려면 원래 Edge를 설치한 사용자 또는 루트 사용자로 로그인해야 합니다. 새 Edge UI의 설치 프로그램을 실행한 후에는 권한이 있는 모든 사용자가 새 Edge UI를 구성할 수 있습니다.

시작하기 전에

기존 UI에서 새 Edge UI로 마이그레이션하기 전에 다음 일반 가이드라인을 읽어보세요.

  • 기존 기본 UI 구성 백업

    4.54.00으로 업그레이드하기 전에 Apigee는 기존 기본 UI 구성 파일을 백업하여 SMTP, TLS, 세션 만료 시간, 브랜딩 속성과 같은 맞춤 설정을 /opt/apigee/customer/application/management-ui.properties로 이전하는 것이 좋습니다.

  • 포트/방화벽

    기본적으로 기본 UI는 포트 9000을 사용했습니다. 새 Edge UI는 포트 3001 을 사용합니다(conf_uebe_port를 사용하여 구성 가능).

  • 기존 UI 삭제

    이전에 기본 UI를 호스팅한 노드에 새 Edge UI를 설치하는 경우 새 Edge UI (edge-management-ui)를 설치하기 전에 기본 UI(edge-ui)를 제거합니다.

  • 인증 (기본 인증, LDAP 또는 SAML)

    프라이빗 클라우드용 Edge 4.54.00에서 새 Edge UI는 기본 인증 (AUTH_MODE=basic)과 Apigee SSO (AUTH_MODE=sso)를 통한 외부 IDP 인증을 모두 지원합니다.

    • 기본 인증: SSO가 필요하지 않고 내부 OpenLDAP (apigee-openldap) 구현을 사용합니다.
    • LDAP IDP (Apigee SSO 사용): 외부 LDAP IDP 또는 Apigee SSO가 포함된 내부 OpenLDAP(apigee-openldap) 구현을 사용합니다.
    • SAML IDP (Apigee SSO 사용): Apigee SSO가 포함된 외부 SAML IDP를 사용합니다.

    자세한 내용은 IDP 설치 및 구성을 참고하세요.

  • 동일한 IDP

    이 섹션에서는 마이그레이션 후에도 동일한 IDP를 사용한다고 가정합니다. 예를 들어 이전에 기본 UI에서 외부 LDAP IDP를 사용한 경우 새 Edge UI에서도 외부 LDAP IDP를 계속 사용합니다.

내부 LDAP IDP로 마이그레이션

내부 OpenLDAP (apigee-openldap) 구현을 사용하는 경우 새 Edge UI에서 직접 기본 인증을 사용하거나 (새 Edge UI 구성 참고) 다음 가이드라인에 따라 내부 LDAP로 Apigee SSO를 구성할 수 있습니다.

  • LDAP 및 새 Edge UI 구성

    새 Edge UI 구성, Apigee SSO 설치 및 구성, 및 LDAP IDP 구성을 사용하여 새 Edge UI 및 Apigee SSO를 설치하고 구성합니다.

  • 관리 API의 기본 인증

    Apigee SSO가 사용 설정되면 모든 LDAP 사용자를 대상으로 API의 기본 인증이 기본적으로 계속 작동합니다. Edge에서 기본 인증 사용 중지에 설명된 대로 기본 인증을 선택적으로 사용 중지할 수 있습니다.

  • 관리 API의 OAuth2 인증

    Apigee SSO를 사용 설정하면 토큰 기반 인증이 사용 설정됩니다.

외부 LDAP IDP로 마이그레이션

IDP로 외부 LDAP 구현을 사용하는 구성에서 기존 UI에서 새 Edge UI로 마이그레이션할 때는 다음 가이드라인을 사용하세요.

  • LDAP 구성

    새 Edge UI 구성, Apigee SSO 설치 및 구성, 및 LDAP IDP 구성을 사용하여 Apigee SSO 및 새 Edge UI를 구성합니다.

  • 관리 서버 구성

    Apigee SSO를 사용 설정한 후 기존 기본 UI 외부 LDAP 속성을 /opt/apigee/customer/application/management-server.properties 파일에서 삭제하고 관리 서버를 다시 시작합니다.

  • 관리 API의 기본 인증

    기본 인증은 머신 사용자에게는 작동하지만 외부 LDAP 사용자에게는 작동하지 않습니다. CI/CD 프로세스에서 기본 인증을 사용하여 시스템에 액세스하는 경우 이 점이 중요합니다. CI/CD

  • 관리 API의 OAuth2 인증

    외부 LDAP 사용자는 OAuth2 토큰을 사용하여 Management API에 액세스합니다.

외부 SAML IDP로 마이그레이션

새 Edge UI로 마이그레이션할 때는 SAML IDP의 설치 안내에 변경사항이 없습니다. SAML IDP 구성을 참고하세요.