Theo mặc định, Bộ định tuyến và Bộ xử lý thông báo hỗ trợ các phiên bản TLS 1.0, 1.1, 1.2. Tuy nhiên, bạn có thể muốn giới hạn các giao thức mà Bộ định tuyến và Bộ xử lý thông báo hỗ trợ. Tài liệu này mô tả cách đặt giao thức trên toàn hệ thống cho Bộ định tuyến và Bộ xử lý thông báo.
Đối với Bộ định tuyến, bạn cũng có thể đặt giao thức cho từng máy chủ ảo. Hãy xem bài viết Định cấu hình quyền truy cập TLS vào một API cho Private Cloud để biết thêm thông tin.
Đối với Bộ xử lý thông báo, bạn có thể đặt giao thức cho một TargetEndpoint riêng lẻ. Hãy xem bài viết Định cấu hình TLS từ Edge đến phần phụ trợ (Cloud và Private Cloud) để biết thêm thông tin.
Đặt giao thức TLS trên Bộ định tuyến
Để đặt giao thức TLS trên Bộ định tuyến, hãy đặt các thuộc tính trong tệp router.properties:
- Mở tệp
router.propertiestrong một trình chỉnh sửa. Nếu tệp không tồn tại, hãy tạo tệp:vi /opt/apigee/customer/application/router.properties
- Đặt các thuộc tính như mong muốn:
# Possible values are space-delimited list of: TLSv1 TLSv1.1 TLSv1.2 conf_load_balancing_load.balancing.driver.server.ssl.protocols=TLSv1.2
- Lưu thay đổi.
- Đảm bảo tệp thuộc tính thuộc sở hữu của người dùng "apigee":
chown apigee:apigee /opt/apigee/customer/application/router.properties
- Khởi động lại bộ định tuyến:
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
- Xác minh rằng giao thức được cập nhật chính xác bằng cách kiểm tra tệp NGINX
/opt/nginx/conf.d/0-default.conf:cat /opt/nginx/conf.d/0-default.conf
Đảm bảo rằng giá trị của
ssl_protocolslà TLSv1.2. - Nếu đang sử dụng TLS hai chiều với máy chủ lưu trữ ảo, bạn cũng phải đặt giao thức TLS trong máy chủ lưu trữ ảo như mô tả trong phần Định cấu hình quyền truy cập TLS vào một API cho Private Cloud.
Đặt giao thức TLS trên Bộ xử lý thông báo
Để đặt giao thức TLS trên Trình xử lý thông báo, hãy đặt các thuộc tính trong tệp message-processor.properties:
- Mở tệp
message-processor.propertiestrong một trình chỉnh sửa. Nếu tệp không tồn tại, hãy tạo tệp:vi /opt/apigee/customer/application/message-processor.properties
- Định cấu hình các thuộc tính bằng cú pháp sau:
# Possible values are a comma-delimited list of TLSv1, TLSv1.1, and TLSv1.2 conf/system.properties+https.protocols=[TLSv1][,TLSv1.1][,TLSv1.2] # Possible values are a comma-delimited list of SSLv3, TLSv1, TLSv1.1, TLSv1.2 # SSLv3 is required conf_jvmsecurity_jdk.tls.disabledAlgorithms=SSLv3[,TLSv1][,TLSv1.1][,TLSv1.2] # Specify the ciphers that the Message Processor supports. (You must separate ciphers with a comma.): conf_message-processor-communication_local.http.ssl.ciphers=cipher[,...]
Các giá trị có thể có cho
conf_message-processor-communication_local.http.ssl.cipherslà:TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384TLS_RSA_WITH_AES_256_GCM_SHA384TLS_ECDH_ECDSA_WITH_AES_256_GCM_SHA384TLS_ECDH_RSA_WITH_AES_256_GCM_SHA384TLS_DHE_RSA_WITH_AES_256_GCM_SHA384TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
Ví dụ:
conf/system.properties+https.protocols=TLSv1.2 conf_jvmsecurity_jdk.tls.disabledAlgorithms=SSLv3, TLSv1, TLSv1.1 conf_message-processor-communication_local.http.ssl.ciphers=TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,TLS_RSA_WITH_AES_256_GCM_SHA384,TLS_ECDH_ECDSA_WITH_AES_256_GCM_SHA384,TLS_ECDH_RSA_WITH_AES_256_GCM_SHA384,TLS_DHE_RSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
Để xem danh sách đầy đủ các thuộc tính liên quan, hãy xem bài viết Định cấu hình TLS giữa Bộ định tuyến và Bộ xử lý thông báo.
- Lưu thay đổi.
- Đảm bảo tệp thuộc tính thuộc sở hữu của người dùng "apigee":
chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
- Khởi động lại Bộ xử lý thông báo:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
- Nếu bạn đang sử dụng TLS hai chiều với phần phụ trợ, hãy đặt giao thức TLS trong máy chủ lưu trữ ảo như mô tả trong phần Định cấu hình TLS từ Edge đến phần phụ trợ (Đám mây và Đám mây riêng tư).