Edge for Private Cloud версии 4.17.09
По умолчанию TLS между маршрутизатором и обработчиком сообщений отключен.
Чтобы включить шифрование TLS между маршрутизатором и процессором сообщений, выполните следующие действия:
- Убедитесь, что порт 8082 на Message Processor доступен для маршрутизатора.
- Создайте файл хранилища ключей JKS, содержащий сертификат TLS и закрытый ключ. Подробнее о настройке TLS/SSL для локальной версии Edge…
- Скопируйте файл JKS хранилища ключей в каталог на сервере Message Processor, например /opt/apigee/customer/application.
- Измените разрешения и владельца файла JKS:
> chown apigee:apigee /opt/apigee/customer/application/keystore.jks
> chmod 600 /opt/apigee/customer/application/keystore.jks
где keystore.jks – название файла хранилища ключей. - Измените файл /opt/apigee/customer/application/message-processor.properties. Если файла нет, создайте его.
- Задайте следующие свойства в файле 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
# Введите обфусцированный пароль хранилища ключей ниже.
conf/message-processor-communication.properties+local.http.ssl.keystore.password=OBF:obsPword
где keyStore.jks – файл хранилища ключей, а obsPword – обфусцированный пароль хранилища ключей и псевдонима ключа. Информацию о том, как создать обфусцированный пароль, можно найти в статье Настройка TLS/SSL для локальной версии Edge. - Убедитесь, что владельцем файла message-processor.properties является пользователь apigee:
> chown apigee:apigee /opt/apigee/customer/application/message-processor.properties - Остановите Message-Processor и Router:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
/opt/apigee/apigee-service/bin/apigee-service edge-router stop - На маршрутизаторе удалите все файлы в каталоге /opt/nginx/conf.d:
> rm -f /opt/nginx/conf.d/* - Запустите Message-Processor и Router:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor start
/opt/apigee/apigee-service/bin/apigee-service edge-router start - Повторите эти действия для всех остальных процессоров сообщений.
После включения TLS между маршрутизатором и обработчиком сообщений файл журнала обработчика сообщений содержит следующее информационное сообщение:
MessageProcessorHttpSkeletonFactory.configureSSL() : Instantiating Keystore of type: jks
Это утверждение INFO подтверждает, что TLS работает между маршрутизатором и обработчиком сообщений.
В таблице ниже перечислены все доступные свойства в message-processor.properties:
|
Ресурсы |
Описание |
|---|---|
|
conf_message-processor-communication_local.http.host=<localhost или IP-адрес> |
Необязательное поле. Имя хоста, которое будет использоваться для подключений к маршрутизатору. Это значение переопределит имя хоста, заданное при регистрации. |
|
conf/message-processor-communication.properties+local.http.port=8998 |
Необязательное поле. Порт для прослушивания подключений маршрутизатора. Значение по умолчанию – 8998. |
|
conf_message-processor-communication_local.http.ssl=<false | true> |
Чтобы включить TLS/SSL, задайте значение True. Значение по умолчанию – false. Если протокол TLS/SSL включен, необходимо задать параметры local.http.ssl.keystore.path и local.http.ssl.keyalias. |
|
conf/message-processor-communication.properties+local.http.ssl.keystore.path= |
Путь к хранилищу ключей (JKS или PKCS12) в локальной файловой системе. Обязательный параметр, если local.http.ssl=true. |
|
conf/message-processor-communication.properties+local.http.ssl.keyalias= |
Псевдоним ключа из хранилища ключей, который будет использоваться для подключений TLS/SSL. Обязательный параметр, если local.http.ssl=true. |
|
conf/message-processor-communication.properties+local.http.ssl.keyalias.password= |
Пароль, используемый для шифрования ключа в хранилище. Используйте обфусцированный пароль в следующем формате: OBF:xxxxxxxxxx. |
|
conf/message-processor-communication.properties+local.http.ssl.keystore.type=jks |
Тип хранилища ключей. В настоящее время поддерживаются только JKS и PKCS12. По умолчанию используется JKS. |
|
conf/message-processor-communication.properties+local.http.ssl.keystore.password= |
Необязательное поле. Зашифрованный пароль для хранилища ключей. Используйте обфусцированный пароль в следующем формате: OBF:xxxxxxxxxx. |
|
conf_message-processor-communication_local.http.ssl.ciphers=<cipher1,cipher2> |
Необязательное поле. Если правило настроено, разрешены только перечисленные шифры. Если этот параметр не указан, используются все шифры, поддерживаемые JDK. |