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

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

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

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

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

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

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

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

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

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

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

• Flow Hook ก่อนพร็อกซี สำหรับตรรกะที่ต้องบังคับใช้**ก่อน** ที่ปลายทางพร็อกซีจะทำงาน

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

• Flow Hook ก่อนเป้าหมาย สำหรับตรรกะที่ต้องบังคับใช้**ก่อน** ที่จะมีการเรียกเป้าหมาย

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

• Flow Hook หลังเป้าหมาย สำหรับตรรกะที่ต้องบังคับใช้**หลังจาก** การตอบกลับจากเป้าหมาย ทำงาน

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

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

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

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

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

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

   Edge

   วิธีเข้าถึงหน้า Flow Hook โดยใช้ UI ของ Edge

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

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

   3. เลือกผู้ดูแลระบบ > สภาพแวดล้อม > Flow Hook ในแถบนำทางด้านซ้าย

   Edge แบบคลาสสิก (Private Cloud)

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

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

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

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

   ตำแหน่ง Flow Hook	คำอธิบาย
   Flow Hook ก่อนพร็อกซี	**ก่อน** ที่ปลายทางพร็อกซีจะทำงาน
   Flow Hook ก่อนเป้าหมาย	**ก่อน** ที่ปลายทางเป้าหมายจะทำงาน
   Flow Hook หลังเป้าหมาย	**หลังจาก** การตอบกลับจากเป้าหมายทำงาน
   Flow Hook หลังพร็อกซี	**หลังจาก** ปลายทางพร็อกซีและ**ก่อน** ที่จะส่งการตอบกลับไปยัง ไคลเอ็นต์

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