De forma predeterminada, TLS entre el router y el Message Processor está inhabilitado.
Para habilitar la encriptación TLS entre un router y un Message Processor, sigue estos pasos:
- Asegúrate de que el router pueda acceder al puerto 8082 del Message Processor.
- 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.
- Copia el archivo JKS del almacén de claves en un directorio del servidor del Message Processor, como
/opt/apigee/customer/application. - Cambia los permisos y la propiedad del archivo JKS:
chown apigee:apigee /opt/apigee/customer/application/keystore.jks
chmod 600 /opt/apigee/customer/application/keystore.jksDonde
keystore.jkses el nombre de tu archivo de almacén de claves. - Edita el archivo
/opt/apigee/customer/application/message-processor.properties. Si el archivo no existe, créalo. - 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=/opt/apigee/customer/application/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.jkses tu archivo de almacén de claves y obsPword es tu contraseña ofuscada de almacén de claves y alias de clave. Consulta Configura TLS/SSL para Edge local para obtener información sobre cómo generar una contraseña ofuscada. - Asegúrate de que el archivo
message-processor.propertiessea propiedad del usuario "apigee":chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
- Detén los Message Processors y los routers:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
/opt/apigee/apigee-service/bin/apigee-service edge-router stop - En el router, borra todos los archivos del directorio
/opt/nginx/conf.d:rm -f /opt/nginx/conf.d/*
- Inicia los Message Processors y los routers:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor start
/opt/apigee/apigee-service/bin/apigee-service edge-router start - Repite este proceso para cada Message Processor.
Después de habilitar TLS entre el router y el Message Processor, el archivo de registro del Message Processor
contiene este mensaje INFO:
MessageProcessorHttpSkeletonFactory.configureSSL() : Instantiating Keystore of type: jks
Esta declaración INFO confirma que TLS funciona entre el router y el Message Processor.
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 anula 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 en true para habilitar TLS/SSL. La ruta predeterminada es false. 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. 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 el siguiente formato:
OBF:obsPword |
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 el
siguiente formato:
OBF:obsPword |
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. |