กำหนดค่า TLS สำหรับ UI ของ Edge แบบใหม่

โดยค่าเริ่มต้น คุณจะเข้าถึง UI ของ New Edge ผ่าน HTTP โดยใช้ที่อยู่ IP หรือชื่อ DNS ของโหนด UI ของ New Edge และพอร์ต 3001 เช่น

http://edge_UI_IP:3001

หรือคุณจะกำหนดค่าการเข้าถึง TLS ไปยัง UI ของ New Edge เพื่อให้เข้าถึงได้ในรูปแบบต่อไปนี้

https://edge_UI_IP:3001

ข้อกำหนด TLS

UI ของ New Edge รองรับ TLS v1.2 ขึ้นไป หากเปิดใช้ TLS ใน UI ของ New Edge ผู้ใช้ต้องเชื่อมต่อกับ UI ของ New Edge โดยใช้เบราว์เซอร์ที่เข้ากันได้กับ TLS v1.2 ขึ้นไป

พร็อพเพอร์ตี้การกำหนดค่า TLS

เรียกใช้คำสั่งต่อไปนี้เพื่อกำหนดค่า TLS สำหรับ UI ของ New Edge

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

โดย configFile คือไฟล์การกำหนดค่าที่คุณใช้ในการติดตั้งหรือกำหนดค่า UI ของ New Edge

ก่อนที่จะเรียกใช้คำสั่งนี้ คุณต้องแก้ไขไฟล์การกำหนดค่าเพื่อตั้งค่าพร็อพเพอร์ตี้ที่จำเป็นซึ่งควบคุม TLS ตารางต่อไปนี้อธิบาย พร็อพเพอร์ตี้ที่คุณใช้เพื่อกำหนดค่า TLS สำหรับ UI ของ 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

วิธีกำหนดค่าการเข้าถึง TLS ไปยัง UI ของ 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. แก้ไขไฟล์การกำหนดค่าที่คุณใช้ในการติดตั้ง UI ของ 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 คือชื่อของไฟล์การกำหนดค่า

   สคริปต์จะรีสตาร์ท UI ของ New Edge หลังจากรีสตาร์ทแล้ว UI ของ New Edge จะรองรับการเข้าถึงผ่าน HTTPS หากเข้าสู่ระบบ UI ของ New Edge ไม่ได้หลังจากเปิดใช้ TLS ให้ล้างแคชของเบราว์เซอร์แล้วลองเข้าสู่ระบบอีกครั้ง

กำหนดค่า UI ของ New Edge เมื่อ TLS สิ้นสุดที่ตัวจัดสรรภาระงาน

หากคุณมีตัวจัดสรรภาระงานที่ส่งต่อคำขอไปยัง UI ของ New Edge คุณอาจ เลือกที่จะสิ้นสุดการเชื่อมต่อ TLS ในตัวจัดสรรภาระงาน แล้วให้ตัวจัดสรรภาระงานส่งต่อคำขอไปยัง UI ของ New Edge ผ่าน HTTP โดยทำดังนี้

ระบบรองรับการกำหนดค่านี้ แต่คุณต้องกำหนดค่าตัวจัดสรรภาระงานและ UI ของ New Edge ตามนั้น

วิธีกำหนดค่า UI ของ New Edge เมื่อ TLS สิ้นสุดที่ตัวจัดสรรภาระงาน

1. แก้ไขไฟล์การกำหนดค่าที่คุณใช้ในการติดตั้ง UI ของ 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 ระบบจะละเว้นไฟล์เหล่านี้เนื่องจากคำขอไปยัง UI ของ New Edge เข้ามาผ่าน HTTP

2. เรียกใช้คำสั่งต่อไปนี้เพื่อกำหนดค่า TLS

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

   โดย configFile คือชื่อของไฟล์การกำหนดค่า

   สคริปต์จะรีสตาร์ท UI ของ New Edge หลังจากรีสตาร์ทแล้ว UI ของ New Edge จะรองรับการเข้าถึงผ่าน HTTPS ผ่านตัวจัดสรรภาระงาน หากเข้าสู่ระบบ UI ของ New Edge ไม่ได้หลังจากเปิดใช้ TLS ให้ล้างแคชของเบราว์เซอร์แล้วลองเข้าสู่ระบบอีกครั้ง

ปิดใช้ TLS ใน UI ของ New Edge

วิธีปิดใช้ TLS ใน UI ของ New Edge

1. แก้ไขไฟล์การกำหนดค่าที่คุณใช้ในการติดตั้ง UI ของ 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 คือชื่อของไฟล์การกำหนดค่า

   สคริปต์จะรีสตาร์ท UI ของ New Edge ตอนนี้คุณเข้าถึง UI ของ New Edge ผ่าน HTTP ได้แล้ว หากเข้าสู่ระบบ UI ของ New Edge ไม่ได้หลังจากปิดใช้ TLS ให้ล้างแคชของเบราว์เซอร์แล้วลองเข้าสู่ระบบอีกครั้ง