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

Edge for Private Cloud الإصدار 4.19.01

يكون بروتوكول أمان طبقة النقل (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) بين جهاز التوجيه ومعالج الرسائل، يحتوي ملف سجلّ معالج الرسائل على رسالة المعلومات هذه:

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=

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

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

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