تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

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

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

ملاحظة: يجب أن يكون المنفذ 8082 في "معالج الرسائل" مفتوحًا ليتمكّن "الموجّه" من الوصول إليه لإجراء عمليات التحقّق من السلامة عند ضبط بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة (SSL) بين "الموجّه" و"معالج الرسائل". في حال عدم ضبط بروتوكول أمان طبقة النقل/طبقة المقابس الآمنة بين جهاز التوجيه و"معالج الرسائل"، يجب أن يظل الإعداد التلقائي، أي المنفذ 8082، مفتوحًا على "معالج الرسائل" لإدارة المكوّن، ولكن لا يحتاج جهاز التوجيه إلى الوصول إليه.

لتفعيل التشفير باستخدام بروتوكول أمان طبقة النقل (TLS) بين جهاز توجيه ومعالج رسائل:

تأكَّد من أنّ جهاز التوجيه يمكنه الوصول إلى المنفذ 8082 على "معالج الرسائل".
أنشئ ملف JKS لمخزن المفاتيح يحتوي على شهادة TLS والمفتاح الخاص. لمزيد من المعلومات، يُرجى الاطّلاع على ضبط بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة (SSL) في Edge On Premises.
انسخ ملف JKS الخاص بمخزن المفاتيح إلى دليل على خادم "معالج الرسائل"، مثل /opt/apigee/customer/application.
غيِّر الأذونات وملكية ملف JKS:
```
chown apigee:apigee /opt/apigee/customer/application/keystore.jks
chmod 600 /opt/apigee/customer/application/keystore.jks
```
حيث يمثّل keystore.jks اسم ملف تخزين المفاتيح.
عدِّل ملف /opt/apigee/customer/application/message-processor.properties. إذا لم يكن الملف متوفّرًا، أنشِئه.
اضبط السمات التالية في ملف 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 كلمة مرور ملف تخزين المفاتيح والاسم المستعار للمفتاح بعد إخفائهما.

ملاحظة: قيمة
يجب أن تكون قيمة
```
conf/message-processor-communication.properties+local.http.ssl.keyalias=apigee-devtest
```
هي نفسها القيمة التي يقدّمها الخيار -alias للأمر keytool، كما هو موضّح في نهاية القسم إنشاء ملف JKS.

يُرجى الاطّلاع على ضبط بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة (SSL) في Edge On Premises للحصول على معلومات حول إنشاء كلمة مرور مخفية.
تأكَّد من أنّ ملف message-processor.properties مملوك لمستخدم "apigee":
```
chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
```

أوقِف معالِجات الرسائل وأجهزة التوجيه:

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

على جهاز التوجيه، احذف أي ملفات في الدليل /opt/nginx/conf.d:
```
rm -f /opt/nginx/conf.d/*
```

ابدأ معالِجات الرسائل والموجّهات:

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

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

بعد تفعيل بروتوكول أمان طبقة النقل (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	اختيارية: المنفذ الذي يتم الاستماع إليه لاتصالات جهاز التوجيه. القيمة التلقائية هي 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=	اسم مستعار للمفتاح من مخزن المفاتيح لاستخدامه في اتصالات بروتوكول أمان طبقة النقل (TLS) أو طبقة المقابس الآمنة (SSL). إلزامية عند `local.http.ssl=true`.
conf/message-processor-communication. properties+local.http.ssl.keyalias.password=	كلمة المرور المستخدَمة لتشفير المفتاح داخل ملف تخزين المفاتيح. استخدِم كلمة مرور مخفية بالتنسيق التالي: OBF:`obsPword`
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:`obsPword`
conf_message-processor-communication_local. http.ssl.ciphers=`cipher1,cipher2`	اختيارية: عند ضبط الإعدادات، لا يُسمح إلا بالشفرات المُدرَجة. في حال عدم تحديدها، سيتم استخدام جميع برامج التشفير المتوافقة مع JDK.

ملاحظة: في الإصدار 4.54.00 من Apigee Edge للسحابة الخاصة، تم تعديل إعدادات التشفير التلقائية الداخلية لبروتوكول أمان طبقة النقل (TLS) الخاصة بالتواصل بين الموجّه ومعالج الرسائل من رموز RSA ثابتة إلى رموز ECDHE حديثة، وذلك بهدف التوافق مع معايير الأمان في Java 21.

عند الترقية إلى الإصدار 4.54 أو إصدار أحدث من إصدار قديم، إذا كنت قد ضبطت قيم تشفير معيّنة وثبّتّ رموز تشفير RSA الثابتة، عليك تعديل الإعدادات (conf_message-processor-communication_local.http.ssl.ciphers) لاستخدام رموز التشفير الحديثة.