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

الإصدار 4.16.09 من Edge for Private Cloud

يكون بروتوكول أمان طبقة النقل (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. كرِّر هذه الخطوات مع أي معالجات رسائل إضافية.

يسرد الجدول التالي جميع السمات المتاحة في 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=

اسم مستعار للمفتاح من مخزن المفاتيح لاستخدامه في اتصالات بروتوكول أمان طبقة النقل (TLS) أو طبقة المقابس الآمنة (SSL). إلزامية عندما تكون قيمة السمة local.http.ssl=true.

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

كلمة المرور المستخدَمة لتشفير المفتاح داخل ملف تخزين المفاتيح. استخدِم كلمة مرور مخفية بالتنسيق التالي: OBF:xxxxxxxxxx

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

نوع مخزن المفاتيح لا يتوفّر حاليًا سوى 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).