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

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

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

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

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

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

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

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

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

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

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

• ฮุกโฟลว์พร็อกซีล่วงหน้าสำหรับตรรกะที่ต้องบังคับใช้ก่อนที่ปลายทางของพร็อกซีจะทำงาน

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

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

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

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

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

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

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

การแนบโฟลว์ที่แชร์ไว้กับฮุกโฟลว์

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

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

   Edge

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

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

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

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

   Classic Edge (Private Cloud)

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

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

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

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

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

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