Bermigrasi ke UI New Edge

Mulai Apigee Edge untuk Cloud Pribadi 4.54.00, UI Klasik (edge-ui) dihapus dan UI Edge Baru (edge-management-ui) adalah antarmuka pengelolaan default. Bagian ini memberikan panduan untuk bermigrasi dari UI Klasik ke UI Edge Baru, termasuk deployment yang menggunakan IDP seperti LDAP atau SAML.

Untuk mengetahui informasi selengkapnya, lihat:

Siapa yang dapat melakukan migrasi

Untuk bermigrasi ke UI Edge Baru, Anda harus login sebagai pengguna yang awalnya menginstal Edge atau sebagai pengguna root. Setelah Anda menjalankan penginstal untuk UI Edge Baru, pengguna yang berwenang dapat mengonfigurasinya.

Sebelum memulai

Sebelum bermigrasi dari UI Klasik ke UI Edge Baru, baca panduan umum berikut:

  • Mencadangkan konfigurasi UI Klasik yang ada

    Sebelum mengupgrade ke 4.54.00, Apigee merekomendasikan agar Anda mencadangkan file konfigurasi UI Klasik yang ada sehingga Anda dapat mentransfer setelan kustom (seperti SMTP, TLS, waktu tunggu sesi, dan properti branding) ke /opt/apigee/customer/application/management-ui.properties.

  • Port/firewall

    Secara default, UI Klasik menggunakan port 9000. UI Edge Baru menggunakan port 3001 (dapat dikonfigurasi menggunakan conf_uebe_port).

  • Menghapus UI Klasik

    Jika Anda menginstal UI Edge Baru di node yang sebelumnya menghosting UI Klasik, uninstal UI Klasik (edge-ui) sebelum menginstal UI Edge Baru (edge-management-ui).

  • Autentikasi (Autentikasi dasar, LDAP, atau SAML)

    Di Edge untuk Cloud Pribadi 4.54.00, UI Edge Baru mendukung autentikasi Dasar autentikasi (AUTH_MODE=basic) dan autentikasi IDP eksternal autentikasi melalui Apigee SSO (AUTH_MODE=sso):

    • Autentikasi dasar: Menggunakan implementasi OpenLDAP (apigee-openldap) internal tanpa memerlukan SSO.
    • IDP LDAP (menggunakan Apigee SSO): Menggunakan IDP LDAP eksternal atau implementasi OpenLDAP (apigee-openldap) internal dengan Apigee SSO.
    • IDP SAML (menggunakan Apigee SSO): Menggunakan IDP SAML eksternal dengan Apigee SSO.

    Untuk mengetahui informasi selengkapnya, lihat Menginstal dan mengonfigurasi IDP.

  • IDP yang sama

    Bagian ini mengasumsikan bahwa Anda akan menggunakan IDP yang sama setelah migrasi. Misalnya, jika Anda sebelumnya menggunakan IDP LDAP eksternal dengan UI Klasik, Anda akan terus menggunakan IDP LDAP eksternal dengan UI Edge Baru.

Bermigrasi dengan IDP LDAP internal

Jika menggunakan implementasi OpenLDAP (apigee-openldap) internal, Anda dapat menggunakan autentikasi Dasar langsung di UI Edge Baru (lihat Mengonfigurasi UI Edge Baru), atau mengonfigurasi Apigee SSO dengan LDAP internal menggunakan panduan berikut:

Bermigrasi dengan IDP LDAP eksternal

Gunakan panduan berikut saat bermigrasi dari UI Klasik ke UI Edge Baru dalam konfigurasi yang menggunakan implementasi LDAP eksternal sebagai IDP:

  • Konfigurasi LDAP

    Konfigurasi Apigee SSO dan UI Edge Baru menggunakan Mengonfigurasi UI Edge Baru, Menginstal dan mengonfigurasi Apigee SSO, dan Mengonfigurasi IDP LDAP Anda.

  • Konfigurasi Server Pengelolaan

    Setelah mengaktifkan Apigee SSO, hapus properti LDAP eksternal UI Klasik lama dari file /opt/apigee/customer/application/management-server.properties dan mulai ulang Server Pengelolaan.

  • Autentikasi dasar untuk Management API

    Autentikasi dasar berfungsi untuk pengguna mesin, tetapi tidak untuk pengguna LDAP eksternal. Hal ini sangat penting jika proses CI/CD Anda menggunakan autentikasi Dasar untuk mengakses sistem.

  • Autentikasi OAuth2 untuk Management API

    Pengguna LDAP eksternal mengakses Management API menggunakan token OAuth2.

Bermigrasi dengan IDP SAML eksternal

Saat bermigrasi ke UI Edge Baru, tidak ada perubahan pada petunjuk penginstalan untuk IDP SAML. Lihat Mengonfigurasi IDP SAML Anda.