Di chuyển sang giao diện người dùng mới của Edge

Kể từ phiên bản Apigee Edge cho Private Cloud 4.54.00, Giao diện người dùng cổ điển (edge-ui) sẽ bị xoá và Giao diện người dùng Edge mới (edge-management-ui) là giao diện quản lý mặc định. Phần này cung cấp hướng dẫn về cách di chuyển từ Giao diện người dùng cũ sang Giao diện người dùng Edge mới, bao gồm cả những triển khai sử dụng IDP (chẳng hạn như LDAP hoặc SAML).

Để biết thêm thông tin, hãy xem các bài viết sau:

Người có thể thực hiện quy trình di chuyển

Để di chuyển sang Giao diện người dùng Edge mới, bạn phải đăng nhập với tư cách là người dùng đã cài đặt Edge ban đầu hoặc với tư cách là người dùng gốc. Sau khi bạn chạy trình cài đặt cho Giao diện người dùng Edge mới, mọi người dùng được uỷ quyền đều có thể định cấu hình giao diện người dùng đó.

Trước khi bắt đầu

Trước khi di chuyển từ Giao diện người dùng cũ sang Giao diện người dùng mới của Edge, hãy đọc các nguyên tắc chung sau:

  • Sao lưu cấu hình giao diện người dùng cũ hiện có

    Trước khi nâng cấp lên phiên bản 4.54.00, Apigee khuyên bạn nên sao lưu các tệp cấu hình Giao diện người dùng cũ hiện có để có thể chuyển các chế độ cài đặt tuỳ chỉnh (chẳng hạn như SMTP, TLS, thời gian hết hạn phiên và thuộc tính thương hiệu) sang /opt/apigee/customer/application/management-ui.properties.

  • Cổng/tường lửa

    Theo mặc định, Giao diện người dùng cũ sử dụng cổng 9000. Giao diện người dùng Edge mới sử dụng cổng 3001 (có thể định cấu hình bằng conf_uebe_port).

  • Xoá giao diện người dùng cũ

    Nếu bạn đang cài đặt Giao diện người dùng Edge mới trên một nút trước đây lưu trữ Giao diện người dùng cũ, hãy gỡ cài đặt Giao diện người dùng cũ (edge-ui) trước khi cài đặt Giao diện người dùng Edge mới (edge-management-ui).

  • Xác thực (Xác thực cơ bản, LDAP hoặc SAML)

    Trong Edge cho Private Cloud 4.54.00, Giao diện người dùng Edge mới hỗ trợ cả phương thức xác thực Cơ bản (AUTH_MODE=basic) và phương thức xác thực IDP bên ngoài thông qua Đăng nhập một lần (SSO) của Apigee (AUTH_MODE=sso):

    • Xác thực cơ bản: Sử dụng cách triển khai OpenLDAP nội bộ (apigee-openldap) mà không cần SSO.
    • LDAP IDP (sử dụng SSO của Apigee): Sử dụng IDP LDAP bên ngoài hoặc triển khai OpenLDAP nội bộ (apigee-openldap) bằng SSO của Apigee.
    • Nhà cung cấp danh tính SAML (sử dụng dịch vụ SSO của Apigee): Sử dụng một nhà cung cấp danh tính SAML bên ngoài với dịch vụ SSO của Apigee.

    Để biết thêm thông tin, hãy xem bài viết Cài đặt và định cấu hình IDP.

  • Cùng một IDP

    Phần này giả định rằng bạn sẽ sử dụng cùng một IDP sau khi di chuyển. Ví dụ: nếu trước đây bạn đã sử dụng IDP LDAP bên ngoài với Giao diện người dùng cũ, thì bạn sẽ tiếp tục sử dụng IDP LDAP bên ngoài với Giao diện người dùng Edge mới.

Di chuyển bằng IdP LDAP nội bộ

Nếu sử dụng phương thức triển khai OpenLDAP (apigee-openldap) nội bộ, bạn có thể sử dụng phương thức Xác thực cơ bản ngay trong Giao diện người dùng Edge mới (xem phần Định cấu hình Giao diện người dùng Edge mới) hoặc định cấu hình SSO của Apigee bằng LDAP nội bộ theo các nguyên tắc sau:

Di chuyển bằng IdP LDAP bên ngoài

Hãy tuân thủ các nguyên tắc sau khi di chuyển từ Giao diện người dùng cũ sang Giao diện người dùng Edge mới trong một cấu hình sử dụng chế độ triển khai LDAP bên ngoài làm IDP:

  • Cấu hình LDAP

    Định cấu hình SSO của Apigee và Giao diện người dùng Edge mới bằng cách sử dụng Định cấu hình Giao diện người dùng Edge mới, Cài đặt và định cấu hình SSO của Apigee, và Định cấu hình IDP LDAP của bạn.

  • Cấu hình Máy chủ quản lý

    Sau khi bạn bật tính năng Đăng nhập một lần (SSO) của Apigee, hãy xoá mọi thuộc tính LDAP bên ngoài của Giao diện người dùng cũ khỏi tệp /opt/apigee/customer/application/management-server.properties rồi khởi động lại Máy chủ quản lý.

  • Xác thực cơ bản cho API quản lý

    Phương thức xác thực cơ bản hoạt động đối với người dùng máy nhưng không hoạt động đối với người dùng LDAP bên ngoài. Điều này rất quan trọng nếu quy trình CI/CD của bạn sử dụng phương thức Xác thực cơ bản để truy cập vào hệ thống.

  • Xác thực OAuth2 cho API quản lý

    Người dùng LDAP bên ngoài truy cập vào API quản lý bằng mã thông báo OAuth2.

Di chuyển bằng SAML IDP bên ngoài

Khi di chuyển sang Giao diện người dùng Edge mới, hướng dẫn cài đặt cho SAML IDP không có gì thay đổi. Xem phần Định cấu hình IDP SAML.