การกําหนดค่า TLS ระหว่างเราเตอร์และผู้ประมวลผลข้อความ

โดยค่าเริ่มต้น TLS ระหว่างเราเตอร์และ Message Processor จะปิดใช้อยู่

วิธีเปิดใช้การเข้ารหัส TLS ระหว่างเราเตอร์กับ Message Processor

  1. ตรวจสอบว่าเราเตอร์เข้าถึงพอร์ต 8082 ใน Message Processor ได้
  2. สร้างไฟล์ JKS ของคีย์สโตร์ที่มีใบรับรอง TLS และคีย์ส่วนตัว ดูข้อมูลเพิ่มเติมได้ที่การกำหนดค่า TLS/SSL สำหรับ Edge On Premises
  3. คัดลอกไฟล์ JKS ของคีย์สโตร์ไปยังไดเรกทอรีในเซิร์ฟเวอร์ Message Processor เช่น /opt/apigee/customer/application
  4. เปลี่ยนสิทธิ์และการเป็นเจ้าของไฟล์ JKS โดยทำดังนี้
    chown apigee:apigee /opt/apigee/customer/application/keystore.jks
    chmod 600 /opt/apigee/customer/application/keystore.jks

    โดย keystore.jks คือชื่อไฟล์คีย์สโตร์

  5. แก้ไขไฟล์ /opt/apigee/customer/application/message-processor.properties หากไม่มีไฟล์ ให้สร้างไฟล์
  6. ตั้งค่าพร็อพเพอร์ตี้ต่อไปนี้ในไฟล์ 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

    โดยที่ keystore.jks คือไฟล์คีย์สโตร์ และ obsPword คือคีย์สโตร์ที่สร้างความสับสนและรหัสผ่านคีย์แทน ดูข้อมูลเกี่ยวกับการสร้างรหัสผ่านที่สร้างความสับสนได้ที่หัวข้อการกำหนดค่า TLS/SSL สำหรับ Edge On Premises

  7. ตรวจสอบว่าไฟล์ message-processor.properties เป็นของผู้ใช้ "apigee" โดยทำดังนี้
    chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
  8. หยุด Message Processor และเราเตอร์โดยทำดังนี้
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
    /opt/apigee/apigee-service/bin/apigee-service edge-router stop
  9. ในเราเตอร์ ให้ลบไฟล์ในไดเรกทอรี /opt/nginx/conf.d ดังนี้
    rm -f /opt/nginx/conf.d/*
  10. เริ่ม Message Processor และเราเตอร์โดยทำดังนี้
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor start
    /opt/apigee/apigee-service/bin/apigee-service edge-router start
  11. ทำขั้นตอนนี้ซ้ำสำหรับ Message Processor แต่ละรายการ

หลังจากเปิดใช้ TLS ระหว่างเราเตอร์กับ Message Processor แล้ว ไฟล์บันทึกของ Message Processor จะมีข้อความ INFO นี้

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

คำสั่ง INFO นี้ยืนยันว่า TLS ทำงานระหว่างเราเตอร์และ Message Processor

ตารางต่อไปนี้แสดงพร็อพเพอร์ตี้ทั้งหมดที่มีใน message-processor.properties

พร็อพเพอร์ตี้ คำอธิบาย
conf_message-processor-communication_local.
  http.host=localhost_or_IP_address
ไม่บังคับ ชื่อโฮสต์ที่จะฟังการเชื่อมต่อเราเตอร์ ซึ่งจะลบล้างชื่อโฮสต์ที่กำหนดค่าไว้เมื่อลงทะเบียน
conf/message-processor-communication.
  properties+local.http.port=8998
ไม่บังคับ พอร์ตที่รอการเชื่อมต่อเราเตอร์ ค่าเริ่มต้นคือ 8998
conf_message-processor-communication_local.
  http.ssl=[ false | true ]
ตั้งค่านี้เป็น true เพื่อเปิดใช้ TLS/SSL ค่าเริ่มต้นคือ false เมื่อเปิดใช้ TLS/SSL คุณต้องตั้งค่า local.http.ssl.keystore.path และ local.http.ssl.keyalias
conf/message-processor-communication.
  properties+local.http.ssl.keystore.path=
เส้นทางระบบไฟล์ในเครื่องไปยังคีย์สโตร์ (JKS หรือ PKCS12) ต้องระบุเมื่อ local.http.ssl=true
conf/message-processor-communication.
  properties+local.http.ssl.keyalias=
ชื่อแทนคีย์จาก Keystore ที่จะใช้สำหรับการเชื่อมต่อ TLS/SSL ต้องระบุเมื่อ local.http.ssl=true
conf/message-processor-communication.
  properties+local.http.ssl.keyalias.password=
รหัสผ่านที่ใช้ในการเข้ารหัสคีย์ภายใน Keystore ใช้รหัสผ่านที่สร้างความสับสนในรูปแบบต่อไปนี้
OBF:obsPword
conf/message-processor-communication.
  properties+local.http.ssl.keystore.type=jks
ประเภท Keystore ปัจจุบันรองรับเฉพาะ JKS และ PKCS12 เท่านั้น ค่าเริ่มต้นคือ JKS
conf/message-processor-communication.
  properties+local.http.ssl.keystore.password=
ไม่บังคับ รหัสผ่านที่สร้างความสับสนสำหรับคีย์สโตร์ ใช้รหัสผ่านที่สร้างความสับสนในรูปแบบต่อไปนี้
OBF:obsPword
conf_message-processor-communication_local.
  http.ssl.ciphers=cipher1,cipher2
ไม่บังคับ เมื่อกำหนดค่าแล้ว ระบบจะอนุญาตเฉพาะการเข้ารหัสที่ระบุไว้เท่านั้น หากละเว้น ให้ใช้การเข้ารหัสทั้งหมดที่ JDK รองรับ