Cómo configurar TLS entre un router y un procesador de mensajes

Edge para nube privada v. 4.16.05

De forma predeterminada, TLS entre el router y el Message Processor está inhabilitado.

Usa el siguiente procedimiento para habilitar la encriptación TLS entre un router y el Message Processor:

  1. Asegúrate de que el router pueda acceder al puerto 8082 del Message Processor.
  2. Genera el archivo JKS del almacén de claves que contiene tu certificación TLS y tu clave privada. Para obtener más información, consulta Configura TLS/SSL para Edge local.
  3. Copia el archivo JKS del almacén de claves en el directorio /tmp del servidor del Message Processor.
  4. Cambia los permisos y la propiedad del archivo JKS:
    > chown apigee:apigee /tmp/keystore.jks
    > chmod 600 /tmp/keystore.jks


    donde keystore.jks es el nombre de tu archivo de almacén de claves.
  5. Edita el archivo /<inst_root>/apigee/customer/application/message-processor.properties. Si el archivo no existe, créalo.
  6. Establece las siguientes propiedades en el archivo 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=/tmp/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


    donde keyStore.jks es tu archivo de almacén de claves y obsPword es tu almacén de claves ofuscado y la contraseña de alias de clave. Consulta Configura TLS/SSL para Edge local para obtener información sobre cómo generar una contraseña ofuscada.
  7. Asegúrate de que el archivo message-processor.properties sea propiedad del usuario "apigee":
    > chown apigee:apigee /<inst_root>/apigee/customer/application/message-processor.properties
  8. Detén los Message Processor y los routers:
    /<install_dir>/apigee/apigee-service/bin/apigee-service edge-message-processor stop
    /<install_dir>/apigee/apigee-service/bin/apigee-service edge-router stop
  9. En el router, borra los archivos de /opt/nginx/conf.d:
    > rm -f /opt/nginx/conf.d/*
  10. Inicia los Message Processors y los routers:
    /<install_dir>/apigee/apigee-service/bin/apigee-service edge-message-processor start
    /<install_dir>/apigee/apigee-service/bin/apigee-service edge-router start
  11. Repite el proceso para cualquier Message Processor adicional.

En la siguiente tabla, se enumeran todas las propiedades disponibles en message-processor.properties:

Propiedades

Descripción

conf_message-processor-communication_local.http.host=<localhost or IP address>

Opcional. Es el nombre de host en el que se escucharán las conexiones del router. Esto anulará el nombre de host configurado en el registro.

conf/message-processor-communication.properties+local.http.port=8998

Opcional. Es el puerto en el que se escuchan las conexiones del router. El valor predeterminado es 8998.

conf_message-processor-communication_local.http.ssl=<false | true>

Establece este valor como verdadero para habilitar TLS/SSL. El valor predeterminado es falso. Cuando TLS/SSL está habilitado, debes configurar local.http.ssl.keystore.path y local.http.ssl.keyalias.

conf/message-processor-communication.properties+local.http.ssl.keystore.path=

Ruta de acceso del sistema de archivos local al almacén de claves (JKS o PKCS12). Obligatorio cuando local.http.ssl=true.

conf/message-processor-communication.properties+local.http.ssl.keyalias=

Es el alias de la clave del almacén de claves que se usará para las conexiones TLS/SSL. Es obligatorio cuando local.http.ssl=true.

conf/message-processor-communication.properties+local.http.ssl.keyalias.password=

Es la contraseña que se usa para encriptar la clave dentro del almacén de claves. Usa una contraseña ofuscada con este formato: OBF:xxxxxxxxxx

conf/message-processor-communication.properties+local.http.ssl.keystore.type=jks

Es el tipo de almacén de claves. Actualmente, solo se admiten JKS y PKCS12. El valor predeterminado es JKS.

conf/message-processor-communication.properties+local.http.ssl.keystore.password=

Opcional. Es la contraseña ofuscada del almacén de claves. Usa una contraseña ofuscada con este formato: OBF:xxxxxxxxxx

conf_message-processor-communication_local.http.ssl.ciphers=<cipher1,cipher2>

Opcional. Cuando se configura, solo se permiten los algoritmos de cifrado que se indican. Si se omite, se usan todos los algoritmos de cifrado que admite el JDK.