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

تصل تلقائيًا إلى واجهة مستخدم New Edge عبر بروتوكول HTTP باستخدام عنوان IP أو اسم نظام أسماء النطاقات (DNS) لعُقدة واجهة مستخدم New Edge والمنفذ 3001. على سبيل المثال:

http://edge_UI_IP:3001

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

https://edge_UI_IP:3001

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

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

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

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

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

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

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

MANAGEMENT_UI_TLS_ALLOWED_CIPHERS=TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256

MANAGEMENT_UI_TLS_ALLOWED_CIPHERS="TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256"

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

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

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. عدِّل ملف الإعداد الذي استخدمته لتثبيت واجهة مستخدم New 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 New Edge UI:
   MANAGEMENT_UI_PUBLIC_URIS=$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT

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

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

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

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

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

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

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

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

1. عدِّل ملف الإعداد الذي استخدمته لتثبيت واجهة مستخدم New 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 New Edge UI.
   # The load balancer and the New Edge UI must use the same port number.
   MANAGEMENT_UI_PORT=3001
   
   # Leave these properties set to the same values as when you installed the New Edge UI:
   MANAGEMENT_UI_PUBLIC_URIS=$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT
   

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

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

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

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

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

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

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

1. عدِّل ملف الإعداد الذي استخدمته لتثبيت واجهة مستخدم New 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 New Edge UI.
   MANAGEMENT_UI_IP=edge_UI_IP_DNS
   

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

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

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

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