ปรับแต่งโดเมนของคุณ

คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ Apigee X ข้อมูล

เมื่อสร้างพอร์ทัลนักพัฒนาซอฟต์แวร์ คุณจะได้รับชื่อโดเมนตัวอย่าง Apigee สำหรับการเข้าถึงพอร์ทัลที่เผยแพร่ในรูปแบบต่อไปนี้โดยค่าเริ่มต้น

https://orgname-portalname.apigee.io

โดยที่ orgname คือชื่อองค์กรและ portalname กำหนดโดยใช้ชื่อพอร์ทัลที่แปลงเป็นตัวพิมพ์เล็กทั้งหมดและมีการนำการเว้นวรรคและขีดกลางออก

เราขอแนะนำให้คุณระบุชื่อโดเมนที่กำหนดเองของคุณก่อนที่จะเปิดตัวพอร์ทัลนักพัฒนาซอฟต์แวร์ ตัวอย่างเช่น ทางเลือกที่ได้รับความนิยมมีดังนี้

https://developers.example.com

สำหรับข้อควรพิจารณาในการใช้โดเมนที่กำหนดเองกับผู้ให้บริการข้อมูลประจำตัว SAML โปรดดูที่ใช้โดเมนที่กำหนดเองกับผู้ให้บริการ SAML

ส่วนต่อไปนี้จะอธิบายวิธีปรับแต่งโดเมน

ปรับแต่งชื่อโดเมน (Apigee Edge)

เมื่อรวมพอร์ทัลของ Apigee Edge เข้าด้วยกัน คุณสามารถปรับแต่งชื่อโดเมนโดยทำตามขั้นตอนต่อไปนี้

1. จดทะเบียนชื่อโดเมนของคุณ
2. กำหนดค่า TLS
3. เพิ่มชื่อโดเมนที่กำหนดเองลงในพอร์ทัล
4. กำหนดค่า DNS

หลังจากเพิ่มโดเมนที่กำหนดเองแล้ว คุณจะแก้ไขหรือปิดใช้ได้ หากต้องการความช่วยเหลือในการแก้ปัญหา โปรดดูหัวข้อแก้ปัญหาโดเมนที่กำหนดเอง

ขั้นตอนที่ 1: จดทะเบียนชื่อโดเมน

หากต้องการจดทะเบียนโดเมนใหม่ มีเว็บไซต์จดทะเบียนโดเมนยอดนิยมจำนวนมาก เช่น Google Domains คุณเลือกเว็บไซต์สำหรับการจดทะเบียนโดเมนได้ตามต้องการ

เมื่อตัดสินใจเกี่ยวกับชื่อโดเมน โปรดพิจารณาว่า URL ที่ใช้ง่ายและมนุษย์อ่านได้เป็นองค์ประกอบสำคัญในการปรับปรุงการปรับแต่งเว็บไซต์ให้ติดอันดับบนเครื่องมือการค้นหา ตามที่อธิบายไว้ในติดตั้งใช้งานการปรับแต่งเว็บไซต์ให้ติดอันดับบนเครื่องมือการค้นหา (SEO)

ขั้นตอนที่ 2: กำหนดค่า TLS

หากต้องการรองรับ HTTPS คุณต้องกำหนดค่า TLS โดยการสร้างคีย์สโตร์และชื่อแทนที่มีใบรับรองดิจิทัลที่จำเป็นในสภาพแวดล้อมพอร์ทัล ตามที่อธิบายไว้ในขั้นตอนต่อไปนี้

วิธีกำหนดค่า TLS

1. ซื้อใบรับรอง TLS จากผู้ออกใบรับรองที่เชื่อถือได้ เช่น Google Trust Services คุณสามารถกำหนดผู้ออกใบรับรองที่เลือกเองได้
2. ลงชื่อเข้าใช้ https://apigee.com/edge
3. เลือกองค์กรของคุณจากเมนูโปรไฟล์ผู้ใช้
4. เลือกผู้ดูแลระบบ > สภาพแวดล้อม > คีย์สโตร์ TLS เพื่อแสดงหน้าคีย์สโตร์ TLS

5. เลือกพอร์ทัลจากรายการแบบเลื่อนลงของสภาพแวดล้อม

   

6. สร้างคีย์สโตร์และชื่อแทนตามที่อธิบายไว้ในการสร้างคีย์สโตร์และ Truststore โดยใช้ Edge UI

ขั้นตอนที่ 3: เพิ่มชื่อโดเมนที่กำหนดเองลงในพอร์ทัลของคุณ

เมื่อเพิ่มชื่อโดเมนที่กำหนดเองลงในพอร์ทัล ระบบจะสร้างทรัพยากรต่อไปนี้ให้คุณ (โดยใช้ฟังก์ชันเดียวกันกับที่ใช้ชื่อโดเมนที่กำหนดเองกับปลายทาง เช่น api.example.com)

• โฮสต์เสมือนที่ฟังบนพอร์ต 443 โดยใช้ชื่อโดเมนที่กำหนดเองที่คุณระบุ

• พร็อกซี API ที่ใช้ URL ของโดเมนที่กำหนดเองซึ่งตั้งค่าปลายทางเป้าหมายเป็นโดเมนพอร์ทัลเริ่มต้น ชื่อของพร็อกซี API ตรงกับชื่อโดเมนที่กำหนดเองกับเครื่องหมายจุดที่แทนที่ด้วยขีดล่าง ทำให้พร็อกซี API ใช้งานได้กับสภาพแวดล้อมพอร์ทัล

วิธีเพิ่มชื่อโดเมนที่กําหนดเองลงในพอร์ทัล

1. เลือกเผยแพร่ > พอร์ทัล แล้วเลือกพอร์ทัลของคุณ
2. เลือกการตั้งค่าในเมนูแบบเลื่อนลงในแถบนำทางด้านบนหรือในหน้า Landing Page
3. คลิกแท็บ โดเมน
4. ในหัวข้อโดเมนที่กำหนดเอง ให้กรอกข้อมูลในช่องต่อไปนี้
   

   ฟิลด์	คำอธิบาย
   คีย์สโตร์	เลือกคีย์สโตร์จากรายการแบบเลื่อนลง หมายเหตุ: รายการนี้จะสร้างขึ้นโดยใช้คีย์สโตร์ที่คุณสร้างในสภาพแวดล้อมพอร์ทัลในขั้นตอนที่ 2 หลังจากเลือกคีย์สโตร์แล้ว ช่องชื่อแทนจะปรากฏขึ้น
   ชื่อแทน	เลือกชื่อแทนที่ถูกต้องจากรายการแบบเลื่อนลง หมายเหตุ: รายการนี้จะสร้างขึ้นโดยใช้ชื่อแทนที่คุณสร้างสำหรับคีย์สโตร์ที่เลือก รายการนี้ไม่รวมคีย์สโตร์ที่มีเชนใบรับรองที่ไม่ถูกต้อง, โดเมน Apigee หรือ Truststore หากต้องการตรวจสอบว่าใบรับรองในรายการจะหมดอายุเมื่อใด ให้ทำดังนี้ ดูไอคอนต่างๆ ดังนี้ ใบรับรองหมดอายุนานกว่า 30 วัน หรืออาจมีการใช้โดเมนที่กำหนดเองที่เลือกอยู่แล้ว ใบรับรองจะหมดอายุภายใน 30 วัน ใบรับรองหมดอายุแล้ว วางเคอร์เซอร์เหนือชื่อแทนเพื่อแสดงจำนวนวันที่เหลือที่ใบรับรองจะใช้ได้ หลังจากที่คุณเลือกชื่อแทนแล้ว ช่องโดเมนจะปรากฏขึ้น
   โดเมน	เลือกโดเมนจากรายการแบบเลื่อนลง ถ้าคุณเลือกชื่อแทนที่เป็นไวลด์การ์ด ให้ป้อนโดเมนย่อย หมายเหตุ: ระบบจะป้อนข้อมูลรายการโดเมนโดยใช้ชื่อทั่วไปและชื่อสำรองสำหรับใบรับรองระดับบนสุดในเชนที่กำหนดโดยชื่อแทนที่เลือก

   หลังจากที่กรอกข้อมูลในช่องทั้งหมดแล้ว ไอคอนสถานะของโดเมนที่กำหนดเองจะอัปเดตดังนี้

   สถานะ	คำอธิบาย
   	คีย์สโตร์ ชื่อแทน และโดเมนที่กำหนดเองถูกต้อง
   	ใบรับรองจะหมดอายุภายใน 30 วัน
   	คีย์สโตร์ ชื่อแทน และโดเมนที่กำหนดเองไม่ถูกต้อง

   นอกจากนี้จะมีการตรวจสอบการกำหนดค่า DNS และอัปเดตไอคอน "กำหนดค่าสถานะ DNS" ดังนี้

   สถานะ	คำอธิบาย
   	การกำหนดค่า DNS ถูกต้อง
   	การกำหนดค่า DNS ไม่ถูกต้อง คุณต้องกำหนดค่า DNS ตามที่อธิบายไว้ในการกำหนดค่า DNS

5. คลิกเปิดใช้ (หรือบันทึกหากคุณกำลังแก้ไข)
   คุณเปิดใช้โดเมนที่กำหนดเองได้ แม้ว่าโดเมนที่กำหนดเองหรือการกำหนดค่า DNS จะไม่ถูกต้อง

ขั้นตอนที่ 4: กำหนดค่า DNS

ถัดไป คุณต้องเพิ่มระเบียน Canonical Name (CNAME) ลงใน DNS ของโดเมนเพื่อให้ชี้ไปที่ {org_name}-portal.apigee.net

วิธียืนยันค่า CNAME

1. เลือกเผยแพร่ > พอร์ทัล แล้วเลือกพอร์ทัลของคุณ
2. เลือกการตั้งค่าในเมนูแบบเลื่อนลงในแถบนำทางด้านบนหรือในหน้า Landing Page
3. คลิกแท็บ โดเมน
4. ดูค่า CNAME สำหรับองค์กรในส่วนกำหนดค่า DNS ดังที่แสดงในรูปต่อไปนี้

ต่อไปนี้เป็นตัวอย่างระเบียน CNAME ที่คุณจะกำหนดค่าสำหรับโดเมนที่กำหนดเองที่แสดงด้านบน (กล่าวคือ สำหรับโดเมนที่กำหนดเอง developers.example.com ในองค์กร myorg)

developers.example.com. CNAME myorg-portal.apigee.net.

แก้ปัญหาโดเมนที่กำหนดเอง

ส่วนต่อไปนี้จะมีคำแนะนำในการแก้ปัญหาโดเมนที่กำหนดเอง

แก้ปัญหา: ยืนยันการตั้งค่า DNS ของโดเมนโดยใช้การค้นหา

หลังจากอัปเดต DNS ของโดเมนให้รวมระเบียน CNAME แล้ว จะต้องใช้เวลาพอสมควรที่การเปลี่ยนแปลงจะเผยแพร่ไปยังเซิร์ฟเวอร์ DNS อื่นๆ ทั่วโลก คุณค้นหาเซิร์ฟเวอร์ DNS ของโดเมนเพื่อยืนยันว่าระเบียน CNAME ได้รับการตั้งค่าอย่างถูกต้องแล้ว แม้ว่าก่อนที่จะเผยแพร่ไปยังเซิร์ฟเวอร์ DNS อื่นโดยสมบูรณ์โดยใช้ dig ก็ตาม

เช่น คำสั่ง dig ต่อไปนี้จะค้นหาเซิร์ฟเวอร์ DNS ของโดเมน ในเอาต์พุตคำสั่ง ANSWER SECTION จะประกอบด้วยรายการระเบียน CNAME

$ dig @your.domain.dns developer.mycompany.com
; <<>> DiG 9.8.3-P1 <<>> @your.domain.dns developer.mycompany.com
; (1 server found)
;; global options:  cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 41356
;; flags: qr rd ra; QUERY: 1, ANSWER: 3, AUTHORITY: 0, ADDITIONAL: 0
;; WARNING: recursion requested but not available

;; QUESTION SECTION:
;developer.mycompany.com.       IN  A

;; ANSWER SECTION:
developer.mycompany.com.    29  IN  CNAME   myorg-portal.apigee.net.

;; Query time: 141 msec
;; SERVER: 192.168.1.254#53(192.168.1.254)
;; WHEN: Mon Mar 20 16:41:59 2017
;; MSG SIZE  rcvd: 136

แก้ปัญหา: ระบุพร็อกซีสำหรับโฮสต์ไม่ได้

เมื่อเพิ่มชื่อโดเมนที่กำหนดเองลงในพอร์ทัล ระบบจะสร้างพร็อกซี API โดยค่าเริ่มต้นซึ่งใช้ URL ของโดเมนที่กำหนดเอง พร้อมทั้งตั้งค่าปลายทางเป้าหมายเป็นโดเมนพอร์ทัลเริ่มต้น ถ้าคุณแก้ไขหรือลบพร็อกซี API ที่เชื่อมโยงกับโดเมนที่กำหนดเอง จะทำให้การกำหนดค่าโดเมนที่กำหนดเองใช้งานไม่ได้ และได้รับข้อความแสดงข้อผิดพลาด Unable to identify proxy for host เมื่อพยายามเข้าถึง URL ของโดเมนที่กำหนดเอง เช่น

{"fault":{"faultstring":"Unable to identify proxy for host: developers.mycompany.com:443 and url: \/","detail":{"errorcode":"messaging.adaptors.http.flow.ApplicationNotFound"}}}

หากต้องการกู้คืนการกำหนดค่าโดเมนที่กำหนดเองในกรณีที่มีการแก้ไขหรือลบพร็อกซี API ให้ทำดังนี้

1. เลือกเผยแพร่ > พอร์ทัล แล้วเลือกพอร์ทัลของคุณ
2. เลือกการตั้งค่าในเมนูแบบเลื่อนลงในแถบนำทางด้านบนหรือในหน้า Landing Page
3. คลิกแท็บ โดเมน
4. คลิกบันทึกเพื่อคืนค่าพร็อกซี API

อัปเดตใบรับรอง

ดูข้อมูลทั่วไปเกี่ยวกับการอัปเดตใบรับรอง TLS ได้ที่อัปเดตใบรับรอง TLS

1. ทำตามขั้นตอนในขั้นตอนที่ 2: กำหนดค่า TLS
2. ทำตามขั้นตอนในขั้นตอนที่ 3: เพิ่มชื่อโดเมนที่กำหนดเองลงในพอร์ทัล