Edge for Private Cloud phiên bản 4.19.01
Bạn cài đặt nhiều phiên bản SSO của Edge để có độ sẵn sàng cao trong hai trường hợp:
- Trong một môi trường trung tâm dữ liệu, hãy cài đặt hai phiên bản SSO của Edge để tạo một môi trường có tính sẵn sàng cao, tức 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 ngừng hoạt động.
- Trong môi trường có hai trung tâm dữ liệu, hãy cài đặt Edge SSO trong 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 Edge SSO ngừng hoạt động.
Cài đặt hai mô-đun SSO Edge trong cùng một trung tâm dữ liệu
Bạn triển khai hai phiên bản Edge SSO trên các nút khác nhau trong một trung tâm dữ liệu để hỗ trợ tính sẵn sàng cao. Trong tình huống này:
- Cả hai phiên bản Edge SSO đều phải được kết nối với cùng một máy chủ Postgres. Apigee khuyên bạn nên sử dụng một máy chủ Postgres chuyên dụng cho Edge SSO chứ không phải cùng một máy chủ Postgres mà bạn đã cài đặt bằng Edge.
- Cả hai phiên bản Edge SSO đều phải sử dụng cùng một cặp khoá JWT như được chỉ định bởi các thuộc tính
SSO_JWT_SIGNING_KEY_FILEPATHvàSSO_JWT_VERIFICATION_KEY_FILEPATHtrong tệp cấu hình. Hãy xem phần Cài đặt và định cấu hình SSO của Edge để biết thêm thông tin về cách thiết lập 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 của Edge SSO:
- Trình cân bằng tải phải hỗ trợ tính năng cố định 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 quy trình kiểm tra tình trạng TCP hoặc HTTP trên Edge SSO. Đối với TCP,
hãy sử dụng URL của Edge SSO:
http_or_https://edge_sso_IP_DNS:9099
Chỉ định cổng do Edge SSO đặt. Cổng 9099 là cổng 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 trình cân bằng tải phụ thuộc vào việc bạn có bật HTTPS trên Edge SSO hay không. Hãy xem các phần sau để biết thêm thông tin.
- Trình cân bằng tải phải hỗ trợ tính năng cố định cookie do ứng dụng tạo và cookie của phiên phải được đặt tên là
Quyền truy cập HTTP vào Edge SSO
Nếu bạn đang sử dụng quyền truy cập HTTP vào Edge SSO, 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 Edge SSO.
Nghe trên cùng một cổng với Edge SSO.
Theo mặc định, Edge SSO sẽ theo dõi các yêu cầu HTTP trên cổng 9099. Nếu muốn, bạn có thể sử dụng
SSO_TOMCAT_PORTđể đặt cổng SSO của Edge. Nếu bạn đã sử dụngSSO_TOMCAT_PORTđể thay đổi cổng SSO của Edge từ cổng mặc định, hãy đảm bảo rằng trình cân bằng tải đang theo dõi cổng đó.
Ví dụ: trên mỗi phiên bản Edge SSO, bạn đặt cổng thành 9033 bằng cách thêm nội dung 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 để nghe trên cổng 9033 và chuyển tiếp các yêu cầu đến một phiên bản SSO của Edge trên cổng 9033. URL công khai của Edge SSO trong trường hợp này là:
http://LB_DNS_NAME:9033
Quyền truy cập HTTPS vào Edge SSO
Bạn có thể định cấu hình các phiên bản Edge SSO để sử 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 quá trình bật HTTPS, bạn đặt SSO_TOMCAT_PROFILE trong tệp cấu hình SSO của Edge như dưới đây:
SSO_TOMCAT_PROFILE=SSL_TERMINATION
Bạn cũng có thể tuỳ ý đặt cổng mà Edge SSO 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, không phải chế độ HTTP, để kết nối với Edge SSO.
- Nghe trên cùng một cổng với Edge SSO như được xác định bằng
SSO_TOMCAT_PORT.
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 phiên bản SSO của Edge trên cổng 9433. URL công khai của Edge SSO trong trường hợp này là:
https://LB_DNS_NAME:9443
Cài đặt Edge SSO trong nhiều trung tâm dữ liệu
Trong môi trường nhiều trung tâm dữ liệu, bạn cài đặt một phiên bản SSO của Edge trong mỗi trung tâm dữ liệu. Sau đó, một phiên bản Edge SSO sẽ xử lý tất cả lưu lượng truy cập. Nếu phiên bản Edge SSO đó ngừng hoạt động, thì bạn có thể chuyển sang phiên bản Edge SSO thứ hai.
Trước khi cài đặt Edge SSO trong hai trung tâm dữ liệu, bạn cần có những thông tin sau:
Địa chỉ IP hoặc tên miền của máy chủ Postgres chính.
Trong môi trường 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 và định cấu hình các máy chủ đó ở chế độ sao chép Master-Standby. Trong ví dụ này, trung tâm dữ liệu 1 chứa máy chủ Postgres Chính và trung tâm dữ liệu 2 chứa máy chủ Dự phòng. Để biết thêm thông tin, hãy xem bài viết Thiết lập tính năng sao chép chính-phụ cho Postgres.
- Một mục DNS duy nhất trỏ đến một phiên bản Edge SSO. Ví dụ: bạn tạo một mục DNS
theo biểu mẫu bên dưới trỏ đến phiên bản SSO của Edge trong trung tâm dữ liệu 1:
my-sso.domain.com => apigee-sso-dc1-ip-or-lb
- Cả hai phiên bản SSO của Edge đều phải sử dụng cùng một cặp khoá JWT như được chỉ định bởi các thuộc tính
SSO_JWT_SIGNING_KEY_FILEPATHvàSSO_JWT_VERIFICATION_KEY_FILEPATHtrong tệp cấu hình. Hãy xem phần Cài đặt và định cấu hình Edge SSO để biết thêm thông tin về cách thiết lập các thuộc tính này.
Khi cài đặt 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=5432Bạ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 SSO của Edge trong trung tâm dữ liệu 1 ngừng hoạt động, thì bạn có thể chuyển sang phiên bản SSO của Edge trong trung tâm dữ liệu 2:
- Chuyển đổi máy chủ Postgres Standby trong trung tâm dữ liệu 2 thành Master như mô tả trong phần Xử lý lỗi cơ sở dữ liệu PostgreSQL.
- Cập nhật bản ghi DNS để trỏ
my-sso.domain.comđến phiên bản SSO của Edge trong trung tâm dữ liệu 2:my-sso.domain.com => apigee-sso-dc2-ip-or-lb
- Cập nhật tệp cấu hình cho Edge SSO 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
- Khởi động lại Edge SSO trong trung tâm dữ liệu 2 để cập nhật cấu hình:
/opt/apigee/apigee-service/bin/apigee-service apigee-sso restart