Yönlendirici ile İleti İşleyici arasında TLS'yi yapılandırma

Edge for Private Cloud 4.19.01 sürümü

Varsayılan olarak, Yönlendirici ile Mesaj İşleyici arasındaki TLS devre dışıdır.

Yönlendirici ile Mesaj İşleyici arasında TLS şifrelemesini etkinleştirmek için aşağıdaki prosedürü kullanın:

  1. Mesaj İşlemci'deki 8082 numaralı bağlantı noktasına yönlendirici tarafından erişilebildiğinden emin olun.
  2. TLS sertifikanızı ve özel anahtarınızı içeren anahtar deposu JKS dosyasını oluşturun. Daha fazla bilgi için Edge On Premises için TLS/SSL'yi yapılandırma başlıklı makaleyi inceleyin.
  3. Anahtar deposu JKS dosyasını, Mesaj İşleyici sunucusundaki bir dizine (ör. /opt/apigee/customer/application) kopyalayın.
  4. JKS dosyasının izinlerini ve sahipliğini değiştirin: 
    chown apigee:apigee /opt/apigee/customer/application/keystore.jks
chmod 600 /opt/apigee/customer/application/keystore.jks

    keystore.jks, anahtar deposu dosyanızın adıdır.

  5. /opt/apigee/customer/application/message-processor.properties dosyasını düzenleyin. Dosya yoksa oluşturun.
  6. message-processor.properties dosyasında aşağıdaki özellikleri ayarlayın: 
    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
# Enter the obfuscated keystore password below.
conf/message-processor-communication.properties+local.http.ssl.keystore.password=OBF:obsPword

    Burada keystore.jks, anahtar deposu dosyanız, obsPword ise gizlenmiş anahtar deponuz ve anahtar takma adı şifrenizdir. Gizlenmiş şifre oluşturma hakkında bilgi için Edge On Premises için TLS/SSL'yi yapılandırma başlıklı makaleyi inceleyin.

  7. message-processor.properties dosyasının "apigee" kullanıcısına ait olduğundan emin olun: 
    chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
  8. Mesaj İşleyicileri ve Yönlendiricileri durdurun: 
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
/opt/apigee/apigee-service/bin/apigee-service edge-router stop
  9. Yönlendirici'de, /opt/nginx/conf.d dizinindeki tüm dosyaları silin: 
    rm -f /opt/nginx/conf.d/*
  10. Message-Processor'ları ve Router'ları başlatın: 
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor start
/opt/apigee/apigee-service/bin/apigee-service edge-router start
  11. Diğer Mesaj İşlemciler için bu adımları tekrarlayın.

Yönlendirici ile Mesaj İşleyici arasında TLS etkinleştirildikten sonra Mesaj İşleyici günlük dosyası şu BİLGİ mesajını içerir:

MessageProcessorHttpSkeletonFactory.configureSSL() : Instantiating Keystore of type: jks

Bu INFO ifadesi, TLS'nin Yönlendirici ile Mesaj İşleyici arasında çalıştığını doğrular.

Aşağıdaki tabloda, message-processor.properties dosyasındaki tüm kullanılabilir özellikler listelenmiştir:

Özellikler Açıklama 
conf_message-processor-communication_local.
  http.host=localhost_or_IP_address
 İsteğe bağlıdır. Yönlendirici bağlantıları için dinlenecek ana makine adı. Bu işlem, kayıt sırasında yapılandırılan ana makine adını geçersiz kılar. 
conf/message-processor-communication.
  properties+local.http.port=8998
 İsteğe bağlıdır. Yönlendirici bağlantıları için dinlenecek bağlantı noktası. Varsayılan değer 8998'dir. 
conf_message-processor-communication_local.
  http.ssl=[ false | true ]
 TLS/SSL'yi etkinleştirmek için bu değeri "true" olarak ayarlayın. Varsayılan değer "false"dur. TLS/SSL etkinleştirildiğinde local.http.ssl.keystore.path ve local.http.ssl.keyalias ayarlarını yapmanız gerekir. 
conf/message-processor-communication.
  properties+local.http.ssl.keystore.path=
 Anahtar deposunun (JKS veya PKCS12) yerel dosya sistemi yolu. local.http.ssl=true olduğunda zorunludur. 
conf/message-processor-communication.
  properties+local.http.ssl.keyalias=
 TLS/SSL bağlantıları için kullanılacak anahtar deposundaki anahtar takma adı. local.http.ssl=true olduğunda zorunludur. 
conf/message-processor-communication.
  properties+local.http.ssl.keyalias.password=
 Anahtar deposundaki anahtarı şifrelemek için kullanılan şifre. Şu biçimde gizlenmiş bir şifre kullanın: OBF:xxxxxxxxxx 
conf/message-processor-communication.
  properties+local.http.ssl.keystore.type=jks
 Anahtar deposu türü. Şu anda yalnızca JKS ve PKCS12 desteklenmektedir. Varsayılan değer JKS'dir. 
conf/message-processor-communication.
  properties+local.http.ssl.keystore.password=
 İsteğe bağlıdır. Anahtar deposu için gizlenmiş şifre. Şu biçimde gizlenmiş bir şifre kullanın: OBF:xxxxxxxxxx 
conf_message-processor-communication_local.
  http.ssl.ciphers=cipher1,cipher2
 İsteğe bağlıdır. Yapılandırıldığında yalnızca listelenen şifrelemelere izin verilir. Atlanırsa JDK tarafından desteklenen tüm şifreler kullanılır.