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

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

http://newue_IP:3001

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

https://newue_IP:3001

ข้อกำหนด TLS

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

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

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

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

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

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

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 UI เพื่อตั้งค่าพร็อพเพอร์ตี้ 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 UI

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 UI จะรองรับการเข้าถึงผ่าน HTTPS หากเข้าสู่ระบบ Edge UI ไม่ได้หลังจากเปิดใช้ TLS ให้ล้างแคชของเบราว์เซอร์แล้วลองเข้าสู่ระบบอีกครั้ง

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

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

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

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

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

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

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

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

   สคริปต์จะรีสตาร์ท Edge UI

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 UI จะรองรับการเข้าถึงผ่าน HTTPS หากเข้าสู่ระบบ Edge UI ไม่ได้หลังจากเปิดใช้ TLS ให้ล้างแคชของเบราว์เซอร์แล้วลองเข้าสู่ระบบอีกครั้ง

ปิดใช้ TLS ใน Edge UI

วิธีปิดใช้ TLS ใน Edge UI

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 UI

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 UI ผ่าน HTTP ได้แล้ว หากเข้าสู่ระบบ Edge UI ไม่ได้หลังจากปิดใช้ TLS ให้ล้างแคชของเบราว์เซอร์แล้วลองเข้าสู่ระบบอีกครั้ง