Di chuyển sang giao diện người dùng Edge

Phần này hướng dẫn cách di chuyển từ Giao diện người dùng cũ sang Giao diện người dùng Edge bằng một IDP 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 việc di chuyển

Để di chuyển sang giao diện người dùng Edge, bạn phải đăng nhập bằng tài khoản của người dùng đã cài đặt Edge ban đầu hoặc bằng tài khoản 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 người dùng đều có thể định cấu hình chú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 Edge, hãy đọc các nguyên tắc chung sau:

  • Sao lưu các nút Giao diện người dùng cũ hiện có

    Trước khi cập nhật, Apigee khuyên bạn nên sao lưu máy chủ Giao diện người dùng cũ hiện có.

  • 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 sử dụng cổng 3001.

  • Thư thoại mới

    Không thể cài đặt giao diện người dùng Edge trên cùng một máy ảo với Giao diện người dùng cũ.

    Để cài đặt giao diện người dùng Edge, bạn phải thêm một máy mới vào cấu hình của mình. Nếu muốn sử dụng cùng một máy với Giao diện người dùng cũ, thì bạn phải gỡ cài đặt hoàn toàn Giao diện người dùng cũ.

  • Nhà cung cấp danh tính (LDAP hoặc SAML)

    Giao diện người dùng Edge xác thực người dùng bằng IDP SAML hoặc LDAP:

    • LDAP: Đối với LDAP, bạn có thể sử dụng IDP LDAP bên ngoài hoặc sử dụng triển khai OpenLDAP nội bộ được cài đặt cùng với Edge.
    • SAML: IDP SAML phải là IDP bên ngoài.

    Để 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 hiện bạn đang 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.

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

Sử dụng 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 trong một cấu hình sử dụng phương thức triển khai LDAP nội bộ (OpenLDAP) làm IDP:

  • Cấu hình liên kết gián tiếp

    Cài đặt giao diện người dùng Edge bằng các hướng dẫn này, với thay đổi sau đối với tệp cấu hình im lặng:

    Định cấu hình LDAP để sử dụng tính năng tìm kiếm và liên kết (gián tiếp), như trong ví dụ sau:

    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
  • Xác thực cơ bản cho API quản lý

    Phương thức xác thực cơ bản cho API tiếp tục hoạt động theo mặc định cho tất cả người dùng LDAP khi Apigee SSO được bật. Bạn có thể tắt tính năng Xác thực cơ bản (không bắt buộc) như mô tả trong phần Tắt tính năng Xác thực cơ bản trên Edge.

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

    Tính năng xác thực dựa trên mã thông báo sẽ được bật khi bạn bật SSO.

  • Quy trình mới cho người dùng mới/mật khẩu

    Bạn phải tạo người dùng mới bằng API vì quy trình mật khẩu sẽ không còn hoạt động trong giao diện người dùng Edge nữa.

Di chuyển bằng một nhà cung cấp dịch vụ nhận dạng (IdP) LDAP bên ngoài

Sử dụng 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 trong một cấu hình sử dụng phương thức triển khai LDAP bên ngoài làm IDP:

  • Cấu hình LDAP

    Cài đặt giao diện người dùng Edge theo hướng dẫn này. Bạn có thể định cấu hình liên kết trực tiếp hoặc gián tiếp trong tệp cấu hình tự động.

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

    Sau khi bật SSO của Apigee, bạn nên xoá tất cả thuộc tính LDAP bên ngoài được xác định trong 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 cho người dùng máy nhưng không hoạt động cho người dùng LDAP. Những thông tin này sẽ rất quan trọng nếu quy trình CI/CD của bạn vẫ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 chỉ có thể truy cập vào API quản lý bằng mã thông báo.

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

Khi di chuyển sang giao diện người dùng Edge, hướng dẫn cài đặt cho SAML IDP không có gì thay đổi.