پیکربندی TLS برای رابط کاربری Edge جدید، پیکربندی TLS برای رابط کاربری جدید Edge

به طور پیش فرض، با استفاده از آدرس IP یا نام DNS گره رابط کاربری Edge و پورت 3001، از طریق HTTP به رابط کاربری Edge جدید دسترسی پیدا می کنید. به عنوان مثال:

http://newue_IP:3001

همچنین، می‌توانید دسترسی TLS به رابط کاربری Edge را پیکربندی کنید تا بتوانید به شکل زیر به آن دسترسی داشته باشید:

https://newue_IP:3001

الزامات TLS

رابط کاربری Edge فقط از TLS نسخه 1.2 پشتیبانی می کند. اگر TLS را در رابط کاربری Edge فعال کنید، کاربران باید با استفاده از یک مرورگر سازگار با TLS v1.2 به رابط کاربری Edge متصل شوند.

ویژگی های پیکربندی TLS

دستور زیر را برای پیکربندی TLS برای رابط کاربری Edge اجرا کنید:

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

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

قبل از اجرای این دستور، باید فایل پیکربندی را ویرایش کنید تا ویژگی‌های لازم را که TLS را کنترل می‌کند، تنظیم کنید. جدول زیر ویژگی هایی را که برای پیکربندی TLS برای 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"

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 پشتیبانی می کند. اگر بعد از فعال کردن TLS نمی‌توانید وارد رابط کاربری Edge شوید، کش مرورگر را پاک کنید و دوباره وارد سیستم شوید.

هنگامی که TLS به بار متعادل کننده خاتمه می یابد، رابط کاربری Edge را پیکربندی کنید

اگر متعادل‌کننده بار دارید که درخواست‌ها را به Edge UI ارسال می‌کند، ممکن است انتخاب کنید که اتصال TLS را در بار متعادل‌کننده خاتمه دهید و سپس از طریق HTTP درخواست‌های load balancer را به Edge UI ارسال کنید:

این پیکربندی پشتیبانی می‌شود، اما باید متعادل‌کننده بار و رابط کاربری 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 پشتیبانی می کند. اگر بعد از فعال کردن TLS نمی‌توانید وارد رابط کاربری Edge شوید، کش مرورگر را پاک کنید و دوباره وارد سیستم شوید.

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

برای غیرفعال کردن TLS در رابط کاربری Edge:

1. فایل پیکربندی را که برای نصب Edge UI استفاده کردید، ویرایش کنید تا ویژگی 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

   اکنون می توانید از طریق HTTP به رابط کاربری Edge دسترسی داشته باشید. اگر پس از غیرفعال کردن TLS نمی توانید وارد رابط کاربری Edge شوید، کش مرورگر را پاک کنید و دوباره وارد سیستم شوید.