Cài đặt SSO dựa trên cạnh để có khả năng truy cập cao

Edge cho đám mây riêng tư phiên bản 4.19.01

Bạn cài đặt nhiều phiên bản SSO của Edge để có khả năng đáp ứng cao trong 2 trường hợp:

  • Trong một môi trường trung tâm dữ liệu, hãy cài đặt 2 thực thể SSO của Edge để tạo một môi trường có khả năng đáp ứng cao, nghĩa là hệ thống sẽ tiếp tục hoạt động nếu một trong các mô-đun SSO của Edge bị trục trặc.
  • Trong môi trường có hai trung tâm dữ liệu, hãy cài đặt dịch vụ SSO của Edge ở cả hai trung tâm dữ liệu để hệ thống tiếp tục hoạt động nếu một trong các mô-đun SSO của Edge bị lỗi.

Cài đặt 2 mô-đun SSO của Edge trong cùng một trung tâm dữ liệu

Bạn triển khai hai thực thể SSO của Edge (trên các nút khác nhau) trong một trung tâm dữ liệu duy nhất để hỗ trợ khả năng đáp ứng cao. Trong tình huống này:

  • Cả hai bản sao SSO của Edge phải được kết nối với cùng một máy chủ Postgres. Bạn nên sử dụng một máy chủ Postgres chuyên dụng cho dịch vụ Đăng nhập một lần (SSO) của Edge, chứ không phải máy chủ Postgres mà bạn đã cài đặt bằng Edge.
  • Cả hai thực thể của dịch vụ SSO ở Edge phải sử dụng cùng một cặp khoá JWT như được chỉ định trong các thuộc tính SSO_JWT_SIGNING_KEY_FILEPATH và SSO_JWT_VERIFICATION_KEY_FILEPATH trong tệp cấu hình. Xem bài viết Cài đặt và định cấu hình dịch vụ Đăng nhập một lần (SSO) ở Edge để biết thêm thông tin về cách đặt các thuộc tính này.
  • Bạn cần có một trình cân bằng tải trước hai phiên bản SSO của Edge:
    • Trình cân bằng tải phải hỗ trợ khả năng gắn bó với cookie do ứng dụng tạo và cookie của phiên phải được đặt tên là JSESSIONID.
    • Định cấu hình trình cân bằng tải để thực hiện kiểm tra tình trạng TCP hoặc HTTP trên dịch vụ SSO của Edge. Đối với TCP, hãy sử dụng URL của dịch vụ Đăng nhập một lần (SSO) ở Edge: 
      http_or_https://edge_sso_IP_DNS:9099

      Chỉ định cổng do dịch vụ SSO của Edge đặt. Cổng 9099 là mặc định.

      Đối với HTTP, hãy thêm /healthz:

      http_or_https://edge_sso_IP_DNS:9099/healthz
    • Một số chế độ cài đặt của trình cân bằng tải phụ thuộc vào việc bạn có bật HTTPS trên dịch vụ SSO của Edge hay không. Hãy xem các phần sau để biết thêm thông tin.

Quyền truy cập HTTP vào dịch vụ SSO ở Edge

Nếu bạn đang sử dụng quyền truy cập HTTP vào dịch vụ SSO của Edge, hãy định cấu hình trình cân bằng tải để:

  • Sử dụng chế độ HTTP để kết nối với dịch vụ Đăng nhập một lần (SSO) ở Edge.

  • Nghe trên cùng một cổng với dịch vụ SSO của Edge.

    Theo mặc định, dịch vụ SSO của Edge sẽ theo dõi các yêu cầu HTTP trên cổng 9099. Bạn có thể dùng SSO_TOMCAT_PORT để đặt cổng SSO của Edge (không bắt buộc). Nếu bạn đã dùng SSO_TOMCAT_PORT để thay đổi cổng SSO của Edge từ chế độ mặc định, hãy đảm bảo rằng trình cân bằng tải theo dõi trên cổng đó.

Ví dụ: trên mỗi bản sao SSO của Edge, bạn đặt cổng thành 9033 bằng cách thêm đoạn mã sau vào tệp cấu hình:

SSO_TOMCAT_PORT=9033

Sau đó, bạn định cấu hình trình cân bằng tải để theo dõi trên cổng 9033 và chuyển tiếp các yêu cầu đến một thực thể SSO của Edge trên cổng 9033. URL công khai của dịch vụ Đăng nhập một lần (SSO) ở Edge trong trường hợp này là:

http://LB_DNS_NAME:9033

Quyền truy cập qua HTTPS vào dịch vụ Đăng nhập một lần (SSO) ở Edge

Bạn có thể định cấu hình các bản sao SSO của Edge để dùng HTTPS. Trong trường hợp này, hãy làm theo các bước trong phần Định cấu hình apigee-sso để truy cập HTTPS. Trong quy trình bật HTTPS, bạn cần đặt SSO_TOMCAT_PROFILE trong tệp cấu hình SSO của Edge như sau:

SSO_TOMCAT_PROFILE=SSL_TERMINATION

Bạn cũng có thể tuỳ ý thiết lập cổng mà dịch vụ SSO của Edge sử dụng để truy cập HTTPS:

SSO_TOMCAT_PORT=9443

Sau đó, hãy định cấu hình trình cân bằng tải để:

  • Sử dụng chế độ TCP, chứ không phải chế độ HTTP, để kết nối với dịch vụ SSO ở Edge.
  • Nghe trên cùng một cổng với dịch vụ SSO của Edge do SSO_TOMCAT_PORT xác định.

Sau đó, bạn định cấu hình trình cân bằng tải để chuyển tiếp các yêu cầu đến một thực thể SSO của Edge trên cổng 9433. URL công khai của dịch vụ Đăng nhập một lần (SSO) ở Edge trong trường hợp này là:

https://LB_DNS_NAME:9443

Cài đặt dịch vụ SSO của Edge trong nhiều trung tâm dữ liệu

Trong môi trường có nhiều trung tâm dữ liệu, bạn sẽ cài đặt một bản sao SSO của Edge trong mỗi trung tâm dữ liệu. Sau đó, thực thể SSO của One Edge sẽ xử lý tất cả lưu lượng truy cập. Nếu phiên bản SSO thứ hai của Edge bị ngừng hoạt động, thì bạn có thể chuyển sang phiên bản SSO thứ hai của Edge.

Trước khi cài đặt dịch vụ SSO của Edge tại 2 trung tâm dữ liệu, bạn cần có:

  • Địa chỉ IP hoặc tên miền của máy chủ Postgres chính.

    Trong môi trường có nhiều trung tâm dữ liệu, bạn thường cài đặt một máy chủ Postgres trong mỗi trung tâm dữ liệu rồi định cấu hình các máy chủ này ở chế độ sao chép Chính-Dự phòng. Trong ví dụ này, trung tâm dữ liệu 1 chứa máy chủ Chính Postgres và trung tâm dữ liệu 2 chứa Chế độ chờ. Để biết thêm thông tin, hãy xem phần Thiết lập tính năng Sao chép dự phòng chính cho Postgres.

  • Một mục DNS duy nhất trỏ đến một bản sao SSO của Edge. Ví dụ: bạn tạo một mục DNS trong biểu mẫu bên dưới trỏ đến thực thể SSO của Edge trong trung tâm dữ liệu 1: 
    my-sso.domain.com => apigee-sso-dc1-ip-or-lb
  • Cả hai thực thể của dịch vụ SSO ở Edge phải sử dụng cùng một cặp khoá JWT như được chỉ định trong các thuộc tính SSO_JWT_SIGNING_KEY_FILEPATH và SSO_JWT_VERIFICATION_KEY_FILEPATH trong tệp cấu hình. Xem bài viết Cài đặt và định cấu hình dịch vụ Đăng nhập một lần (SSO) ở Edge để biết thêm thông tin về cách đặt các thuộc tính này.

Khi cài đặt dịch vụ SSO của Edge trong mỗi trung tâm dữ liệu, bạn sẽ định cấu hình cả hai để sử dụng Postgres Master trong trung tâm dữ liệu 1:

## Postgres configuration
PG_HOST=IP_or_DNS_of_PG_Master_in_DC1
PG_PORT=5432

Bạn cũng định cấu hình cả hai trung tâm dữ liệu để sử dụng mục DNS làm URL có thể truy cập công khai:

# Externally accessible URL of Edge SSO
SSO_PUBLIC_URL_HOSTNAME=my-sso.domain.com
# Default port is 9099.
SSO_PUBLIC_URL_PORT=9099

Nếu dịch vụ SSO ở Edge trong trung tâm dữ liệu 1 bị gián đoạn, thì bạn có thể chuyển sang thực thể SSO của Edge trong trung tâm dữ liệu 2:

  1. Chuyển đổi máy chủ chế độ chờ Postgres trong trung tâm dữ liệu 2 thành chính như mô tả trong phần Xử lý chuyển đổi dự phòng cơ sở dữ liệu PostgreSQL.
  2. Cập nhật bản ghi DNS để trỏ my-sso.domain.com đến bản sao SSO của Edge trong trung tâm dữ liệu 2: 
    my-sso.domain.com => apigee-sso-dc2-ip-or-lb
  3. Cập nhật tệp cấu hình cho dịch vụ SSO ở Edge trong trung tâm dữ liệu 2 để trỏ đến máy chủ Postgres Master mới trong trung tâm dữ liệu 2: 
    ## Postgres configuration
PG_HOST=IP_or_DNS_of_PG_Master_in_DC2
  4. Khởi động lại tính năng SSO của Edge trong trung tâm dữ liệu 2 để cập nhật cấu hình của tính năng này: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-sso restart