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

Edge для частного облака v. 4.16.05

По умолчанию TLS между маршрутизатором и процессором сообщений отключен.

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

  1. Убедитесь, что порт 8082 процессора сообщений доступен маршрутизатору.
  2. Создайте файл JKS хранилища ключей, содержащий сертификат TLS и закрытый ключ. Дополнительные сведения см. в разделе Настройка TLS/SSL для Edge On Premises .
  3. Скопируйте файл JKS хранилища ключей в каталог /tmp на сервере Message Processor.
  4. Измените разрешения и владельца файла JKS:
    > chown apigee:apigee /tmp/keystore.jks
    > chmod 600 /tmp/keystore.jks


    где keystore.jks — это имя вашего файла хранилища ключей.
  5. Отредактируйте файл /<inst_root>/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=/tmp/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 для получения информации о создании скрытого пароля.
  7. Убедитесь, что файл message-processor.properties принадлежит пользователю 'apigee':
    > chown apigee:apigee /<inst_root>/apigee/customer/application/message-processor.properties
  8. Остановите процессоры сообщений и маршрутизаторы:
    /<install_dir>/apigee/apigee-service/bin/apigee-service edge-message-processor stop
    /<install_dir>/apigee/apigee-service/bin/apigee-service edge-router stop
  9. На маршрутизаторе удалите все файлы в /opt/nginx/conf.d :
    > rm -f /opt/nginx/conf.d/*
  10. Запустите процессоры сообщений и маршрутизаторы:
    /<install_dir>/apigee/apigee-service/bin/apigee-service edge-message-processor start
    /<install_dir>/apigee/apigee-service/bin/apigee-service запуск пограничного маршрутизатора
  11. Повторите для любых дополнительных процессоров сообщений.

В следующей таблице перечислены все доступные свойства в 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.