Secara default, Router dan Message Processor mendukung TLS versi 1.0, 1.1, 1.2. Namun, Anda mungkin ingin membatasi protokol yang didukung oleh Router dan Message Processor. Dokumen ini menjelaskan cara menetapkan protokol secara global di Router dan Message Processor.
Untuk Router, Anda juga dapat menetapkan protokol untuk setiap host virtual. Lihat Mengonfigurasi akses TLS ke API untuk Cloud Pribadi untuk mengetahui informasi selengkapnya.
Untuk Message Processor, Anda dapat menetapkan protokol untuk setiap TargetEndpoint. Lihat Mengonfigurasi TLS dari Edge ke backend (Cloud dan cloud pribadi) untuk mengetahui informasi selengkapnya.
Menetapkan protokol TLS di Router
Untuk menetapkan protokol TLS di Router, tetapkan properti di file router.properties:
- Buka file
router.propertiesdi editor. Jika file tidak ada, buat file:vi /opt/apigee/customer/application/router.properties
- Tetapkan properti sesuai keinginan:
# Possible values are space-delimited list of: TLSv1 TLSv1.1 TLSv1.2 conf_load_balancing_load.balancing.driver.server.ssl.protocols=TLSv1.2
- Simpan perubahan.
- Pastikan file properti dimiliki oleh pengguna "apigee":
chown apigee:apigee /opt/apigee/customer/application/router.properties
- Mulai Ulang Router:
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
- Pastikan protokol telah diperbarui dengan benar dengan memeriksa file NGINX
/opt/nginx/conf.d/0-default.conf:cat /opt/nginx/conf.d/0-default.conf
Pastikan nilai untuk
ssl_protocolsadalah TLSv1.2. - Jika Anda menggunakan TLS dua arah dengan host virtual, Anda juga harus menetapkan protokol TLS di host virtual seperti yang dijelaskan dalam Mengonfigurasi akses TLS ke API untuk cloud pribadi.
Menetapkan protokol TLS pada Message Processor
Untuk menetapkan protokol TLS pada Message Processor, tetapkan properti dalam file message-processor.properties:
- Buka file
message-processor.propertiesdi editor. Jika file tidak ada, buat file:vi /opt/apigee/customer/application/message-processor.properties
- Konfigurasi properti menggunakan sintaksis berikut:
# 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[,...]
Nilai yang mungkin untuk
conf_message-processor-communication_local.http.ssl.ciphersadalah: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
Contoh:
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
Untuk mengetahui daftar lengkap properti terkait, lihat Mengonfigurasi TLS antara Router dan Message Processor.
- Simpan perubahan.
- Pastikan file properti dimiliki oleh pengguna "apigee":
chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
- Mulai ulang Message Processor:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
- Jika Anda menggunakan TLS dua arah dengan backend, tetapkan protokol TLS di host virtual seperti yang dijelaskan dalam Mengonfigurasi TLS dari Edge ke backend (Cloud dan Cloud Pribadi).