Edge for Private Cloud v4.18.01
По умолчанию Router и Message Processor поддерживают TLS версий 1.0, 1.1 и 1.2. Однако вы можете ограничить список поддерживаемых протоколов. В этом документе описывается, как настроить протокол глобально на маршрутизаторе и процессоре сообщений.
Для маршрутизатора вы также можете задать протокол для отдельных виртуальных хостов. Подробнее о том, как настроить доступ к API через TLS для Private Cloud…
Для Message Processor можно задать протокол для отдельной конечной точки TargetEndpoint. Подробнее о том, как настроить TLS для передачи данных между Edge и серверной частью (Cloud и Private Cloud)…
Как настроить протокол TLS на маршрутизаторе
Чтобы настроить протокол TLS на маршрутизаторе, задайте свойства в файле router.properties:
- Откройте файл router.properties в редакторе. Если файла нет, создайте его:
> vi /opt/apigee/customer/application/router.properties - Задайте нужные свойства:
# Возможные значения разделенный пробелами список: TLSv1 TLSv1.1 TLSv1.2
conf_load_balancing_load.balancing.driver.server.ssl.protocols=TLSv1.2 - Сохраните изменения.
- Убедитесь, что файл свойств принадлежит пользователю apigee:
> chown apigee:apigee /opt/apigee/customer/application/router.properties - Перезапустите маршрутизатор:
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart - Убедитесь, что протокол обновлен правильно. Для этого проверьте файл Nginx /opt/nginx/conf.d/0-default.conf:
> cat /opt/nginx/conf.d/0-default.conf
Убедитесь, что для параметра ssl_protocols задано значение TLSv1.2. - Если вы используете двусторонний TLS с виртуальным хостом, вам также необходимо настроить протокол TLS в виртуальном хосте, как описано в статье Настройка доступа TLS к API для частного облака.
Настройте протокол TLS в Message Processor
Чтобы настроить протокол TLS в Message Processor, задайте свойства в файле message-processor.properties:
- Откройте файл message-processor.properties в редакторе. Если файла нет, создайте его:
> vi /opt/apigee/customer/application/message-processor.properties - Задайте нужные свойства:
# Возможные значения – это разделенный запятыми список TLSv1, TLSv1.1, TLSv1.2
conf/system.properties+https.protocols=TLSv1.2
# Возможные значения – это разделенный запятыми список SSLv3, TLSv1, TLSv1.1, TLSv1.2
# Обязательно включите SSLv3.
conf/jvmsecurity.properties+jdk.tls.disabledAlgorithms=SSLv3, TLSv1, TLSv1.1
#Configure the ciphers that need to be supported by the Message Processor: communication_local.http.ssl.ciphers=TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,TLS_RSA_WITH_AES_256_GCM_SHA384,TLS_ECDH_ECDSA_WITH_AES_256_GCM_SHA384,TLS_ECDH_RSA_WITH_AES_256_GCM_SHA384,TLS_DHE_RSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 - Сохраните изменения.
- Убедитесь, что файл свойств принадлежит пользователю apigee:
> chown apigee:apigee /opt/apigee/customer/application/message-processor.properties - Перезапустите Message Processor:
> /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart - Если вы используете двусторонний протокол TLS с бэкендом, настройте протокол TLS на виртуальном хосте, как описано в статье Настройка TLS от Edge до бэкенда (Cloud и Private Cloud).