پیکربندی TLS برای New Edge UI

به‌طور پیش‌فرض، بااستفاده از نشانی IP یا نام ساناد گره «میانای کاربری New Edge» و درگاه ۳۰۰۱ ازطریق HTTP به میانای کاربری New Edge دسترسی پیدا می‌کنید. برای مثال:

http://edge_UI_IP:3001

یا می‌توانید دسترسی TLS به New Edge UI را پیکربندی کنید تا بتوانید به آن در این قالب دسترسی داشته باشید:

https://edge_UI_IP:3001

الزامات TLS

رابط کاربری New Edge از «امنیت لایه انتقال» نسخه ۱.۲ و بالاتر پشتیبانی می‌کند. اگر TLS را در «میانای کاربری New Edge» فعال کنید، کاربران باید بااستفاده از مرورگر سازگار با TLS نسخه ۱.۲ یا بالاتر به «میانای کاربری New Edge» متصل شوند.

خصوصیت‌های پیکربندی «امنیت لایه انتقال»

فرمان زیر را برای پیکربندی TLS برای New Edge UI اجرا کنید:

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

که configFile فایل پیکربندی‌ای است که برای نصب یا پیکربندی رابط کاربری New Edge استفاده کرده‌اید.

قبل‌از اجرای این فرمان، باید فایل پیکربندی را ویرایش کنید تا ویژگی‌های لازم برای کنترل کردن TLS را تنظیم کنید. جدول زیر ویژگی‌هایی را که برای پیکربندی TLS برای New Edge UI استفاده می‌کنید شرح می‌دهد:

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)

برای پیکربندی دسترسی TLS به New Edge UI:

1. گواهی و کلید «امنیت لایه انتقال» را به‌عنوان فایل‌های 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» استفاده کرده‌اید ویرایش کنید تا دارایی‌های «امنیت لایه انتقال» زیر را تنظیم کنید:

   # 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 را بازراه‌اندازی می‌کند. پس‌از بازراه‌اندازی، «میانای کاربری Edge جدید» از دسترسی ازطریق HTTPS پشتیبانی می‌کند. اگر پس‌از فعال کردن TLS نمی‌توانید به سیستم New Edge UI وارد شوید، حافظه نهان مرورگر را پاک کنید و دوباره به سیستم وارد شوید.

پیکربندی واسط کاربر New Edge وقتی TLS در متعادل‌کننده بار خاتمه می‌یابد

اگر ترازکننده‌ای دارید که درخواست‌ها را به «میانای کاربری New Edge» بازارسال می‌کند، می‌توانید اتصال «امنیت لایه انتقال» را در ترازکننده خاتمه دهید، و سپس ترازکننده درخواست‌ها را ازطریق HTTP به «میانای کاربری New Edge» بازارسال کند:

این پیکربندی پشتیبانی می‌شود اما باید متعادل‌کننده بار و New Edge UI را مطابق با آن پیکربندی کنید.

برای پیکربندی کردن New Edge UI وقتی TLS در متعادل‌کننده بار خاتمه می‌یابد:

1. فایل پیکربندی را که برای نصب «واسط کاربر Edge جدید» استفاده کرده‌اید ویرایش کنید تا ویژگی‌های «امنیت لایه انتقال» زیر را تنظیم کنید:

   # 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 نام فایل پیکربندی است.

   دستورگان «میانای کاربر Edge جدید» را بازراه‌اندازی می‌کند. پس‌از بازراه‌اندازی، «میانای کاربری New Edge» از دسترسی ازطریق HTTPS ازطریق ترازکننده بار پشتیبانی می‌کند. اگر پس‌از فعال کردن TLS نمی‌توانید به سیستم New Edge UI وارد شوید، حافظه نهان مرورگر را پاک کنید و دوباره به سیستم وارد شوید.

غیرفعال کردن TLS در واسط کاربر New Edge

برای غیرفعال کردن «امنیت لایه انتقال» در «واسط کاربر 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 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 را بازراه‌اندازی می‌کند. اکنون می‌توانید ازطریق HTTP به «واسط کاربر Edge جدید» دسترسی داشته باشید. اگر پس‌از غیرفعال کردن TLS نمی‌توانید به سیستم New Edge UI وارد شوید، حافظه نهان مرورگر را پاک کنید و دوباره به سیستم وارد شوید.