Edge for Private Cloud v4.19.01
Par défaut, le routeur et le processeur de messages sont compatibles avec les versions TLS 1.0, 1.1 et 1.2. Toutefois, vous pouvez limiter les protocoles compatibles avec le routeur et le processeur de messages. Ce document explique comment définir le protocole de manière globale sur le routeur et le processeur de messages.
Pour le routeur, vous pouvez également définir le protocole pour des hôtes virtuels individuels. Pour en savoir plus, consultez Configurer l'accès TLS à une API pour Private Cloud.
Pour le processeur de messages, vous pouvez définir le protocole pour un TargetEndpoint individuel. Pour en savoir plus, consultez la page Configurer TLS de la périphérie au backend (cloud et cloud privé).
Définir le protocole TLS sur le routeur
Pour définir le protocole TLS sur le routeur, définissez les propriétés dans le fichier router.properties :
- Ouvrez le fichier
router.propertiesdans un éditeur. Si le fichier n'existe pas, créez-le :vi /opt/apigee/customer/application/router.properties
- Définissez les propriétés de votre choix :
# Possible values are space-delimited list of: TLSv1 TLSv1.1 TLSv1.2 conf_load_balancing_load.balancing.driver.server.ssl.protocols=TLSv1.2
- Enregistrez les modifications.
- Assurez-vous que le fichier de propriétés appartient à l'utilisateur "apigee" :
chown apigee:apigee /opt/apigee/customer/application/router.properties
- Redémarrez le routeur :
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
- Vérifiez que le protocole est correctement mis à jour en examinant le fichier Nginx
/opt/nginx/conf.d/0-default.conf:cat /opt/nginx/conf.d/0-default.conf
Assurez-vous que la valeur de
ssl_protocolsest TLSv1.2. - Si vous utilisez le protocole TLS bidirectionnel avec un hôte virtuel, vous devez également définir le protocole TLS dans l'hôte virtuel, comme décrit dans Configurer l'accès TLS à une API pour Private Cloud.
Définir le protocole TLS sur le processeur de messages
Pour définir le protocole TLS sur le processeur de messages, définissez les propriétés dans le fichier message-processor.properties :
- Ouvrez le fichier
message-processor.propertiesdans un éditeur. Si le fichier n'existe pas, créez-le :vi /opt/apigee/customer/application/message-processor.properties
- Définissez les propriétés de votre choix :
# Possible values are a comma-delimited list of TLSv1, TLSv1.1, TLSv1.2 conf/system.properties+https.protocols=TLSv1.2 # Possible values are a comma-delimited list of SSLv3, TLSv1, TLSv1.1, TLSv1.2 # Ensure that you include SSLv3 conf/jvmsecurity.properties+jdk.tls.disabledAlgorithms=SSLv3, TLSv1, TLSv1.1 # Specify the ciphers that need to be supported by the Message Processor: conf_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
- Enregistrez les modifications.
- Assurez-vous que le fichier de propriétés appartient à l'utilisateur "apigee" :
chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
- Redémarrez le processeur de messages :
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
- Si vous utilisez le protocole TLS bidirectionnel avec le backend, définissez le protocole TLS dans l'hôte virtuel comme décrit dans Configurer TLS de la périphérie au backend (cloud et cloud privé).