Configura el protocolo TLS para el router y el procesador de mensajes

Edge para nube privada v4.18.01

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:

  1. Abre el archivo router.properties en un editor. Si el archivo no existe, créalo:
    > vi /opt/apigee/customer/application/router.properties
  2. Establece las propiedades como desees:
    # Los valores posibles son una lista delimitada por espacios de: TLSv1 TLSv1.1 TLSv1.2
    conf_load_balancing_load.balancing.driver.server.ssl.protocols=TLSv1.2
  3. Guarda los cambios.
  4. Asegúrate de que el archivo de propiedades sea propiedad del usuario "apigee":
    > chown apigee:apigee /opt/apigee/customer/application/router.properties
  5. Reinicia el router:
    > /opt/apigee/apigee-service/bin/apigee-service edge-router restart
  6. Examina el archivo de Nginx /opt/nginx/conf.d/0-default.conf para verificar que el protocolo se haya actualizado correctamente:
    > cat /opt/nginx/conf.d/0-default.conf

    Asegúrate de que el valor de ssl_protocols sea TLSv1.2.
  7. 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 establecer el protocolo TLS en el Message Processor, configura las propiedades en el archivo message-processor.properties:

  1. Abre el archivo message-processor.properties en un editor. Si el archivo no existe, créalo:
    > vi /opt/apigee/customer/application/message-processor.properties
  2. Establece las propiedades como desees:
    # Los valores posibles son una lista delimitada por comas de TLSv1, TLSv1.1, TLSv1.2
    conf/system.properties+https.protocols=TLSv1.2
    # Los valores posibles son una lista delimitada por comas de SSLv3, TLSv1, TLSv1.1, TLSv1.2
    # Asegúrate de incluir SSLv3.
    conf/jvmsecurity.properties+jdk.tls.disabledAlgorithms=SSLv3, TLSv1, TLSv1.1

    #Configure the ciphers that need to be supported by the 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
  3. Guarda los cambios.
  4. Asegúrate de que el archivo de propiedades sea propiedad del usuario "apigee":
    > chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
  5. Reinicia el Message Processor:
    > /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
  6. Si usas TLS bidireccional con el backend, configura el protocolo TLS en el host virtual como se describe en Configura TLS de Edge al backend (nube y nube privada).