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

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

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

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

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

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

  • URL ของปลายทาง Edge

    ปลายทางเริ่มต้นสำหรับ Edge เวอร์ชันในระบบคลาวด์คือ https://api.enterprise.apigee.com/v1

    สำหรับการติดตั้ง Private Cloud นั้น URL จะอยู่ในรูปแบบ http://EdgePrivateCloudIp:8080/v1 หรือ https://EdgePrivateCloudIp:TLSport/v1

    เมื่อ EdgePrivateCloudIp คือที่อยู่ IP ของเซิร์ฟเวอร์ Edge Management Server และ TLSport คือพอร์ต TLS/SSL สำหรับ Edge Management API เช่น 8443
  • ชื่อองค์กร Apigee

    ชื่อนี้คือชื่อองค์กรของคุณใน Edge คุณตั้งค่าองค์กรได้เมื่อคุณสร้างบัญชีใน Edge
  • ชื่อผู้ใช้และรหัสผ่านของผู้ดูแลระบบนักพัฒนาแอป

    การเรียกจากพอร์ทัลไปยัง Edge ผ่านการตรวจสอบสิทธิ์และกำหนดให้ผู้ใช้ที่มีสิทธิ์ของผู้ดูแลระบบนักพัฒนาแอป เมื่อมีการจัดสรรพอร์ทัลนักพัฒนาซอฟต์แวร์ให้กับคุณ ระบบจะเพิ่มบทบาทผู้ดูแลระบบของนักพัฒนาซอฟต์แวร์ไปยังองค์กรของคุณ บทบาทนี้ซึ่งมีผู้ใช้รายเดียวที่ชื่อ devadmin+{org_name}@apigee.com มีจุดประสงค์เพื่อการเชื่อมต่อพอร์ทัลนักพัฒนาซอฟต์แวร์กับองค์กร Edge เท่านั้น เนื่องจากพอร์ทัลแสดงแอปของนักพัฒนา Edge, ผลิตภัณฑ์ API และอื่นๆ ของพอร์ทัล ดังนั้นจึงต้องซิงค์กับองค์กร Edge อยู่เสมอด้วยการเรียก API การจัดการที่ต้องมีการตรวจสอบสิทธิ์ "ผู้ใช้" devadmin มีสิทธิ์ที่จำเป็น

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

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

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

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

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

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

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

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

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

วิดีโอ: ดูวิดีโอสั้นๆ เพื่อให้ทราบข้อมูลเพิ่มเติมเกี่ยวกับวิธีที่พอร์ทัลนักพัฒนาซอฟต์แวร์สื่อสารกับ Apigee Edge และเพื่อให้แน่ใจว่าการเชื่อมต่อใช้งานได้

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

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

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

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

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

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

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

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

ตัวอย่างด้านล่างนี้เป็นแอปเดียวกับ "แอป My Weather" ตามที่แสดงต่อผู้ดูแลระบบใน Edge UI

การจัดการนักพัฒนาซอฟต์แวร์จากพอร์ทัล

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

ข้อมูลนักพัฒนาซอฟต์แวร์ที่เก็บไว้ใน Edge ประกอบด้วยข้อมูลต่อไปนี้

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

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

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

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

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

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

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

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

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

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

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