การแสดงบริการ SOAP เป็นพร็อกซี API

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

หัวข้อนี้อธิบายวิธีสร้างพร็อกซี API สำหรับบริการเว็บที่ใช้ SOAP คุณสร้างพร็อกซี SOAP ได้ 2 ประเภทใน Edge โดยตัวหนึ่งจะสร้างอินเทอร์เฟซ RESTful ไปยังแบ็กเอนด์ บริการ SOAP และอีกตัวหนึ่งจะทำหน้าที่"ส่งต่อ" ข้อความ SOAP ไปยัง แบ็กเอนด์ โดยเทคนิคทั้ง 2 อย่างจะอธิบายไว้ในหัวข้อนี้

วิดีโอนี้แสดงการเปลี่ยนบริการ SOAP เป็นบริการ REST ด้วย Apigee Edge โดยใช้ตัวช่วยสร้างพร็อกซี API ตั้งแต่ต้นจนจบ อย่างไรก็ตาม หากต้องการควบคุมการเปลี่ยนรูปแบบ SOAP เป็น REST มากขึ้น คุณสามารถสร้างพร็อกซีโดยใช้นโยบายได้ ดูข้อมูลเพิ่มเติมได้ที่ บทแนะนำ: การสร้างพร็อกซี SOAP-to-REST API ใน Apigee Edge ด้วยตนเอง

การสร้างพร็อกซี API ที่ใช้ RESTful ไปยังบริการที่ใช้ SOAP

ส่วนนี้จะอธิบายวิธีสร้างพร็อกซี RESTful SOAP API ด้วยตัวเลือก REST ไปยัง SOAP ไปยัง REST ในวิซาร์ดสร้างพร็อกซี

ภาพรวม

ตัวเลือก REST ไปยัง SOAP ไปยัง REST จะประมวลผล WSDL เพื่อสร้างพร็อกซี API ที่เป็น RESTful Edge จะกำหนดการดำเนินการที่รองรับ พารามิเตอร์อินพุต และอื่นๆ ของบริการจาก WSDL Edge "คาดเดา" วิธี HTTP ที่จะใช้สำหรับการดำเนินการแต่ละอย่าง โดยปกติแล้ว Edge จะแปลการดำเนินการ เป็นคำขอ GET ซึ่งมีข้อดีคือแคชได้ นอกจากนี้ Edge ยังตั้งค่า ปลายทางเป้าหมายของแบ็กเอนด์ ซึ่งอาจแตกต่างกันไปตามการดำเนินการ SOAP

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

ขั้นตอนเบื้องต้น

Edge

วิธีสร้างพร็อกซี API แบบ RESTful สำหรับบริการที่ใช้ SOAP โดยใช้ UI ของ Edge

  1. ลงชื่อเข้าใช้ apigee.com/edge
  2. เลือกพัฒนา > พร็อกซี API ในแถบนำทางด้านซ้าย
  3. คลิก +พร็อกซี
  4. คลิก SOAP service
  5. ในหน้ารายละเอียดพร็อกซี ให้ระบุไฟล์ WSDL
    ช่อง คำอธิบาย
    ระบุไฟล์ WSDL

    เลือกแหล่งที่มาของ WSDL

    • จากที่อยู่เว็บ (URL) - ป้อนหรือวาง URL ของ WSDL
    • จากคอมพิวเตอร์ของฉัน - อัปโหลดไฟล์ WSDL จากไดเรกทอรีในเครื่อง คุณอัปโหลดหลายไฟล์ได้หากมีทรัพยากรที่ต้องใช้ร่วมกัน
  6. คลิกตรวจสอบเพื่อตรวจสอบ WSDL
  7. ป้อนรายละเอียดพร็อกซีต่อไปนี้
    ช่อง รายละเอียด
    ชื่อ ชื่อที่แสดงสำหรับ API ระบุอักขระที่เป็นตัวอักษรและตัวเลขคละกัน ขีดกลาง (-) หรือขีดล่าง (_)
    เส้นทางฐาน

    URI Fragment ที่ปรากฏหลังที่อยู่ http(s)://[host] ของ พร็อกซี API Edge ใช้ URI เส้นทางฐานเพื่อจับคู่และกำหนดเส้นทางข้อความคำขอขาเข้า ไปยังพร็อกซี API ที่เหมาะสม

    NOTE: เส้นทางฐานของพร็อกซี API จะมีค่าเริ่มต้นเป็นค่าที่ระบุสำหรับ ฟิลด์ Name ซึ่งแปลงเป็นตัวพิมพ์เล็กทั้งหมด

    หลังจากเส้นทางฐานคือ URL ของทรัพยากรเพิ่มเติม โครงสร้าง URL แบบเต็มที่ไคลเอ็นต์จะใช้เพื่อเรียกพร็อกซี API มีดังนี้

    https://[host]/base_path/conditional_flow_path

    NOTE: เส้นทางฐานต้องไม่ซ้ำกัน คุณจะทำให้พร็อกซี API 2 รายการมีเส้นทางฐานเดียวกันใช้งานไม่ได้ หากคุณแก้ไขพร็อกซี API ที่ใช้งานจริง และตั้งค่าเส้นทางพื้นฐานให้มีค่าเดียวกับเส้นทางพื้นฐานของพร็อกซี API อื่น Edge จะยกเลิกการใช้งาน พร็อกซี API โดยอัตโนมัติเมื่อคุณบันทึก ก่อนที่จะนำพร็อกซี API ไปใช้งานอีกครั้ง คุณต้องแก้ไขเส้นทางฐานให้ไม่ซ้ำกัน

    ใช้ไวลด์การ์ดในเส้นทางฐาน

    ใช้/*/อักขระไวด์การ์ดอย่างน้อย 1 ตัวในเส้นทางฐานของพร็อกซี API เพื่อ เตรียมพร็อกซี API ให้พร้อมสำหรับอนาคต เช่น เส้นทางฐานของ /team/*/members ช่วยให้ไคลเอ็นต์เรียกใช้ https://[host]/team/blue/members และ https://[host]/team/green/members ได้โดยที่คุณ ไม่ต้องสร้างพร็อกซี API ใหม่เพื่อรองรับทีมใหม่ โปรดทราบว่าระบบไม่รองรับ /**/

    คำอธิบาย (ไม่บังคับ) คำอธิบายของ API
  8. คลิกถัดไป
  9. ในหน้านโยบายทั่วไปของวิซาร์ด ให้กำหนดค่าต่อไปนี้
    • ข้อกำหนดด้านการให้สิทธิ์ความปลอดภัยในส่วนความปลอดภัย: การให้สิทธิ์ ดูการเพิ่มความปลอดภัย
    • รองรับกลไกการแชร์ทรัพยากรแบบข้ามต้นทาง (CORS) ในส่วนความปลอดภัย: เบราว์เซอร์ ดูการเพิ่มการรองรับ CORS
    • โควต้าเพื่อปกป้องบริการแบ็กเอนด์จากการเข้าชมสูงในส่วนQuota ดูโควต้า (ใช้ไม่ได้หากเลือกการให้สิทธิ์แบบส่งผ่าน)
  10. ในหน้าการดำเนินการ WSDL ให้เลือกประเภทพร็อกซี API เป็น REST to SOAP to REST

    ตารางจะปรากฏขึ้นพร้อมแสดงรายการการดำเนินการ ที่ Edge "ค้นพบ" ในไฟล์ WSDL คุณเลือกและกำหนดค่าการดำเนินการที่ต้องการ รวมไว้ในพร็อกซี API ได้ ตารางจะแสดงในรูปภาพต่อไปนี้

  11. เลือกประเภทพอร์ตจากเมนูแบบเลื่อนลงเพื่อระบุชุดการดำเนินการที่ต้องการใช้ ใน WSDL องค์ประกอบประเภทพอร์ต จะกำหนดการดำเนินการที่คุณเรียกใช้ในเว็บเซอร์วิสได้
  12. เปลี่ยน Path ของ REST API สำหรับการดำเนินการ (ไม่บังคับ) ระบบจะใช้เส้นทางเป็นชื่อทรัพยากร ใน URL ของพร็อกซี API
  13. คุณเลือกเปลี่ยนกริยา (เมธอด HTTP) ที่เชื่อมโยงกับการดำเนินการได้
  14. คลิกถัดไป
  15. ในหน้าโฮสต์เสมือนของวิซาร์ด ให้เลือกโฮสต์เสมือนที่พร็อกซี API จะเชื่อมโยงเมื่อมีการติดตั้งใช้งาน ดูข้อมูลเพิ่มเติมได้ที่เกี่ยวกับโฮสต์เสมือน
  16. คลิกถัดไป
  17. เลือกสภาพแวดล้อมการติดตั้งใช้งาน แล้วคลิกสร้างและติดตั้งใช้งาน
    ระบบจะสร้างพร็อกซี API ใหม่ และติดตั้งใช้งานในสภาพแวดล้อมที่เลือก
  18. คลิกแก้ไขพร็อกซีเพื่อแสดง หน้ารายละเอียดของพร็อกซี API

Classic Edge (Private Cloud)

วิธีสร้างพร็อกซี API แบบ RESTful ไปยังบริการที่ใช้ SOAP โดยใช้ Classic Edge UI

  1. ลงชื่อเข้าใช้ http://ms-ip:9000 โดยที่ ms-ip คือ ที่อยู่ IP หรือชื่อ DNS ของโหนดเซิร์ฟเวอร์การจัดการ
  2. เลือก API > พร็อกซี API ในแถบนำทางด้านบน
  3. คลิก + พร็อกซี API
  4. ในวิซาร์ดสร้างพร็อกซี ให้เลือกบริการ SOAP
  5. คลิกถัดไป
  6. ในหน้ารายละเอียด ให้เลือกตัวเลือกต่อไปนี้ คุณต้องคลิกตรวจสอบหลังจาก เลือก WSDL
    ในฟิลด์นี้ ทำดังนี้
    WSDL

    เลือกแหล่งที่มาของ WSDL

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

    นี่คือชื่อของพร็อกซีที่คุณสร้าง
    เส้นทางฐานของพร็อกซี

    URI Fragment ที่ปรากฏหลังที่อยู่ http(s)://[host] ของ พร็อกซี API Edge ใช้ URI เส้นทางฐานเพื่อจับคู่และกำหนดเส้นทางข้อความคำขอขาเข้า ไปยังพร็อกซี API ที่เหมาะสม

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

    หลังจากเส้นทางฐานคือ URL ของทรัพยากรเพิ่มเติม โครงสร้าง URL แบบเต็มที่ไคลเอ็นต์จะใช้เพื่อเรียกพร็อกซี API มีดังนี้

    https://[host]/base_path/conditional_flow_path

    หมายเหตุ: เส้นทางฐานต้องไม่ซ้ำกัน คุณจะใช้งาน API Proxy 2 รายการที่มีเส้นทางฐานเดียวกันไม่ได้ หากคุณแก้ไขพร็อกซี API ที่ใช้งานจริง และตั้งค่าเส้นทางพื้นฐานให้มีค่าเดียวกับเส้นทางพื้นฐานของพร็อกซี API อื่น Edge จะยกเลิกการใช้งาน พร็อกซี API โดยอัตโนมัติเมื่อคุณบันทึก ก่อนที่จะนำพร็อกซี API ไปใช้งานอีกครั้ง คุณต้องแก้ไขเส้นทางฐานให้ไม่ซ้ำกัน

    ใช้ไวลด์การ์ดในเส้นทางฐาน

    ใช้/*/อักขระไวด์การ์ดอย่างน้อย 1 ตัวในเส้นทางฐานของพร็อกซี API เพื่อ เตรียมพร็อกซี API ให้พร้อมสำหรับอนาคต เช่น เส้นทางฐานของ /team/*/members ช่วยให้ไคลเอ็นต์เรียกใช้ https://[host]/team/blue/members และ https://[host]/team/green/members ได้โดยที่คุณ ไม่ต้องสร้างพร็อกซี API ใหม่เพื่อรองรับทีมใหม่ โปรดทราบว่าระบบไม่รองรับ /**/

    คำอธิบาย คำอธิบายพร็อกซีโดยย่อ
  7. คลิกถัดไป
  8. ในหน้า WSDL ให้เลือกประเภทพร็อกซี API เป็น REST to SOAP to REST

    ตารางจะปรากฏขึ้นพร้อมแสดงรายการการดำเนินการ ที่ Edge "ค้นพบ" ในไฟล์ WSDL คุณเลือกและกำหนดค่าการดำเนินการที่ต้องการ รวมไว้ในพร็อกซี API ได้ ตารางจะแสดงในรูปภาพต่อไปนี้

    ในหน้าการดำเนินการ WSDL ระบบจะตั้งค่าประเภทพร็อกซี API เป็น REST ไปยัง SOAP ไปยัง REST และตารางจะแสดงผลลัพธ์ 1 แถวพร้อมการดำเนินการเพิ่ม

  9. เลือกชุดการดำเนินการที่ต้องการใช้จากคอลัมน์ประเภทพอร์ต ใน WSDL องค์ประกอบประเภทพอร์ต จะกำหนดการดำเนินการที่คุณเรียกใช้ในเว็บเซอร์วิสได้
  10. เปลี่ยนเมธอด HTTP ที่เชื่อมโยงกับการดำเนินการ (ไม่บังคับ)

    หมายเหตุ: Edge จะ "คาดเดา" วิธี HTTP ที่ดีที่สุดเพื่อใช้สำหรับการดำเนินการแต่ละอย่าง โดยทั่วไปแล้ว GET เป็นที่นิยมมากกว่าเนื่องจากคำขอ GET สามารถแคชได้
  11. เปลี่ยนเส้นทาง REST API สำหรับการดำเนินการ (ไม่บังคับ) ระบบจะใช้เส้นทางเป็นชื่อทรัพยากร ใน URL ของพร็อกซี API
  12. คลิกผ่านส่วนที่เหลือของวิซาร์ดเพื่อเพิ่มความปลอดภัย เลือกโฮสต์เสมือน และสภาพแวดล้อมการ ติดตั้งใช้งาน
  13. ในหน้า "สร้าง" ให้คลิกสร้างและติดตั้งใช้งาน Edge จะสร้างและติดตั้งใช้งาน พร็อกซี API ใหม่ตาม WSDL
  14. ไปที่หน้าสรุปของพร็อกซี API ใหม่ โปรดทราบว่าระบบได้สร้างชุดทรัพยากร ตามการดำเนินการที่พบในไฟล์ WSDL

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

เกี่ยวกับพร็อกซีสุดท้าย

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

ตัวอย่างเช่น ในฝั่งคำขอ จะใช้นโยบาย AssignMessage เพื่อตั้งค่า URL เป้าหมาย ในส่วนการตอบกลับ นโยบายจะดำเนินการเพื่อเปลี่ยนการตอบกลับจาก XML เป็น JSON แยกส่วนเนื้อหา SOAP ของการตอบกลับเป็นตัวแปร และตั้งค่าข้อความตอบกลับ ระบบจะเพิ่มนโยบายเหล่านี้ (และนโยบายอื่นๆ) โดยอัตโนมัติเมื่อคุณสร้างพร็อกซี

ข้อกำหนด OpenAPI: หากต้องการดูข้อกำหนด OpenAPI ที่สร้างขึ้นโดยอัตโนมัติสำหรับพร็อกซีนี้ โปรดไปที่ http(s)://[proxy_domain]/[proxy_base_path]/openapi.json อย่างไรก็ตาม การแปลงอาจไม่ถูกต้องเสมอไป เนื่องจากกฎทั้งหมดของสคีมา XML ไม่สามารถ แสดงในข้อกำหนด OpenAPI ได้

การสร้างพร็อกซีแบบส่งผ่านไปยังบริการที่ใช้ SOAP

ส่วนนี้จะอธิบายวิธีสร้างพร็อกซีแบบส่งผ่านด้วยตัวเลือกพร็อกซีแบบส่งผ่านในกล่องโต้ตอบสร้างพร็อกซีใหม่

ภาพรวม

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

สำหรับพร็อกซีประเภทนี้ Edge จะโฮสต์ WSDL และสร้างโฟลว์ในพร็อกซีเพื่อให้คุณ เข้าถึงได้ ที่อยู่ของ WSDL ที่โฮสต์ใน Edge นี้ http(s)://[proxy_domain]/[proxy_base_path]?wsdl จะกลายเป็น URL ของปลายทางบริการใหม่ สำหรับไคลเอ็นต์ที่เรียกใช้บริการ SOAP ผ่านพร็อกซี

ขั้นตอนเบื้องต้น

Edge

หากต้องการสร้างพร็อกซีแบบส่งผ่านไปยังบริการที่ใช้ SOAP โดยใช้ UI ของ Edge ให้ทำดังนี้

  1. ลงชื่อเข้าใช้ apigee.com/edge
  2. เลือกพัฒนา > พร็อกซี API ในแถบนำทางด้านซ้าย
  3. คลิก +พร็อกซี
  4. คลิก SOAP service
  5. ในหน้ารายละเอียดพร็อกซี ให้ระบุรายละเอียด WSDL
    ช่อง คำอธิบาย
    WSDL

    เลือกแหล่งที่มาของ WSDL

    • จากที่อยู่เว็บ (URL) - ป้อนหรือวาง URL ของ WSDL
    • จากคอมพิวเตอร์ของฉัน - อัปโหลดไฟล์ WSDL จากไดเรกทอรีในเครื่อง คุณอัปโหลดหลายไฟล์ได้หากมีทรัพยากรที่ต้องใช้ร่วมกัน
    ชื่อ

    ชื่อของพร็อกซี API
    เส้นทางฐาน

    ส่วน URI หลังที่อยู่ http(s)://[host] ของ พร็อกซี API Edge ใช้ URI เส้นทางฐานเพื่อจับคู่และกำหนดเส้นทางข้อความคำขอขาเข้า ไปยังพร็อกซี API ที่เหมาะสม

    หมายเหตุ: ดูคำแนะนำของ Apigee เกี่ยวกับการกำหนดเวอร์ชัน API ได้ที่ การกำหนดเวอร์ชันในอีบุ๊กการออกแบบ Web API: The Missing Link

    หลังจากเส้นทางฐานคือ URL ของทรัพยากรเพิ่มเติม โครงสร้าง URL แบบเต็มที่ไคลเอ็นต์จะใช้เพื่อเรียกพร็อกซี API มีดังนี้

    https://[host]/base_path/conditional_flow_path

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

    การใช้ไวลด์การ์ดในเส้นทางฐาน

    คุณสามารถใช้/*/อักขระไวด์การ์ดอย่างน้อย 1 ตัวในเส้นทางฐานของพร็อกซี API เพื่อ เตรียมพร็อกซีของคุณให้พร้อมสำหรับอนาคต เช่น เส้นทางฐานของ /team/*/members ช่วยให้ไคลเอ็นต์เรียกใช้ https://[host]/team/blue/members และ https://[host]/team/green/members ได้โดยที่คุณ ไม่ต้องสร้างพร็อกซี API ใหม่เพื่อรองรับทีมใหม่ โปรดทราบว่าระบบไม่รองรับ /**/

    หมายเหตุ: เส้นทางฐานของพร็อกซี API จะมีค่าเริ่มต้นเป็นค่าที่ระบุสำหรับ ฟิลด์ชื่อซึ่งแปลงเป็นตัวพิมพ์เล็กทั้งหมด เว้นแต่คุณจะแก้ไขเนื้อหาใน ฟิลด์เส้นทางฐานอย่างชัดเจน
    คำอธิบาย (ไม่บังคับ) คำอธิบายของ API
  6. คลิกถัดไป
  7. ในหน้านโยบายทั่วไปของวิซาร์ด ให้กำหนดค่าต่อไปนี้
  8. ในหน้า WSDL ให้เลือกประเภทพร็อกซี API เป็น Pass-Through SOAP

  9. เลือกประเภทพอร์ตจากเมนูแบบเลื่อนลงเพื่อระบุชุดการดำเนินการที่ต้องการใช้ ใน WSDL องค์ประกอบประเภทพอร์ต จะกำหนดการดำเนินการที่คุณเรียกใช้ในเว็บเซอร์วิสได้
  10. คลิกถัดไป
  11. ในหน้าโฮสต์เสมือนของวิซาร์ด ให้เลือกโฮสต์เสมือนที่พร็อกซี API จะเชื่อมโยงเมื่อมีการติดตั้งใช้งาน ดูข้อมูลเพิ่มเติมได้ที่ เกี่ยวกับโฮสต์เสมือน
  12. เลือกสภาพแวดล้อมการติดตั้งใช้งาน แล้วคลิกสร้างและติดตั้งใช้งาน
    ระบบจะสร้างพร็อกซี API ใหม่ และติดตั้งใช้งานในสภาพแวดล้อมที่เลือก
  13. คลิกแก้ไขพร็อกซีเพื่อแสดง หน้ารายละเอียดของพร็อกซี API

Classic Edge (Private Cloud)

หากต้องการสร้างพร็อกซีแบบส่งผ่านไปยังบริการที่ใช้ SOAP โดยใช้ UI ของ Edge แบบคลาสสิก ให้ทำดังนี้

  1. ลงชื่อเข้าใช้ http://ms-ip:9000 โดยที่ ms-ip คือ ที่อยู่ IP หรือชื่อ DNS ของโหนดเซิร์ฟเวอร์การจัดการ
  2. เลือก API > พร็อกซี API ในแถบนำทางด้านบน
  3. คลิก + พร็อกซี API
  4. ในวิซาร์ดสร้างพร็อกซี ให้เลือกบริการ SOAP
  5. คลิกถัดไป
  6. ในหน้ารายละเอียด ให้เลือกตัวเลือกต่อไปนี้ คุณต้องคลิกตรวจสอบหลังจาก เลือก WSDL
    ในฟิลด์นี้ ทำดังนี้
    WSDL

    เลือกแหล่งที่มาของ WSDL

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

    นี่คือชื่อของพร็อกซีที่คุณสร้าง
    เส้นทางฐานของพร็อกซี เส้นทางฐานของพร็อกซีคือส่วน URI ที่ระบุ API ที่พร็อกซี API นี้แสดงอย่างไม่ซ้ำกัน บริการ API ใช้ URI ของเส้นทางฐานเพื่อจับคู่และกำหนดเส้นทางข้อความคำขอขาเข้าไปยังพร็อกซี API ที่เหมาะสม (ระบบจะต่อท้ายเส้นทางฐานกับโดเมนของ API ซึ่งสร้างขึ้นโดยอัตโนมัติตามชื่อองค์กรและ สภาพแวดล้อมที่พร็อกซี API ได้รับการติดตั้งใช้งาน) แนวทางปฏิบัติแนะนำคือการใส่ หมายเลขเวอร์ชันในชื่อโปรเจ็กต์ เช่น /v1/delayedstockquote ซึ่งจะกำหนดวิธีที่แอปผู้บริโภคเรียกใช้ API ของคุณ

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

  8. คลิกถัดไป
  9. ในหน้า WSDL ให้เลือกประเภทพร็อกซี API เป็น Pass-Through SOAP

    หมายเหตุ: ตารางจะปรากฏขึ้นโดยแสดงการดำเนินการ WSDL แต่ละรายการและ เพย์โหลด SOAP ที่เกี่ยวข้อง นี่คือเพย์โหลดที่ "ส่งผ่าน" ไปยังบริการ SOAP แบ็กเอนด์

    ในหน้า WSDL ประเภทพร็อกซี API จะตั้งค่าเป็น Pass-Through SOAP และรายการ การดำเนินการ เช่น GetQuote จะจัดระเบียบตามประเภทพอร์ต
  10. เลือกชุดการดำเนินการที่ต้องการใช้จากคอลัมน์ประเภทพอร์ต ใน WSDL องค์ประกอบประเภทพอร์ต จะกำหนดการดำเนินการที่คุณเรียกใช้ในเว็บเซอร์วิสได้
  11. คลิกผ่านส่วนที่เหลือของวิซาร์ดเพื่อเพิ่มความปลอดภัย เลือกโฮสต์เสมือน และสภาพแวดล้อมการ ติดตั้งใช้งาน
  12. ในหน้า "สร้าง" ให้คลิกสร้างและติดตั้งใช้งาน Edge จะสร้างและติดตั้งใช้งาน พร็อกซี API ใหม่ตาม WSDL

เกี่ยวกับพร็อกซีสุดท้าย

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

ตัวอย่างเช่น รูปที่ 1 แสดงส่วน Target Endpoint Preflow ของพร็อกซีแบบส่งผ่าน ในฝั่งคำขอ ระบบจะใช้นโยบาย AssignMessage เพื่อตั้งค่า URL เป้าหมาย ในส่วนการตอบกลับ นโยบายจะดำเนินการเพื่อเปลี่ยนการตอบกลับจาก XML เป็น JSON แยกส่วนเนื้อหา SOAP ของการตอบกลับเป็นตัวแปร และตั้งค่าข้อความตอบกลับ ระบบจะเพิ่มนโยบายเหล่านี้ (และอื่นๆ) โดยอัตโนมัติเมื่อคุณสร้างพร็อกซี

ในมุมมองการพัฒนา ในแผงโฟลว์ ลูกศรจะแสดงโฟลว์จากคำขอไปยัง การตอบกลับ และไอคอนจะแสดงนโยบาย

WSDL ที่โฮสต์ใน Edge: หากต้องการดู WSDL ที่โฮสต์ใน Edge ซึ่งสร้างขึ้นสำหรับพร็อกซีประเภทนี้ ให้ไปที่ http(s)://[proxy_domain]/[proxy_base_path]?wsdl

การพัฒนาพร็อกซี SOAP เป็น REST ขั้นสูง

ส่วนก่อนหน้าครอบคลุมการสร้างพร็อกซี API จาก SOAP เป็น REST โดยใช้ตัวช่วยสร้างพร็อกซี API ใน Edge อย่างไรก็ตาม หากต้องการควบคุมการแปลง SOAP เป็น REST อย่างละเอียดมากขึ้น คุณสามารถข้ามการทำงานอัตโนมัติที่วิซาร์ดมีให้ และสร้างพร็อกซีได้โดย การเพิ่มและกำหนดค่านโยบายด้วยตนเองเพื่อให้ได้ลักษณะการทำงานที่ต้องการ ดูข้อมูลเพิ่มเติมได้ที่ บทแนะนำ: การสร้างพร็อกซี SOAP-to-REST API ใน Apigee Edge ด้วยตนเอง