Edge для частного облака v4.18.01
По умолчанию TLS между маршрутизатором и процессором сообщений отключен.
Используйте следующую процедуру, чтобы включить шифрование TLS между маршрутизатором и процессором сообщений:
- Убедитесь, что порт 8082 процессора сообщений доступен маршрутизатору.
- Создайте файл JKS хранилища ключей, содержащий сертификат TLS и закрытый ключ. Дополнительные сведения см. в разделе Настройка TLS/SSL для Edge On Premises .
- Скопируйте файл JKS хранилища ключей в каталог на сервере обработчика сообщений, например /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 — запутанное хранилище ключей и пароль keyalias. См. Настройка TLS/SSL для Edge On Premises для получения информации о создании скрытого пароля. - Убедитесь, что файл message-processor.properties принадлежит пользователю 'apigee':
> chown apigee:apigee /opt/apigee/customer/application/message-processor.properties - Остановите процессоры сообщений и маршрутизаторы:
/opt/apigee/apigee-service/bin/apigee-service остановка пограничного процессора сообщений
/opt/apigee/apigee-service/bin/apigee-service остановка пограничного маршрутизатора - На маршрутизаторе удалите все файлы в /opt/nginx/conf.d :
> rm -f /opt/nginx/conf.d/* - Запустите процессоры сообщений и маршрутизаторы:
/opt/apigee/apigee-service/bin/apigee-service запуск пограничного процессора сообщений
/opt/apigee/apigee-service/bin/apigee-service запуск пограничного маршрутизатора - Повторите для любых дополнительных процессоров сообщений.
После включения TLS между маршрутизатором и обработчиком сообщений файл журнала обработчика сообщений содержит следующее ИНФО-сообщение:
MessageProcessorHttpSkeletonFactory.configureSSL() : Instantiating Keystore of type: jks
Этот оператор INFO подтверждает, что TLS работает между маршрутизатором и процессором сообщений.
В следующей таблице перечислены все доступные свойства в message-processor.properties:
Характеристики | Описание |
|---|---|
conf_message-processor-communication_local.http.host=<локальный хост или IP-адрес> | Необязательный. Имя хоста для прослушивания подключений маршрутизатора. Это переопределит имя хоста, заданное при регистрации. |
conf/message-processor-communication.properties+local.http.port=8998 | Необязательный. Порт для прослушивания подключений маршрутизатора. По умолчанию 8998. |
conf_message-processor-communication_local.http.ssl=<false | правда> | Установите значение true, чтобы включить TLS/SSL. Значение по умолчанию — ложь. Когда 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. |