การสื่อสารระหว่างพอร์ทัลที่ใช้ Drupal และ Edge

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

พอร์ทัลบริการสำหรับนักพัฒนาแอปจะทำหน้าที่เป็นไคลเอ็นต์สำหรับ Apigee Edge ซึ่งหมายความว่าพอร์ทัลจะไม่ทํางานเป็นระบบแบบสแตนด์อโลน แต่ข้อมูลส่วนใหญ่ที่พอร์ทัลใช้จะจัดเก็บอยู่ใน Edge เมื่อจำเป็น พอร์ทัลจะส่งคําขอ HTTP หรือ HTTPS เพื่อดึงข้อมูลจาก Edge หรือส่งข้อมูลไปยัง Edge

Edge จะไม่ส่งคำขอไปยังพอร์ทัล แต่จะตอบกลับเฉพาะคำขอที่ส่งมาจากพอร์ทัลเท่านั้น ดังนั้น พอร์ทัลจึงเป็นผู้เริ่มการโต้ตอบทั้งหมดระหว่างพอร์ทัลกับ Edge

กำหนดค่าการเชื่อมต่อระหว่างพอร์ทัลกับ Edge

พอร์ทัลต้องมีข้อมูล 3 รายการเพื่อสื่อสารกับ Edge ตามที่ระบุไว้ด้านล่าง

• URL ของปลายทาง Edge
  
  ปลายทางเริ่มต้นสำหรับ Edge เวอร์ชันที่ทำงานบนระบบคลาวด์คือ https://api.enterprise.apigee.com/v1
  
  สำหรับการติดตั้งระบบคลาวด์ส่วนตัว URL จะอยู่ในรูปแบบ http://EdgePrivateCloudIp:8080/v1 หรือ https://EdgePrivateCloudIp:TLSport/v1
  
  โดยที่ EdgePrivateCloudIp คือที่อยู่ IP ของเซิร์ฟเวอร์ Edge Management Server และ TLSport คือพอร์ต TLS/SSL สำหรับ API การจัดการ Edge เช่น 8443
• ชื่อองค์กร Apigee
  
  ชื่อองค์กรของคุณใน Edge คุณตั้งค่าองค์กรเมื่อสร้างบัญชีใน Edge
• ชื่อผู้ใช้และรหัสผ่านของผู้ดูแลระบบนักพัฒนาแอป
  
  การเรียกใช้จากพอร์ทัลไปยัง Edge จะได้รับการตรวจสอบสิทธิ์และกำหนดให้ผู้ใช้ต้องมีสิทธิ์ผู้ดูแลระบบนักพัฒนาแอป เมื่อจัดสรรพอร์ทัลนักพัฒนาแอปให้คุณแล้ว ระบบจะเพิ่มบทบาทผู้ดูแลระบบนักพัฒนาแอปลงในองค์กร บทบาทนี้ซึ่งมีผู้ใช้คนเดียวชื่อ devadmin+{org_name}@apigee.com มีไว้เพื่อเชื่อมต่อพอร์ทัลนักพัฒนาแอปกับองค์กร Edge เท่านั้น เนื่องจากพอร์ทัลแสดงแอปนักพัฒนาแอป Edge, ผลิตภัณฑ์ API และอื่นๆ พอร์ทัลจึงต้องซิงค์กับองค์กร Edge อยู่เสมอโดยการเรียกใช้ API การจัดการที่ต้องตรวจสอบสิทธิ์ "user" ที่เป็น devadmin มีสิทธิ์ที่จำเป็น
  

วิธีดูข้อมูลการเชื่อมต่อ

1. ในเมนูการดูแลระบบ Drupal ให้เลือกการกําหนดค่า > พอร์ทัลนักพัฒนาซอฟต์แวร์ > การตั้งค่าแอปพลิเคชัน

วิธีเปลี่ยนการกําหนดค่า

วิธีเปลี่ยนการกำหนดค่าจะขึ้นอยู่กับการติดตั้งพอร์ทัลและเวอร์ชันพอร์ทัล

• การติดตั้งพอร์ทัลเวอร์ชัน 15.01.06 ขึ้นไปในระบบคลาวด์: คุณต้องส่งคำขอไปยังทีมสนับสนุนของ Apigee Edge เพื่อเปลี่ยนข้อมูลการเชื่อมต่อ เช่น หากต้องการเปลี่ยนชื่อองค์กร
• การติดตั้งในสถานที่และพอร์ทัลที่ทำงานบนระบบคลาวด์เวอร์ชันก่อนหน้า 15.01.06: เปลี่ยนข้อมูลการเชื่อมต่อตามที่อธิบายไว้ด้านล่าง

1. ในเมนูการดูแลระบบ Drupal ให้เลือกการกําหนดค่า > การตั้งค่าพอร์ทัลนักพัฒนาซอฟต์แวร์
2. ป้อนชื่อองค์กรในองค์กร Management API
3. ป้อน URL ของปลายทาง Edge ใน URL ปลายทางของ Management API
4. ป้อนข้อมูลเข้าสู่ระบบของผู้ดูแลระบบองค์กรในผู้ใช้ที่ตรวจสอบสิทธิ์ปลายทางและรหัสผ่านของผู้ใช้ที่ตรวจสอบสิทธิ์
5. เลือกทดสอบการเชื่อมต่อเพื่อให้แน่ใจว่าเชื่อมต่อสำเร็จ
6. เลือกบันทึกการกําหนดค่า

ตรวจสอบการเข้าถึง Edge จากพอร์ทัล

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

ทั้ง Edge และพอร์ทัลสามารถติดตั้งใช้งานได้ทั้งในระบบคลาวด์หรือในองค์กร และคุณผสมผสานประเภทการติดตั้งใช้งานได้ เช่น คุณสามารถทำให้ทั้ง 2 รายการใช้งานได้ในระบบคลาวด์ ทั้ง 2 รายการใช้งานได้ภายในองค์กร หรือทำให้ 1 รายการใช้งานได้ในระบบคลาวด์ และอีก 1 รายการใช้งานได้ภายในองค์กร

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

การจัดการแอปและคีย์ API จากพอร์ทัล

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

หาก Edge ลงทะเบียนแอปสําเร็จ Edge จะแสดงคีย์ API รายการเดียวไปยังพอร์ทัล จากนั้นนักพัฒนาแอปจะใช้คีย์ API ดังกล่าวเพื่อเข้าถึงผลิตภัณฑ์ API ที่เชื่อมโยงกับแอป

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

เช่น นักพัฒนาแอปเข้าสู่ระบบพอร์ทัลและไปที่หน้า "แอปของฉัน" พอร์ทัลจะส่งคำขอไปยัง Edge เพื่อดึงข้อมูลเกี่ยวกับแอปและคีย์ API ของนักพัฒนาแอปเพื่อแสดงในหน้า "แอปของฉัน" จากนั้นข้อมูลดังกล่าวจะปรากฏในหน้า "แอปของฉัน" ของนักพัฒนาแอปในพอร์ทัล

หากนักพัฒนาแอปเพิ่ม นําออก หรือแก้ไขแอป พอร์ทัลจะส่งการแก้ไขเหล่านั้นไปยัง Edge

เนื่องจากข้อมูลทั้งหมดเกี่ยวกับแอปและคีย์ API จัดเก็บอยู่ใน Edge ผู้ดูแลระบบ Edge จึงสามารถดําเนินการกับข้อมูลดังกล่าวได้โดยใช้ UI ของ Edge ตัวอย่างเช่น ผู้ดูแลระบบสามารถทำสิ่งต่อไปนี้ได้

• เพิ่ม นำออก หรือแก้ไขแอปของนักพัฒนาแอป
• เพิกถอนหรืออนุมัติคีย์ API สําหรับแอป

ด้านล่างนี้คือแอปเดียวกัน "แอปสภาพอากาศของฉัน" ตามที่ปรากฏต่อผู้ดูแลระบบใน UI ของ Edge

การจัดการนักพัฒนาแอปจากพอร์ทัล

เมื่อนักพัฒนาแอปลงทะเบียนเป็นผู้ใช้พอร์ทัลใหม่ ระบบจะสร้างนักพัฒนาแอปใน Edge และพอร์ทัล ดังนั้น ข้อมูลเกี่ยวกับนักพัฒนาแอปจึงจัดเก็บอยู่ในทั้ง Edge และพอร์ทัล ซึ่งแตกต่างจากแอปและคีย์ API

ข้อมูลนักพัฒนาแอปที่จัดเก็บไว้ใน Edge มีดังนี้

• ชื่อ
• นามสกุล
• อีเมล
• ข้อมูลเพิ่มเติม (ไม่บังคับ) ที่ส่งจากพอร์ทัล

พอร์ทัลจะจัดเก็บข้อมูลเดียวกันกับ Edge แต่จัดเก็บข้อมูลเพิ่มเติมด้วย ซึ่งรวมถึงข้อมูลต่อไปนี้

• รหัสผ่านพอร์ทัล
• สถานะบัญชีพอร์ทัล: ใช้งานอยู่หรือถูกบล็อก
• บทบาทในพอร์ทัล: ผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว ผู้ดูแลระบบ อื่นๆ
• สิทธิ์ตามบทบาท: กำหนดการดำเนินการที่นักพัฒนาแอปได้รับอนุญาตให้ดำเนินการในพอร์ทัล

เมื่อนักพัฒนาแอปเข้าสู่ระบบพอร์ทัล พอร์ทัลจะมีหน้าที่ตรวจสอบสิทธิ์นักพัฒนาแอปและบังคับใช้สิทธิ์ตามบทบาท

เนื่องจากพอร์ทัลจัดเก็บข้อมูลทั้งหมดเกี่ยวกับนักพัฒนาแอป ให้ถือว่าพอร์ทัลเป็นระบบที่ใช้เก็บข้อมูลนักพัฒนาแอป ไม่ใช่ Edge เมื่อนักพัฒนาแอปแก้ไขข้อมูลในพอร์ทัล ระบบจะจัดเก็บข้อมูลดังกล่าวไว้ในพอร์ทัลและส่งไปยัง Edge (หากมี) เช่น หากนักพัฒนาแอปเปลี่ยนชื่อ ระบบจะส่งข้อมูลดังกล่าวไปยัง Edge แต่หากนักพัฒนาแอปเปลี่ยนรหัสผ่าน ข้อมูลดังกล่าวจะจัดเก็บไว้ในพอร์ทัลเท่านั้น

ดูข้อมูลเพิ่มเติมได้ที่เพิ่มและจัดการบัญชีผู้ใช้

การซิงค์นักพัฒนาแอประหว่างพอร์ทัลกับ Edge

Edge ไม่ได้เริ่มการสื่อสารกับพอร์ทัล หากคุณในฐานะผู้ดูแลระบบ Edge เปลี่ยนแปลงข้อมูลเกี่ยวกับนักพัฒนาแอปใน UI ของ Edge เราไม่รับประกันว่าข้อมูลดังกล่าวจะพุชไปยังพอร์ทัลเมื่อใด ดังนั้น ให้ใช้ฟีเจอร์การดูแลระบบของพอร์ทัลเพื่อสร้าง แก้ไข และลบนักพัฒนาแอป ไม่ใช่ Edge

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

วิธีซิงค์พอร์ทัลกับนักพัฒนาแอปใน Edge

:

• เข้าสู่ระบบพอร์ทัลในฐานะผู้ใช้ที่มีสิทธิ์ของผู้ดูแลระบบหรือสิทธิ์ในการสร้างเนื้อหา
• เลือกผู้ใช้ในเมนูการดูแลระบบ Drupal
• เลือกปุ่มซิงค์นักพัฒนาซอฟต์แวร์ใน Dev Portal ที่ด้านบนของหน้าเพื่อซิงค์กับนักพัฒนาแอปใน Edge