Настройка TLS между маршрутизатором и процессором сообщений

По умолчанию TLS между маршрутизатором и Message Processor отключен.

Чтобы включить шифрование TLS между маршрутизатором и процессором сообщений:

1. Убедитесь, что маршрутизатор может получить доступ к порту 8082 на Message Processor.
2. Создайте файл хранилища ключей JKS, содержащий сертификат TLS и закрытый ключ. Подробнее о настройке TLS/SSL для локальной версии Edge…
3. Скопируйте файл хранилища ключей JKS в каталог на сервере Message Processor, например /opt/apigee/customer/application.
4. Измените разрешения и право собственности на файл JKS:

   chown apigee:apigee /opt/apigee/customer/application/keystore.jks
   chmod 600 /opt/apigee/customer/application/keystore.jks

   где keystore.jks – название файла хранилища ключей.

5. Отредактируйте файл /opt/apigee/customer/application/message-processor.properties. Если файла нет, создайте его.
6. Задайте в файле 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

   где keystore.jks – это файл хранилища ключей, а obsPword – обфусцированный пароль хранилища ключей и псевдонима ключа.

   Примечание. Значение

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

   должно совпадать со значением, указанным в параметре -alias команды keytool, описанной в конце раздела Создание файла JKS.

   Информацию о том, как создать обфусцированный пароль, можно найти в статье Настройка TLS/SSL для локальной версии Edge.

7. Убедитесь, что файл message-processor.properties принадлежит пользователю apigee:

   chown apigee:apigee /opt/apigee/customer/application/message-processor.properties

8. Остановите процессоры сообщений и маршрутизаторы:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
   /opt/apigee/apigee-service/bin/apigee-service edge-router stop

9. На маршрутизаторе удалите все файлы в каталоге /opt/nginx/conf.d:

   rm -f /opt/nginx/conf.d/*

10. Запустите процессоры сообщений и маршрутизаторы:

    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor start
    /opt/apigee/apigee-service/bin/apigee-service edge-router start

11. Повторите этот процесс для каждого процессора сообщений.

После того как TLS будет включен между маршрутизатором и Message Processor, в файле журнала Message Processor появится сообщение INFO:

MessageProcessorHttpSkeletonFactory.configureSSL() : Instantiating Keystore of type: jks

Это утверждение INFO подтверждает, что TLS работает между маршрутизатором и процессором сообщений.

В таблице ниже перечислены все доступные свойства элемента message-processor.properties:

conf_message-processor-communication_local.
  http.host=localhost_or_IP_address

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

conf_message-processor-communication_local.
  http.ssl=[ false | true ]

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

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

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

OBF:obsPword

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

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

OBF:obsPword

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