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