إعداد بروتوكول أمان طبقة النقل (TLS) لواجهة مستخدم Edge الجديدة

By default, you access the new Edge UI over HTTP by using the IP address or DNS name of the Edge UI node and port 3001. على سبيل المثال:

http://newue_IP:3001

بدلاً من ذلك، يمكنك ضبط وصول بروتوكول أمان طبقة النقل (TLS) إلى واجهة مستخدم Edge حتى تتمكّن من الوصول إليها على النحو التالي:

https://newue_IP:3001

متطلبات بروتوكول أمان طبقة النقل (TLS)

تتوافق واجهة مستخدم Edge مع الإصدار 1.2 من بروتوكول أمان طبقة النقل (TLS) فقط. في حال تفعيل بروتوكول أمان طبقة النقل (TLS) في واجهة مستخدم Edge، يجب أن يتصل المستخدمون بواجهة مستخدم Edge باستخدام متصفّح متوافق مع الإصدار 1.2 من بروتوكول أمان طبقة النقل (TLS).

خصائص إعدادات بروتوكول أمان طبقة النقل (TLS)

نفِّذ الأمر التالي لضبط بروتوكول أمان طبقة النقل (TLS) لواجهة مستخدم Edge:

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-ssl -f configFile

حيث يمثّل configFile ملف الإعداد الذي استخدمته لتثبيت واجهة مستخدم Edge.

قبل تنفيذ هذا الأمر، عليك تعديل ملف الإعداد لضبط السمات اللازمة التي تتحكّم في بروتوكول أمان طبقة النقل (TLS). يوضّح الجدول التالي السمات التي تستخدمها لضبط بروتوكول أمان طبقة النقل (TLS) لواجهة مستخدم Edge:

MANAGEMENT_UI_SCHEME=https

MANAGEMENT_UI_SCHEME=https
MANAGEMENT_UI_TLS_OFFLOAD=y

/opt/apigee/customer/application/edge-management-ui

MANAGEMENT_UI_PUBLIC_URIS=$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT

SHOEHORN_SCHEME=http

إعداد بروتوكول أمان طبقة النقل (TLS)

لضبط وصول بروتوكول أمان طبقة النقل (TLS) إلى واجهة مستخدم Edge:

1. أنشئ شهادة ومفتاح بروتوكول أمان طبقة النقل (TLS) كملفات PEM بدون عبارة مرور. على سبيل المثال:

   mykey.pem
   mycert.pem

   تتوفّر طرق متعدّدة لإنشاء شهادة ومفتاح بروتوكول أمان طبقة النقل (TLS). على سبيل المثال، يمكنك تنفيذ الأمر التالي لإنشاء شهادة ومفتاح غير موقَّعَين:

   openssl req -x509 -newkey rsa:4096 -keyout mykey.pem -out mycert.pem -days 365 -nodes -subj '/CN=localhost'

2. انسخ ملفات المفاتيح والشهادات إلى دليل /opt/apigee/customer/application/edge-management-ui. إذا لم يكن هذا الدليل متوفّرًا، أنشِئه.

3. تأكَّد من أنّ الشهادة والمفتاح مملوكان لمستخدم "apigee":

   chown apigee:apigee /opt/apigee/customer/application/edge-management-ui/*.pem

4. عدِّل ملف الإعداد الذي استخدمته لتثبيت واجهة مستخدم Edge لضبط سمات بروتوكول أمان طبقة النقل (TLS) التالية:

   # Set to https to enable TLS.
   MANAGEMENT_UI_SCHEME=https 
   # Do NOT terminate TLS on a load balancer.
   MANAGEMENT_UI_TLS_OFFLOAD=n
   
   # Specify the key and cert. 
   MANAGEMENT_UI_TLS_KEY_FILE=/opt/apigee/customer/application/edge-management-ui/mykey.pem
   MANAGEMENT_UI_TLS_CERT_FILE=/opt/apigee/customer/application/edge-management-ui/mycert.pem
   
   # Leave these properties set to the same values as when you installed the Edge UI:
   MANAGEMENT_UI_PUBLIC_URIS=$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT
   SHOEHORN_SCHEME=http

5. نفِّذ الأمر التالي لضبط بروتوكول أمان طبقة النقل (TLS):

   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-ssl -f configFile

   حيث configFile هو اسم ملف الإعداد.

   يعيد النص البرمجي تشغيل واجهة مستخدم Edge.

6. شغِّل الأوامر التالية لإعداد shoehorn وإعادة تشغيله:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui setup -f configFile
   /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

   بعد إعادة التشغيل، تتيح واجهة مستخدم Edge الوصول عبر HTTPS. إذا لم تتمكّن من تسجيل الدخول إلى واجهة مستخدم Edge بعد تفعيل بروتوكول أمان طبقة النقل (TLS)، امحُ ذاكرة التخزين المؤقت للمتصفّح وحاوِل تسجيل الدخول مرة أخرى.

ضبط واجهة مستخدم Edge عند إنهاء بروتوكول أمان طبقة النقل (TLS) على جهاز موازنة الحمل

إذا كان لديك جهاز موازنة الحمل يعيد توجيه الطلبات إلى واجهة مستخدم Edge، يمكنك اختيار إنهاء اتصال بروتوكول أمان طبقة النقل (TLS) على جهاز موازنة الحمل، ثم إعادة توجيه الطلبات من جهاز موازنة الحمل إلى واجهة مستخدم Edge عبر بروتوكول HTTP:

هذا الإعداد متاح، ولكن عليك ضبط جهاز موازنة الحمل وواجهة مستخدم Edge وفقًا لذلك.

لضبط واجهة مستخدم Edge عند إنهاء بروتوكول أمان طبقة النقل (TLS) على جهاز موازنة الحمل، اتّبِع الخطوات التالية:

1. عدِّل ملف الإعداد الذي استخدمته لتثبيت واجهة مستخدم Edge لضبط سمات بروتوكول أمان طبقة النقل (TLS) التالية:

   # Set to https to enable TLS
   MANAGEMENT_UI_SCHEME=https
   # Terminate TLS on a load balancer
   MANAGEMENT_UI_TLS_OFFLOAD=y
   # Set to the IP address or DNS name of the load balancer.
   MANAGEMENT_UI_IP=LB_IP_DNS
   # Set to the port number for the load balancer and Edge UI.
   # The load balancer and the Edge UI must use the same port number.
   MANAGEMENT_UI_IP=3001
   
   # Leave these properties set to the same values as when you installed the Edge UI:
   MANAGEMENT_UI_PUBLIC_URIS=$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT
   SHOEHORN_SCHEME=http
   

   في حال ضبط MANAGEMENT_UI_TLS_OFFLOAD=y، يجب حذف MANAGEMENT_UI_TLS_KEY_FILE وMANAGEMENT_UI_TLS_CERT_FILE. لأنّه يتم تجاهلهما بسبب ورود الطلبات إلى واجهة مستخدم Edge عبر HTTP.

2. نفِّذ الأمر التالي لضبط بروتوكول أمان طبقة النقل (TLS):

   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-ssl -f configFile

   حيث configFile هو اسم ملف الإعداد.

   يعيد النص البرمجي تشغيل واجهة مستخدم Edge.

3. شغِّل الأوامر التالية لإعداد shoehorn وإعادة تشغيله:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui setup -f configFile
   /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

   بعد إعادة التشغيل، تتيح واجهة مستخدم Edge الوصول عبر HTTPS. إذا لم تتمكّن من تسجيل الدخول إلى واجهة مستخدم Edge بعد تفعيل بروتوكول أمان طبقة النقل (TLS)، امحُ ذاكرة التخزين المؤقت للمتصفّح وحاوِل تسجيل الدخول مرة أخرى.

إيقاف بروتوكول أمان طبقة النقل (TLS) في واجهة مستخدم Edge

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

1. عدِّل ملف الإعداد الذي استخدمته لتثبيت واجهة مستخدم Edge لضبط سمة بروتوكول أمان طبقة النقل (TLS) التالية:

   # Set to http to disable TLS.
   MANAGEMENT_UI_SCHEME=http
   
   # Only if you had terminated TLS on a load balancer,
   # reset to the IP address or DNS name of the Edge UI.
   MANAGEMENT_UI_IP=newue_IP_DNS
   

2. نفِّذ الأمر التالي لإيقاف بروتوكول أمان طبقة النقل (TLS):

   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-ssl -f configFile

   حيث configFile هو اسم ملف الإعداد.

   يعيد النص البرمجي تشغيل واجهة مستخدم Edge.

3. شغِّل الأوامر التالية لإعداد shoehorn وإعادة تشغيله:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui setup -f configFile
   /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

   يمكنك الآن الوصول إلى واجهة مستخدم Edge عبر HTTP. إذا لم تتمكّن من تسجيل الدخول إلى واجهة مستخدم Edge بعد إيقاف بروتوكول أمان طبقة النقل (TLS)، امحُ ذاكرة التخزين المؤقت للمتصفّح وحاوِل تسجيل الدخول مرة أخرى.