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

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

เมื่อสร้างพอร์ทัลนักพัฒนาซอฟต์แวร์ ระบบจะกำหนดชื่อโดเมนตัวอย่าง 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. เลือก portal จากเมนูแบบเลื่อนลงของสภาพแวดล้อม

   

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

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

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

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

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

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

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

   ช่อง	คำอธิบาย
   คีย์สโตร์	เลือกคีย์สโตร์จากรายการแบบเลื่อนลง หมายเหตุ: รายการจะสร้างขึ้นโดยใช้คีย์สโตร์ที่คุณสร้างไว้ในสภาพแวดล้อมพอร์ทัลในขั้นตอนที่ 2 หลังจากเลือกคีย์สโตร์แล้ว ช่องชื่อแทนจะปรากฏขึ้น
   ชื่อแทน	เลือกชื่อแทนที่ถูกต้องจากรายการแบบเลื่อนลง หมายเหตุ: ระบบจะป้อนข้อมูลรายการโดยใช้อีเมลแทนที่คุณสร้างไว้สำหรับคีย์สโตร์ที่เลือก รายการนี้จะไม่รวมคีย์สโตร์ที่มีค่าโซ่ใบรับรอง โดเมน Apigee หรือคลังความน่าเชื่อถือที่ไม่ถูกต้อง วิธีตรวจสอบว่าใบรับรองในรายการจะหมดอายุเมื่อใด ดูไอคอนต่อไปนี้ ใบรับรองหมดอายุในอีกมากกว่า 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. คลิกแท็บ Domains
4. ดูค่า CNAME ขององค์กรในส่วนกำหนดค่า DNS ดังที่แสดงในภาพต่อไปนี้

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

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

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

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

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

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

เช่น คำสั่ง 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. คลิกแท็บ Domains
4. คลิกบันทึกเพื่อกู้คืนพร็อกซี API

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

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

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