Bermigrasi ke UI Edge

Bagian ini memberikan panduan untuk bermigrasi dari UI Klasik ke UI Edge dengan IDP seperti LDAP atau SAML.

Untuk informasi selengkapnya, lihat:

Siapa yang dapat melakukan migrasi

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

Sebelum memulai

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

  • Mencadangkan node UI Klasik yang ada

    Sebelum mengupdate, Apigee merekomendasikan agar Anda mencadangkan server UI Klasik yang ada.

  • Port/firewall

    Secara default, UI Klasik menggunakan port 9000. UI Edge menggunakan port 3001.

  • VM Baru

    UI Edge tidak dapat diinstal pada VM yang sama dengan UI Klasik.

    Untuk menginstal UI Edge, Anda harus menambahkan mesin baru ke konfigurasi. Jika Anda ingin menggunakan komputer yang sama seperti UI Klasik, maka Anda harus meng-uninstal UI Klasik sepenuhnya.

  • Penyedia Identitas (LDAP atau SAML)

    UI Edge mengautentikasi pengguna dengan IDP SAML atau LDAP:

    • LDAP: Untuk LDAP, Anda dapat menggunakan IdP LDAP eksternal atau menggunakan penerapan OpenLDAP internal yang diinstal dengan Edge.
    • SAML: IDP SAML harus berupa IDP eksternal.

    Untuk informasi selengkapnya, lihat Menginstal dan mengonfigurasi IDP.

  • IDP yang sama

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

Bermigrasi dengan IdP LDAP internal

Gunakan panduan berikut saat bermigrasi dari UI Klasik ke UI Edge dalam konfigurasi yang menggunakan implementasi LDAP internal (OpenLDAP) sebagai IdP:

  • Konfigurasi binding tidak langsung

    Instal UI Edge menggunakan petunjuk ini, dengan perubahan berikut pada file konfigurasi senyap Anda:

    Konfigurasikan LDAP untuk menggunakan search dan bind (tidak langsung), seperti yang ditunjukkan contoh berikut:

    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
  • Autentikasi dasar untuk API pengelolaan

    Secara default, otentikasi dasar untuk API akan tetap berfungsi bagi semua pengguna LDAP SSO Apigee diaktifkan. Anda dapat menonaktifkan Autentikasi dasar secara opsional, seperti yang dijelaskan dalam Menonaktifkan Autentikasi dasar di Edge.

  • Autentikasi OAuth2 untuk Management API

    Autentikasi berbasis token diaktifkan saat Anda mengaktifkan SSO.

  • Alur pengguna/sandi baru

    Anda harus membuat pengguna baru dengan API karena alur sandi tidak akan berfungsi lagi di UI Edge.

Bermigrasi dengan IDP LDAP eksternal

Gunakan panduan berikut saat bermigrasi dari UI Klasik ke UI Edge di yang menggunakan penerapan LDAP eksternal sebagai IDP:

  • Konfigurasi LDAP

    Instal UI Edge menggunakan opsi berikut petunjuk khusus. Anda dapat mengonfigurasi binding langsung atau tidak langsung dalam file konfigurasi senyap.

  • Konfigurasi Server Pengelolaan

    Setelah mengaktifkan Apigee SSO, Anda harus menghapus semua properti LDAP eksternal yang ditentukan dalam file /opt/apigee/customer/application/management-server.properties dan memulai ulang Server Pengelolaan.

  • Autentikasi dasar untuk API pengelolaan

    Otentikasi dasar berfungsi untuk pengguna komputer, tetapi tidak untuk pengguna LDAP. Ini akan sangat penting jika proses CI/CD Anda tetap menggunakan Autentikasi dasar untuk mengakses sistem.

  • Autentikasi OAuth2 untuk Management API

    Pengguna LDAP hanya dapat mengakses API pengelolaan dengan token.

Bermigrasi dengan IdP SAML eksternal

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