Secara default, Router dan Prosesor Pesan mendukung TLS versi 1.0, 1.1, 1.2. Namun, Anda mungkin ingin membatasi protokol yang didukung oleh Router dan Pemroses Pesan. Dokumen ini menjelaskan cara menetapkan protokol secara global di Router dan Pemroses Pesan.
Untuk {i>Router<i}, Anda juga dapat mengatur protokol untuk setiap {i>host<i} virtual. Lihat Mengonfigurasi akses TLS ke API untuk Private Cloud untuk mengetahui informasi selengkapnya.
Untuk Pemroses Pesan, Anda dapat menetapkan protokol untuk TargetEndpoint individual. Lihat Mengonfigurasi TLS dari Edge ke backend (Cloud dan Private Cloud) untuk mengetahui informasi selengkapnya.
Menyetel protokol TLS di Router
Untuk menetapkan protokol TLS pada Router, tetapkan properti dalam file router.properties
:
- Buka file
router.properties
di editor. Jika file tidak ada, buat file tersebut: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 bahwa protokol 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_protocols
adalah TLSv1.2. - Jika menggunakan TLS dua arah dengan host virtual, Anda juga harus menyetel protokol TLS di host virtual seperti yang dijelaskan dalam Mengonfigurasi akses TLS ke API untuk Private Cloud.
Menetapkan protokol TLS pada Pemroses Pesan
Untuk menetapkan protokol TLS pada Pemroses Pesan, tetapkan properti dalam file message-processor.properties
:
- Buka file
message-processor.properties
di editor. Jika file tidak ada, buat file tersebut:vi /opt/apigee/customer/application/message-processor.properties
- Konfigurasikan 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.ciphers
adalah: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
Contoh:
conf/system.properties+https.protocols=TLSv1.2 conf/jvmsecurity.properties+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 daftar lengkap properti terkait, lihat Mengonfigurasi TLS antara Router dan Pemroses Pesan.
- Simpan perubahan.
- Pastikan file properti dimiliki oleh pengguna "apigee":
chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
- Mulai ulang Pemroses Pesan:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
- Jika Anda menggunakan TLS dua arah dengan backend, setel protokol TLS di host virtual seperti yang dijelaskan dalam Mengonfigurasi TLS dari Edge ke backend (Cloud dan Private Cloud).