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

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:

  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 Premise 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 karartılmış anahtar deposu ve keyalias şifrenizdir.

    Not: value parametresinin değeri,

    conf/message-processor-communication.properties+local.http.ssl.keyalias=apigee-devtest
    , JKS dosyası oluşturma bölümünün sonunda açıklanan keytool komutunun -alias seçeneği tarafından sağlanan değerle aynı olmalıdır.

    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 sahibi olan kullanıcının "apigee" 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. Mesaj İşleyicileri ve Yönlendiricileri 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. Bu işlemi her Mesaj İşleyici için tekrarlayın.

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

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

Bu INFO ifadesi, yönlendirici ile mesaj işlemcisi arasında TLS'nin çalıştığını doğrular.

Aşağıdaki tabloda, message-processor.properties içinde kullanılabilen tüm ö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, 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 ayarı true olarak ayarlayın. Varsayılan değer: false. 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. Aşağıdaki durumlarda zorunludur: local.http.ssl=true.
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. Aşağıdaki biçimde karartılmış bir şifre kullanın:
OBF:obsPword
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 karartılmış şifre. Aşağıdaki biçimde gizlenmiş bir şifre kullanın:
OBF:obsPword
conf_message-processor-communication_local.
  http.ssl.ciphers=cipher1,cipher2
İsteğe bağlıdır. Yapılandırıldığında yalnızca listelenen şifreleme algoritmalarına izin verilir. Atlanırsa JDK tarafından desteklenen tüm şifreler kullanılır.