De forma predeterminada, el router y el Message Processor admiten las versiones 1.0, 1.1 y 1.2 de TLS. Sin embargo, es posible que desees limitar los protocolos que admiten el router y el Message Processor. En este documento, se describe cómo configurar el protocolo de forma global en el router y el Message Processor.
En el caso del router, también puedes establecer el protocolo para hosts virtuales individuales. Consulta Configura el acceso TLS a una API para la nube privada para obtener más información.
En el caso del Message Processor, puedes establecer el protocolo para un TargetEndpoint individual. Consulta Configura TLS del perímetro al backend (nube y nube privada) para obtener más información.
Configura el protocolo TLS en el router
Para configurar el protocolo TLS en el router, establece las propiedades en el archivo
router.properties:
- Abre el archivo
router.propertiesen un editor. Si el archivo no existe, créalo:vi /opt/apigee/customer/application/router.properties
- Configura las propiedades como desees:
# Possible values are space-delimited list of: TLSv1 TLSv1.1 TLSv1.2 conf_load_balancing_load.balancing.driver.server.ssl.protocols=TLSv1.2
- Guarda los cambios.
- Asegúrate de que el archivo de propiedades sea propiedad del usuario "apigee":
chown apigee:apigee /opt/apigee/customer/application/router.properties
- Reinicia el router:
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
- Examina el archivo de NGINX
/opt/nginx/conf.d/0-default.confpara verificar que el protocolo se haya actualizado correctamente:cat /opt/nginx/conf.d/0-default.conf
Asegúrate de que el valor de
ssl_protocolssea TLSv1.2. - Si usas TLS de dos vías con un host virtual, también debes configurar el protocolo TLS en el host virtual como se describe en Configura el acceso de TLS a una API para Private Cloud.
Configura el protocolo TLS en el Message Processor
Para configurar el protocolo TLS en el Message Processor, establece las propiedades en el
archivo message-processor.properties:
- Abre el archivo
message-processor.propertiesen un editor. Si el archivo no existe, créalo:vi /opt/apigee/customer/application/message-processor.properties
- Configura las propiedades con la siguiente sintaxis:
# 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[,...]
Los valores posibles para
conf_message-processor-communication_local.http.ssl.ciphersson los siguientes: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
Por ejemplo:
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
Para obtener una lista completa de las propiedades relacionadas, consulta Configura TLS entre un router y un Message Processor.
- Guarda los cambios.
- Asegúrate de que el archivo de propiedades sea propiedad del usuario "apigee":
chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
- Reinicia el Message Processor:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
- Si usas TLS bidireccional con el backend, configura el protocolo TLS en el host virtual como se describe en Configura TLS desde Edge hasta el backend (nube y nube privada).