Theo mặc định, TLS giữa Bộ định tuyến và Bộ xử lý thông báo sẽ bị tắt.
Cách bật tính năng mã hoá TLS giữa Bộ định tuyến và Bộ xử lý thông báo:
- Đảm bảo rằng Bộ định tuyến có thể truy cập vào cổng 8082 trên Bộ xử lý thông báo.
- Tạo tệp JKS của kho khoá chứa chứng chỉ TLS và khoá riêng tư của bạn. Để biết thêm thông tin, hãy xem bài viết Định cấu hình TLS/SSL cho Edge On Premises.
- Sao chép tệp JKS của kho khoá vào một thư mục trên máy chủ Bộ xử lý thông báo, chẳng hạn như
/opt/apigee/customer/application. - Thay đổi quyền và quyền sở hữu tệp JKS:
chown apigee:apigee /opt/apigee/customer/application/keystore.jks
chmod 600 /opt/apigee/customer/application/keystore.jksTrong đó,
keystore.jkslà tên tệp kho khoá của bạn. - Chỉnh sửa tệp
/opt/apigee/customer/application/message-processor.properties. Nếu tệp không tồn tại, hãy tạo tệp. - Đặt các thuộc tính sau trong tệp
message-processor.properties:conf_message-processor-communication_local.http.ssl=true conf/message-processor-communication.properties+local.http.port=8443 conf/message-processor-communication.properties+local.http.ssl.keystore.type=jks conf/message-processor-communication.properties+local.http.ssl.keystore.path=/opt/apigee/customer/application/keystore.jks conf/message-processor-communication.properties+local.http.ssl.keyalias=apigee-devtest # Enter the obfuscated keystore password below. conf/message-processor-communication.properties+local.http.ssl.keystore.password=OBF:obsPword
Trong đó,
keystore.jkslà tệp kho khoá và obsPword là kho khoá bị làm rối mã nguồn và mật khẩu bí danh khoá.Lưu ý: Giá trị của
phải giống với giá trị do tuỳ chọnconf/message-processor-communication.properties+local.http.ssl.keyalias=apigee-devtest
-aliascung cấp cho lệnhkeytool, được mô tả ở cuối phần Tạo tệp JKS.Hãy xem bài viết Định cấu hình TLS/SSL cho Edge On Premises để biết thông tin về cách tạo mật khẩu bị làm rối mã nguồn.
- Đảm bảo rằng tệp
message-processor.propertiesthuộc sở hữu của người dùng "apigee":chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
- Dừng Bộ xử lý thông báo và Bộ định tuyến:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
/opt/apigee/apigee-service/bin/apigee-service edge-router stop - Trên Bộ định tuyến, hãy xoá mọi tệp trong thư mục
/opt/nginx/conf.d:rm -f /opt/nginx/conf.d/*
- Khởi động Bộ xử lý thông báo và Bộ định tuyến:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor start
/opt/apigee/apigee-service/bin/apigee-service edge-router start - Lặp lại quy trình này cho từng Bộ xử lý thông báo.
Sau khi TLS được bật giữa Bộ định tuyến và Bộ xử lý thông báo, tệp nhật ký của Bộ xử lý thông báo
sẽ chứa thông báo INFO này:
MessageProcessorHttpSkeletonFactory.configureSSL() : Instantiating Keystore of type: jks
Câu lệnh INFO này xác nhận rằng TLS đang hoạt động giữa Bộ định tuyến và Bộ xử lý thông báo.
Bảng sau đây liệt kê tất cả các thuộc tính có sẵn trong message-processor.properties:
| Thuộc tính | Mô tả |
|---|---|
conf_message-processor-communication_local. http.host=localhost_or_IP_address |
Không bắt buộc. Tên máy chủ để theo dõi các kết nối của bộ định tuyến. Thao tác này sẽ ghi đè tên máy chủ được định cấu hình khi đăng ký. |
conf/message-processor-communication. properties+local.http.port=8998 |
Không bắt buộc. Cổng để nghe các kết nối của bộ định tuyến. Giá trị mặc định là 8998. |
conf_message-processor-communication_local. http.ssl=[ false | true ] |
Đặt giá trị này thành true để bật TLS/SSL. Giá trị mặc định là false. Khi
bật TLS/SSL, bạn phải đặt local.http.ssl.keystore.path và
local.http.ssl.keyalias.
|
conf/message-processor-communication. properties+local.http.ssl.keystore.path= |
Đường dẫn hệ thống tệp cục bộ đến kho khoá (JKS hoặc PKCS12). Bắt buộc khi
local.http.ssl=true. |
conf/message-processor-communication. properties+local.http.ssl.keyalias= |
Bí danh khoá từ kho khoá sẽ được dùng cho các kết nối TLS/SSL. Bắt buộc khi
local.http.ssl=true. |
conf/message-processor-communication. properties+local.http.ssl.keyalias.password= |
Mật khẩu dùng để mã hoá khoá bên trong kho khoá. Sử dụng mật khẩu đã làm rối mã nguồn
theo định dạng sau:
OBF:obsPword |
conf/message-processor-communication. properties+local.http.ssl.keystore.type=jks |
Loại kho khoá. Hiện chỉ hỗ trợ JKS và PKCS12. Mặc định là JKS. |
conf/message-processor-communication. properties+local.http.ssl.keystore.password= |
Không bắt buộc. Mật khẩu bị làm rối mã nguồn cho kho khoá. Sử dụng mật khẩu đã làm rối mã nguồn theo định dạng sau:
OBF:obsPword |
conf_message-processor-communication_local. http.ssl.ciphers=cipher1,cipher2 |
Không bắt buộc. Khi được định cấu hình, chỉ những mật mã có trong danh sách mới được cho phép. Nếu bạn bỏ qua, hãy sử dụng tất cả mật mã được JDK hỗ trợ. |