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

Edge for Private Cloud v4.19.01

โดยค่าเริ่มต้น 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 ]
ตั้งค่านี้เป็น "จริง" เพื่อเปิดใช้ 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:xxxxxxxxxx
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:xxxxxxxxxx
conf_message-processor-communication_local.
  http.ssl.ciphers=cipher1,cipher2
ไม่บังคับ เมื่อกำหนดค่าแล้ว ระบบจะอนุญาตเฉพาะการเข้ารหัสที่ระบุไว้เท่านั้น หากละเว้น ให้ใช้การเข้ารหัสทั้งหมดที่ JDK รองรับ