Yönlendirici ve İleti İşleyici için TLS protokolünü ayarlama

Varsayılan olarak, Yönlendirici ve Mesaj İşleyici; TLS 1.0, 1.1, 1.2 sürümlerini destekler. Ancak Yönlendirici ve Mesaj İşleyici tarafından desteklenen protokolleri sınırlamak isteyebilirsiniz. Bu dokümanda, protokolün Router ve Mesaj İşleyici'de genel olarak nasıl ayarlanacağı açıklanmaktadır.

Yönlendirici için protokolü ayrı ayrı sanal ana makineler için de ayarlayabilirsiniz. Daha fazla bilgi için Private Cloud için bir API'ye TLS erişimini yapılandırma başlıklı makaleyi inceleyin.

Mesaj İşleyici için protokolü tek bir TargetEndpoint'e ayarlayabilirsiniz. Daha fazla bilgi için Edge'den arka uca TLS'yi yapılandırma (Cloud ve Private Cloud) başlıklı makaleyi inceleyin.

Yönlendiricide TLS protokolünü ayarlama

Yönlendirici'de TLS protokolünü ayarlamak için router.properties dosyasındaki özellikleri ayarlayın:

1. router.properties dosyasını bir düzenleyicide açın. Dosya yoksa oluşturun:

   vi /opt/apigee/customer/application/router.properties

2. Özellikleri istediğiniz gibi ayarlayın:

   # Possible values are space-delimited list of: TLSv1 TLSv1.1 TLSv1.2
   conf_load_balancing_load.balancing.driver.server.ssl.protocols=TLSv1.2

3. Değişikliklerinizi kaydedin.
4. Özellikler dosyasının "apigee" kullanıcısına ait olduğundan emin olun:

    chown apigee:apigee /opt/apigee/customer/application/router.properties

5. Yönlendiriciyi yeniden başlatın:

   /opt/apigee/apigee-service/bin/apigee-service edge-router restart

6. NGINX dosyasını inceleyerek protokolün doğru şekilde güncellendiğini doğrulayın /opt/nginx/conf.d/0-default.conf:

   cat /opt/nginx/conf.d/0-default.conf

   ssl_protocols değerinin TLSv1.2 olduğundan emin olun.

7. Sanal ana makineyle çift yönlü TLS kullanıyorsanız sanal ana makinede TLS protokolünü de Özel Bulut için bir API'ye TLS erişimini yapılandırma bölümünde açıklandığı şekilde ayarlamanız gerekir.

Mesaj İşlemcisi'nde TLS protokolünü ayarlama

Mesaj İşlemci'de TLS protokolünü ayarlamak için message-processor.properties dosyasında özellikleri ayarlayın:

1. message-processor.properties dosyasını bir düzenleyicide açın. Dosya yoksa oluşturun:

   vi /opt/apigee/customer/application/message-processor.properties

2. Özellikleri aşağıdaki söz dizimini kullanarak yapılandırın:

   # Possible values are a comma-delimited list of TLSv1, TLSv1.1, and TLSv1.2
   conf/system.properties+https.protocols=[TLSv1][,TLSv1.1][,TLSv1.2]
   # Possible values are a comma-delimited list of SSLv3, TLSv1, TLSv1.1, TLSv1.2
   # SSLv3 is required
   conf_jvmsecurity_jdk.tls.disabledAlgorithms=SSLv3[,TLSv1][,TLSv1.1][,TLSv1.2]
   
   # Specify the ciphers that the Message Processor supports. (You must separate ciphers with a comma.):
   conf_message-processor-communication_local.http.ssl.ciphers=cipher[,...]

   conf_message-processor-communication_local.http.ssl.ciphers için olası değerler:

   • 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

   Örneğin:

   conf/system.properties+https.protocols=TLSv1.2
   conf_jvmsecurity_jdk.tls.disabledAlgorithms=SSLv3, TLSv1, TLSv1.1
   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

   İlgili özelliklerin tam listesi için Yönlendirici ile Mesaj İşlemci arasında TLS yapılandırma başlıklı makaleyi inceleyin.

3. Değişikliklerinizi kaydedin.
4. Özellikler dosyasının "apigee" kullanıcısına ait olduğundan emin olun:

   chown apigee:apigee /opt/apigee/customer/application/message-processor.properties

5. Mesaj İşleyici'yi yeniden başlatın:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

6. Arka uçla iki yönlü TLS kullanıyorsanız sanal ana makinede TLS protokolünü Edge'den arka uca TLS yapılandırma (Cloud ve Private Cloud) bölümünde açıklandığı şekilde ayarlayın.