پیکربندی TLS برای تجربه New Edge، پیکربندی TLS برای تجربه New Edge

Edge for Private Cloud نسخه 4.19.01

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

http://newue_IP:3001

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

https://newue_IP:3001

الزامات TLS

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

ویژگی های پیکربندی 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

SHOEHORN_SCHEME=http

پیکربندی TLS

برای پیکربندی دسترسی TLS به تجربه New 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. فایل پیکربندی را که برای نصب تجربه 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 experience:
   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 نام فایل پیکربندی است.

   اسکریپت تجربه New 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

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

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

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

این پیکربندی پشتیبانی می‌شود، اما باید متعادل‌کننده بار و تجربه 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 experience.
   # The load balancer and the New Edge experience must use the same port number.
   MANAGEMENT_UI_IP=3001
   
   # Leave these properties set to the same values as when you installed the New Edge experience:
   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. آنها نادیده گرفته می شوند زیرا درخواست ها برای تجربه New Edge از طریق HTTP وارد می شوند.

2. برای پیکربندی TLS دستور زیر را اجرا کنید:

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

   جایی که configFile نام فایل پیکربندی است.

   اسکریپت تجربه New 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

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

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 experience.
   MANAGEMENT_UI_IP=newue_IP_DNS
   

2. برای غیرفعال کردن TLS دستور زیر را اجرا کنید:

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

   جایی که configFile نام فایل پیکربندی است.

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