Mengonfigurasi TLS antara Router dan Pemroses Pesan

Edge for Private Cloud v4.19.01

Secara default, TLS antara Router dan Message Processor dinonaktifkan.

Gunakan prosedur berikut untuk mengaktifkan enkripsi TLS antara Router dan Message Processor:

  1. Pastikan port 8082 di Message Processor dapat diakses oleh Router.
  2. Buat file JKS keystore yang berisi sertifikasi TLS dan kunci pribadi Anda. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi TLS/SSL untuk Edge On Premises.
  3. Salin file JKS keystore ke direktori di server Message Processor, seperti /opt/apigee/customer/application.
  4. Ubah izin dan kepemilikan file JKS: 
    chown apigee:apigee /opt/apigee/customer/application/keystore.jks
chmod 600 /opt/apigee/customer/application/keystore.jks

    Dengan keystore.jks adalah nama file keystore Anda.

  5. Edit file /opt/apigee/customer/application/message-processor.properties. Jika file tidak ada, buat file tersebut.
  6. Tetapkan properti berikut dalam file message-processor.properties: 
    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

    Dengan keystore.jks adalah file keystore Anda, dan obsPword adalah keystore dan sandi keyalias yang di-obfuscate. Lihat Mengonfigurasi TLS/SSL untuk Edge On Premises untuk mengetahui informasi tentang cara membuat sandi yang di-obfuscate.

  7. Pastikan file message-processor.properties dimiliki oleh pengguna 'apigee': 
    chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
  8. Hentikan Message-Processor dan Router: 
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
/opt/apigee/apigee-service/bin/apigee-service edge-router stop
  9. Di Router, hapus semua file di /opt/nginx/conf.d: 
    rm -f /opt/nginx/conf.d/*
  10. Mulai Message-Processor dan Router: 
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor start
/opt/apigee/apigee-service/bin/apigee-service edge-router start
  11. Ulangi untuk Message Processor tambahan.

Setelah TLS diaktifkan antara Router dan Message Processor, file log Message Processor berisi pesan INFO ini:

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

Pernyataan INFO ini mengonfirmasi bahwa TLS berfungsi antara Router dan Message Processor.

Tabel berikut mencantumkan semua properti yang tersedia di message-processor.properties:

Properti Deskripsi 
conf_message-processor-communication_local.
  http.host=localhost_or_IP_address
 Opsional. Nama host yang akan diproses untuk koneksi router. Tindakan ini akan mengganti nama host yang dikonfigurasi saat pendaftaran. 
conf/message-processor-communication.
  properties+local.http.port=8998
 Opsional. Port yang akan diproses untuk koneksi router. Defaultnya adalah 8998. 
conf_message-processor-communication_local.
  http.ssl=[ false | true ]
 Tetapkan ke true untuk mengaktifkan TLS/SSL. Defaultnya adalah false. Jika TLS/SSL diaktifkan, Anda harus menetapkan local.http.ssl.keystore.path dan local.http.ssl.keyalias. 
conf/message-processor-communication.
  properties+local.http.ssl.keystore.path=
 Jalur sistem file lokal ke keystore (JKS atau PKCS12). Wajib jika local.http.ssl=true. 
conf/message-processor-communication.
  properties+local.http.ssl.keyalias=
 Alias kunci dari keystore yang akan digunakan untuk koneksi TLS/SSL. Wajib jika local.http.ssl=true. 
conf/message-processor-communication.
  properties+local.http.ssl.keyalias.password=
 Sandi yang digunakan untuk mengenkripsi kunci di dalam keystore. Gunakan sandi yang di-obfuscate dalam format ini: OBF:xxxxxxxxxx 
conf/message-processor-communication.
  properties+local.http.ssl.keystore.type=jks
 Jenis keystore. Saat ini, hanya JKS dan PKCS12 yang didukung. Default-nya adalah JKS. 
conf/message-processor-communication.
  properties+local.http.ssl.keystore.password=
 Opsional. Sandi yang di-obfuscate untuk keystore. Gunakan sandi yang di-obfuscate dalam format ini: OBF:xxxxxxxxxx 
conf_message-processor-communication_local.
  http.ssl.ciphers=cipher1,cipher2
 Opsional. Jika dikonfigurasi, hanya cipher yang tercantum yang diizinkan. Jika dihilangkan, gunakan semua cipher yang didukung oleh JDK.