การแนบโฟลว์ที่แชร์โดยใช้ Flow hook

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

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

เนื่องจากโค้ดที่แนบมากับフックการไหลอยู่นอกบริบทของตรรกะหลักของพร็อกซี API ลักษณะการทํางานบางอย่างจึงแตกต่างจากพร็อกซี API ข้อควรทราบมีดังนี้

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

วิดีโอต่อไปนี้แสดงวิธีเชื่อมต่อโฟลว์ที่แชร์กับฮุกโฟลว์ จากนั้นติดตามโฟลว์ใน UI ของ Edge แบบคลาสสิก

วิดีโอต่อไปนี้แสดงวิธีเชื่อมต่อโฟลว์ที่แชร์กับฮุกโฟลว์ จากนั้นจึงติดตามใน UI ของประสบการณ์การใช้งาน Edge เวอร์ชันใหม่

โฟลว์ที่แชร์ซึ่งแนบอยู่กับพร็อกซีผ่าน Flowhook เป็นตําแหน่งที่ดีสําหรับตรรกะที่บังคับใช้ข้อกําหนดของนโยบายอย่างกว้างๆ ตัวอย่างเช่น สมมติว่าคุณมีทีมเดียวที่จัดการข้อกําหนดด้านความปลอดภัยชุดเดียวสําหรับหลายทีมที่แสดงถึงสายธุรกิจ (LOB) ที่ต่างกัน ทีม LOB แต่ละทีมจะพัฒนา API ตามข้อกำหนดของตนเองได้โดยไม่ต้องคำนึงถึงข้อกำหนดด้านความปลอดภัยที่กว้างขึ้น ทีมรักษาความปลอดภัยสามารถติดตั้งข้อกําหนดด้านความปลอดภัยเหล่านั้นในโฟลว์ที่แชร์ จากนั้นแนบโฟลว์กับสภาพแวดล้อม Apigee Edge โดยใช้ฮุกโฟลว์ เนื่องจากขั้นตอนที่แชร์ไม่ได้เป็นส่วนหนึ่งของโค้ดพร็อกซี ทีมรักษาความปลอดภัยจึงแก้ไขขั้นตอนดังกล่าวได้ตามต้องการโดยไม่รบกวนโค้ด LOB

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับโฟลว์ที่แชร์ได้ที่โฟลว์ที่แชร์ซ้ำได้

คุณแนบโฟลว์ที่แชร์กับฮุกโฟลว์ได้โดยใช้คอนโซลการจัดการ Apigee Edge คุณจะสามารถแนบโฟลว์ที่แชร์กับ Flowhook ได้สูงสุด 1 รายการในแต่ละตำแหน่งต่อไปนี้

• Pre-proxy Flow Hook สำหรับตรรกะที่ต้องบังคับใช้ก่อนที่ปลายทางของพร็อกซีจะดำเนินการ

  เช่น คุณอาจมีตรรกะในการบังคับใช้การรักษาความปลอดภัยกับ API ทั้งหมดในสภาพแวดล้อม

• Pre-target Flow Hook สําหรับตรรกะที่ต้องบังคับใช้ก่อนเรียกใช้เป้าหมาย

  เช่น คุณอาจใช้การบันทึกก่อนที่คําขอจะไปถึงแบ็กเอนด์ นอกจากนี้ คุณยังบังคับใช้สื่อกลางได้ด้วยการนำบางช่องออกจากคำขอ

• ฮุกโฟลว์หลังการกําหนดเป้าหมายสําหรับตรรกะที่ต้องบังคับใช้หลังจากที่การตอบสนองเป้าหมายดำเนินการแล้ว

  ระบบจะบังคับใช้การตั้งค่านี้ทันทีที่การตอบกลับมาจากแบ็กเอนด์ คุณสามารถใช้เพื่อบันทึกการตอบกลับแบ็กเอนด์หรือทำการสื่อกลางบางอย่างโดยการนําฟิลด์ที่มีความละเอียดอ่อนออกจากการตอบกลับแบ็กเอนด์

• Post-proxy Flow Hook สำหรับตรรกะที่ต้องบังคับใช้หลังจากปลายทางของพร็อกซีและก่อนส่งการตอบกลับไปยังไคลเอ็นต์

  ซึ่งอาจรวมถึงตรรกะการบังคับใช้บางอย่างสําหรับ CORS, การบันทึกการตอบกลับ หรือการดำเนินการแมปรวมหรือการจัดรูปแบบ

การแนบโฟลว์ที่แชร์กับ Flowhook

หากต้องการแนบโฟลว์ที่แชร์กับฮุกโฟลว์ คุณต้องเป็นผู้ดูแลระบบในองค์กรที่มีโฟลว์ที่แชร์

1. เข้าถึงหน้าฮุกของ FLow ตามที่อธิบายไว้ด้านล่าง

   Edge

   วิธีเข้าถึงหน้าฮุกของโฟลว์โดยใช้ UI ของ Edge

   1. ลงชื่อเข้าใช้ apigee.com/edge
   2. เลือกองค์กรที่มีขั้นตอนที่แชร์ โปรดดูหัวข้อการสลับระหว่างองค์กร

      โฟลว์ที่แชร์จะพร้อมใช้งานสำหรับพร็อกซี API และโฟลว์ที่แชร์ซึ่งทำให้ใช้งานได้ในสภาพแวดล้อมจากองค์กรนี้ แต่จะใช้งานไม่ได้จากภายนอกองค์กรนี้

   3. เลือกผู้ดูแลระบบ > สภาพแวดล้อม > ฮุกของโฟลว์ในแถบนําทางด้านซ้าย

   Edge แบบคลาสสิก (ระบบคลาวด์ส่วนตัว)

   วิธีเข้าถึงหน้าฮุกของโฟลว์โดยใช้ UI ของ Edge แบบคลาสสิก

   1. ลงชื่อเข้าใช้ http://ms-ip:9000 โดยที่ ms-ip คือที่อยู่ IP หรือชื่อ DNS ของโหนดเซิร์ฟเวอร์การจัดการ
   2. เลือกองค์กรที่มีขั้นตอนที่แชร์ โปรดดูหัวข้อการสลับระหว่างองค์กร

      โฟลว์ที่แชร์จะพร้อมใช้งานสำหรับพร็อกซี API และโฟลว์ที่แชร์ซึ่งทำให้ใช้งานได้ในสภาพแวดล้อมจากองค์กรนี้ แต่จะใช้งานไม่ได้จากภายนอกองค์กรนี้

   3. เลือก API > การกำหนดค่าสภาพแวดล้อม > ฮุคของโฟลว์ในแถบนำทางด้านบน
2. ในรายการフックโฟลว์ ให้ระบุフックโฟลว์ที่ต้องการแนบโฟลว์ที่แชร์ โดยอิงตามตำแหน่งที่คุณต้องการให้โฟลว์ที่แชร์ทำงาน

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

3. วางเคอร์เซอร์เหนือフックการไหลในรายการเพื่อแสดงคอลัมน์การดําเนินการ
4. คลิก
5. ในกล่องโต้ตอบโฟลว์ที่แชร์ ให้เลือกโฟลว์ที่แชร์ที่ต้องการแนบในเมนูแบบเลื่อนลงโฟลว์ที่แชร์
6. คลิกตกลง
7. แนบโฟลว์ที่แชร์กับ Flowhook อื่นๆ ตามต้องการ