ضبط بروتوكول أمان طبقة النقل بين جهاز توجيه ومعالج رسائل

يكون بروتوكول أمان طبقة النقل (TLS) بين جهاز التوجيه ومعالج الرسائل غير مفعَّل تلقائيًا.

لتفعيل تشفير TLS بين جهاز توجيه ومعالج رسائل:

1. تأكَّد من إمكانية وصول جهاز التوجيه إلى المنفذ 8082 في معالج الرسائل.
2. أنشئ ملف JKS لمخزن المفاتيح يحتوي على شهادة TLS والمفتاح الخاص. لمزيد من المعلومات، يُرجى الاطّلاع على ضبط بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة (SSL) في Edge On Premises.
3. انسخ ملف JKS الخاص بمخزن المفاتيح إلى دليل على خادم "معالج الرسائل"، مثل /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. أوقِف معالِجات الرسائل وأجهزة التوجيه:

   /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. ابدأ معالِجات الرسائل والموجّهات:

    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor start
    /opt/apigee/apigee-service/bin/apigee-service edge-router start

11. كرِّر هذه العملية لكل معالج رسائل.

بعد تفعيل بروتوكول أمان طبقة النقل (TLS) بين جهاز التوجيه ومعالج الرسائل، يحتوي ملف سجل معالج الرسائل على رسالة INFO هذه:

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

يؤكّد بيان INFO هذا أنّ بروتوكول أمان طبقة النقل (TLS) يعمل بين جهاز التوجيه ومعالج الرسائل.

يسرد الجدول التالي جميع السمات المتاحة في message-processor.properties:

conf_message-processor-communication_local.
  http.host=localhost_or_IP_address

conf/message-processor-communication.
  properties+local.http.port=8998

conf_message-processor-communication_local.
  http.ssl=[ false | true ]

conf/message-processor-communication.
  properties+local.http.ssl.keystore.path=

conf/message-processor-communication.
  properties+local.http.ssl.keyalias=

conf/message-processor-communication.
  properties+local.http.ssl.keyalias.password=

OBF:obsPword

conf/message-processor-communication.
  properties+local.http.ssl.keystore.type=jks

conf/message-processor-communication.
  properties+local.http.ssl.keystore.password=

OBF:obsPword

conf_message-processor-communication_local.
  http.ssl.ciphers=cipher1,cipher2