คุณกําลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ Apigee X info
หัวข้อนี้จะอธิบายวิธีสร้างพร็อกซี API สําหรับบริการเว็บที่ใช้ SOAP คุณสร้างพร็อกซี SOAP ได้ 2 ประเภทใน Edge 1 รายการจะสร้างอินเทอร์เฟซ RESTful ไปยังบริการ SOAP ของแบ็กเอนด์ และอีกรายการจะ"ส่งต่อ" ข้อความ SOAP ไปยังแบ็กเอนด์ หัวข้อนี้จะอธิบายทั้ง 2 เทคนิค
วิดีโอนี้แสดงการสาธิตแบบครบวงจรของการเปลี่ยนบริการ SOAP เป็นบริการ REST ด้วย Apigee Edge โดยใช้วิซาร์ดพร็อกซี API อย่างไรก็ตาม หากต้องการควบคุมการเปลี่ยนรูปแบบ SOAP เป็น REST ได้มากขึ้น คุณสามารถสร้างพร็อกซีโดยใช้นโยบาย ดูข้อมูลเพิ่มเติมได้ที่ บทแนะนํา: การสร้างพร็อกซี SOAP เป็น REST API ด้วยตนเองใน Apigee Edge
การสร้างพร็อกซี RESTful API ไปยังบริการที่ใช้ SOAP
ส่วนนี้จะอธิบายวิธีสร้างพร็อกซี SOAP API แบบ RESTful ด้วยตัวเลือก REST to SOAP to REST ในวิซาร์ดสร้างพร็อกซี
ภาพรวม
ตัวเลือก REST to SOAP to REST จะประมวลผล WSDL เพื่อสร้างพร็อกซี RESTful API Edge จะกำหนดการดำเนินการที่รองรับของบริการ พารามิเตอร์อินพุต และอื่นๆ จาก WSDL Edge จะ "เดา" ว่าควรใช้เมธอด HTTP ใดสําหรับการดำเนินการแต่ละรายการ โดยปกติแล้ว Edge จะแปลการดำเนินการเป็นคำขอ GET ซึ่งมีข้อดีคือสามารถแคชได้ Edge ยังตั้งค่าปลายทางเป้าหมายแบ็กเอนด์ ซึ่งอาจแตกต่างกันไปตามการดำเนินการ SOAP
สําหรับพร็อกซีประเภทนี้ Edge จะสร้างข้อมูลจำเพาะ OpenAPI โดยอัตโนมัติ ซึ่งคุณใช้สร้างเอกสารประกอบ API ได้
ขั้นตอนเบื้องต้น
Edge
วิธีสร้างพร็อกซี RESTful API ไปยังบริการที่ใช้ SOAP โดยใช้ UI ของ Edge
- ลงชื่อเข้าใช้ apigee.com/edge
- เลือกพัฒนา > พร็อกซี API ในแถบนําทางด้านซ้าย
- คลิก +Proxy
- คลิกบริการ SOAP
- ในหน้ารายละเอียดพร็อกซี ให้ระบุไฟล์ WSDL
ช่อง คำอธิบาย ระบุไฟล์ WSDL เลือกแหล่งที่มาของ WSDL
- จากที่อยู่เว็บ (URL) - ป้อนหรือวาง URL ของ WSDL
- จากคอมพิวเตอร์ของฉัน - อัปโหลดไฟล์ WSDL จากไดเรกทอรีในเครื่อง คุณอัปโหลดไฟล์หลายไฟล์ได้หากมีไฟล์ที่ต้องพึ่งพา
- คลิกตรวจสอบเพื่อตรวจสอบ WSDL
- ป้อนรายละเอียดพร็อกซีต่อไปนี้
ช่อง รายละเอียด ชื่อ ชื่อที่แสดงสําหรับ API ระบุอักขระที่เป็นตัวอักษรและตัวเลขคละกัน ขีดกลาง (-) หรือขีดล่าง (_) เส้นทางฐาน ส่วนของ URI ที่ปรากฏหลังที่อยู่ http(s)://[host] ของพร็อกซี API Edge ใช้ URI เส้นทางฐานเพื่อจับคู่และกำหนดเส้นทางข้อความคำขอขาเข้าไปยังพร็อกซี API ที่เหมาะสม
หมายเหตุ: เส้นทางฐานของพร็อกซี API จะเริ่มต้นด้วยค่าที่ระบุสำหรับฟิลด์
Nameซึ่งแปลงเป็นอักษรตัวพิมพ์เล็กทั้งหมดURL ของทรัพยากรเพิ่มเติมจะตามหลังเส้นทางฐาน โครงสร้าง URL แบบเต็มซึ่งไคลเอ็นต์จะใช้เพื่อเรียก API Proxy มีดังนี้
https://[host]/base_path/conditional_flow_pathหมายเหตุ: เส้นทางฐานต้องไม่ซ้ำกัน คุณไม่สามารถทำให้พร็อกซี API 2 รายการใช้เส้นทางฐานเดียวกันได้ หากคุณแก้ไขพร็อกซี API ที่ติดตั้งใช้งานและตั้งค่าเส้นทางฐานเป็นค่าเดียวกับเส้นทางฐานของพร็อกซี API อื่น Edge จะยกเลิกการติดตั้งใช้งานพร็อกซี API โดยอัตโนมัติเมื่อคุณบันทึก คุณต้องแก้ไขเส้นทางฐานเพื่อให้ไม่ซ้ำกันก่อนจึงจะติดตั้งใช้งาน API Proxy อีกครั้งได้
ใช้ไวลด์การ์ดในเส้นทางฐาน
ใช้ไวลด์การ์ด
/*/อย่างน้อย 1 ตัวในเส้นทางฐานของพร็อกซี API เพื่อเตรียมพร้อมรับอนาคต ตัวอย่างเช่น เส้นทางฐานของ/team/*/membersช่วยให้ลูกค้าเรียกhttps://[host]/team/blue/membersและhttps://[host]/team/green/membersได้โดยไม่ต้องสร้างพร็อกซี API ใหม่เพื่อรองรับทีมใหม่ โปรดทราบว่าระบบไม่รองรับ/**/คำอธิบาย (ไม่บังคับ) คำอธิบายของ API - คลิกถัดไป
- ในหน้านโยบายทั่วไปของวิซาร์ด ให้กําหนดค่าต่อไปนี้
- ข้อกำหนดการให้สิทธิ์ด้านความปลอดภัยในส่วนความปลอดภัย: การให้สิทธิ์ โปรดดูการเพิ่มความปลอดภัย
- การรองรับกลไกการแชร์ทรัพยากรข้ามโดเมน (CORS) ในส่วนความปลอดภัย: เบราว์เซอร์ โปรดดูการเพิ่มการรองรับ CORS
- โควต้าเพื่อปกป้องบริการแบ็กเอนด์จากการเข้าชมสูงในส่วนโควต้า ดูโควต้า (ใช้ไม่ได้หากเลือกการให้สิทธิ์ผ่าน)
- ในหน้าการดำเนินการ WSDL ให้เลือกประเภทพร็อกซี API REST to SOAP to
REST
ตารางจะปรากฏขึ้นพร้อมแสดงการดำเนินการที่ Edge "ค้นพบ" ในไฟล์ WSDL คุณสามารถเลือกและกำหนดค่าการดำเนินการที่ต้องการรวมไว้ในพร็อกซี API ได้ ตารางแสดงอยู่ในรูปภาพต่อไปนี้
- เลือกประเภทพอร์ตจากเมนูแบบเลื่อนลงเพื่อระบุชุดการดำเนินการที่ต้องการใช้ ใน WSDL องค์ประกอบประเภทพอร์ตจะกำหนดการดำเนินการที่คุณเรียกใช้ในเว็บเซอร์วิสได้
- เปลี่ยนเส้นทาง REST API สำหรับการดำเนินการ (ไม่บังคับ) ระบบจะใช้เส้นทางเป็นชื่อทรัพยากรใน URL ของพร็อกซี API
- เปลี่ยนคํากริยา (เมธอด HTTP) ที่เชื่อมโยงกับการดำเนินการ (ไม่บังคับ)
- คลิกถัดไป
- ในหน้าโฮสต์เสมือนของวิซาร์ด ให้เลือกโฮสต์เสมือนที่พร็อกซี API จะเชื่อมโยงเมื่อติดตั้งใช้งาน ดูข้อมูลเพิ่มเติมได้ที่เกี่ยวกับโฮสต์เสมือน
- คลิกถัดไป
- เลือกสภาพแวดล้อมที่ติดตั้งใช้งาน แล้วคลิกสร้างและติดตั้งใช้งาน
ระบบจะสร้างและติดตั้งใช้งานพร็อกซี API ใหม่ในสภาพแวดล้อมที่เลือก - คลิกแก้ไขพร็อกซีเพื่อแสดงหน้ารายละเอียดของพร็อกซี API
Edge แบบคลาสสิก (ระบบคลาวด์ส่วนตัว)
วิธีสร้างพร็อกซี RESTful API สำหรับบริการที่ใช้ SOAP โดยใช้ UI ของ Edge แบบคลาสสิก
- ลงชื่อเข้าใช้
http://ms-ip:9000โดยที่ ms-ip คือที่อยู่ IP หรือชื่อ DNS ของโหนดเซิร์ฟเวอร์การจัดการ - เลือก API > พร็อกซี API ในแถบนำทางด้านบน
- คลิก + พร็อกซี API
- ในวิซาร์ดสร้างพร็อกซี ให้เลือกบริการ SOAP
- คลิกถัดไป
- ในหน้ารายละเอียด ให้เลือกตัวเลือกต่อไปนี้ คุณต้องคลิกตรวจสอบหลังจากเลือก WSDL
ในช่องนี้ ทําสิ่งนี้ WSDL เลือกแหล่งที่มาของ WSDL
- URL - ป้อน URL ของ WSDL ที่ต้องการใช้
- ไฟล์ - เลือกไฟล์ WSDL ในระบบไฟล์ ในกรณีที่มีไฟล์เพิ่มเติมที่เชื่อมโยงกัน คุณจะเลือกไฟล์ทั้งหมดได้
- URL ตัวอย่าง - เลือกจากรายการ WSDL สำหรับเว็บเซอร์วิสที่เผยแพร่ต่อสาธารณะ ซึ่งจะมีประโยชน์สำหรับการลองใช้ฟีเจอร์พร็อกซี SOAP/API ของ Edge
ชื่อพร็อกซี นี่คือชื่อของพร็อกซีที่คุณกําลังสร้าง
เส้นทางฐานพร็อกซี ส่วนของ URI ที่ปรากฏหลังที่อยู่ http(s)://[host] ของพร็อกซี API Edge ใช้ URI เส้นทางฐานเพื่อจับคู่และกำหนดเส้นทางข้อความคำขอขาเข้าไปยังพร็อกซี API ที่เหมาะสม
หมายเหตุ: เส้นทางฐานของพร็อกซี API จะเริ่มต้นด้วยค่าที่ระบุสำหรับฟิลด์
Nameซึ่งแปลงเป็นอักษรตัวพิมพ์เล็กทั้งหมดURL ของทรัพยากรเพิ่มเติมจะตามหลังเส้นทางฐาน โครงสร้าง URL แบบเต็มซึ่งไคลเอ็นต์จะใช้เพื่อเรียก API Proxy มีดังนี้
https://[host]/base_path/conditional_flow_pathหมายเหตุ: เส้นทางฐานต้องไม่ซ้ำกัน คุณไม่สามารถติดตั้งใช้งานพร็อกซี API 2 ตัวที่มีเส้นทางฐานเดียวกัน หากคุณแก้ไขพร็อกซี API ที่ติดตั้งใช้งานและตั้งค่าเส้นทางฐานเป็นค่าเดียวกับเส้นทางฐานของพร็อกซี API อื่น Edge จะยกเลิกการติดตั้งใช้งานพร็อกซี API โดยอัตโนมัติเมื่อคุณบันทึก คุณต้องแก้ไขเส้นทางฐานเพื่อให้ไม่ซ้ำกันก่อนจึงจะติดตั้งใช้งาน API Proxy อีกครั้งได้
ใช้ไวลด์การ์ดในเส้นทางฐาน
ใช้ไวลด์การ์ด
/*/อย่างน้อย 1 ตัวในเส้นทางฐานของพร็อกซี API เพื่อเตรียมพร้อมรับอนาคต ตัวอย่างเช่น เส้นทางฐานของ/team/*/membersอนุญาตให้ไคลเอ็นต์เรียกhttps://[host]/team/blue/membersและhttps://[host]/team/green/membersได้โดยไม่ต้องสร้างพร็อกซี API ใหม่เพื่อรองรับทีมใหม่ โปรดทราบว่าระบบไม่รองรับ/**/คำอธิบาย คำอธิบายพร็อกซีโดยย่อ - คลิกถัดไป
- ในหน้า WSDL ให้เลือกประเภทพร็อกซี API REST to SOAP to
REST
ตารางจะปรากฏขึ้นพร้อมแสดงการดำเนินการที่ Edge "ค้นพบ" ในไฟล์ WSDL คุณสามารถเลือกและกำหนดค่าการดำเนินการที่ต้องการรวมไว้ในพร็อกซี API ได้ ตารางแสดงอยู่ในรูปภาพต่อไปนี้
- เลือกชุดการดำเนินการที่ต้องการใช้จากคอลัมน์ประเภทพอร์ต ใน WSDL องค์ประกอบประเภทพอร์ตจะกำหนดการดำเนินการที่คุณเรียกใช้ในเว็บเซอร์วิสได้
- เปลี่ยนเมธอด HTTP ที่เชื่อมโยงกับการดำเนินการ (ไม่บังคับ)
หมายเหตุ: Edge จะ "คาดเดาอย่างดีที่สุด" ในการพิจารณาเมธอด HTTP ที่จะใช้สำหรับการดำเนินการแต่ละรายการ โดยทั่วไปแล้ว GET จะได้รับความนิยมมากกว่าเนื่องจากระบบสามารถแคชคำขอ GET ได้
- เปลี่ยนเส้นทาง REST API สําหรับการดำเนินการ (ไม่บังคับ) ระบบจะใช้เส้นทางเป็นชื่อทรัพยากรใน URL ของพร็อกซี API
- คลิกผ่านวิซาร์ดที่เหลือเพื่อเพิ่มความปลอดภัย เลือกโฮสต์เสมือน และสภาพแวดล้อมการทําให้ใช้งานได้
- ในหน้าสร้าง ให้คลิกสร้างและเผยแพร่ Edge จะสร้างและติดตั้งใช้งานพร็อกซี API ใหม่ตาม WSDL
- ไปที่หน้าสรุปของพร็อกซี 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
- ลงชื่อเข้าใช้ apigee.com/edge
- เลือกพัฒนา > พร็อกซี API ในแถบนําทางด้านซ้าย
- คลิก +Proxy
- คลิกบริการ SOAP
- ในหน้ารายละเอียดพร็อกซี ให้ระบุรายละเอียด WSDL
ช่อง คำอธิบาย WSDL เลือกแหล่งที่มาของ WSDL
- จากที่อยู่เว็บ (URL) - ป้อนหรือวาง URL ของ WSDL
- จากคอมพิวเตอร์ของฉัน - อัปโหลดไฟล์ WSDL จากไดเรกทอรีในเครื่อง คุณอัปโหลดไฟล์หลายไฟล์ได้หากมีไฟล์ที่ต้องพึ่งพา
ชื่อ ชื่อของพร็อกซี API
เส้นทางฐาน ส่วนของ URI หลังที่อยู่ http(s)://[host] ของพร็อกซี API Edge ใช้ URI เส้นทางฐานเพื่อจับคู่และกำหนดเส้นทางข้อความคำขอขาเข้าไปยังพร็อกซี API ที่เหมาะสม
หมายเหตุ: ดูคําแนะนําของ Apigee เกี่ยวกับการกําหนดเวอร์ชัน API ได้ที่ การกําหนดเวอร์ชันใน e-book การออกแบบ Web API: ลิงก์ที่ขาดหายไป
หลังเส้นทางฐานคือ 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 - คลิกถัดไป
- ในหน้านโยบายทั่วไปของวิซาร์ด ให้กําหนดค่าต่อไปนี้
- ข้อกำหนดในการให้สิทธิ์ด้านความปลอดภัย โปรดดูการเพิ่มความปลอดภัย
- รองรับกลไกการแชร์ทรัพยากรข้ามโดเมน (CORS) โปรดดูการเพิ่มการรองรับ CORS
- โควต้าเพื่อปกป้องบริการแบ็กเอนด์จากการเข้าชมสูง ดูโควต้า (ใช้ไม่ได้หากเลือกการให้สิทธิ์ผ่าน)
- การบังคับใช้ขีดจํากัดการสร้างรายได้สําหรับองค์กรที่เปิดใช้การสร้างรายได้ โปรดดูหัวข้อบังคับใช้ขีดจํากัดการสร้างรายได้ในพร็อกซี API
- ในหน้า WSDL ให้เลือกประเภทพร็อกซี API Pass-Through SOAP
- เลือกประเภทพอร์ตจากเมนูแบบเลื่อนลงเพื่อระบุชุดการดำเนินการที่ต้องการใช้ ใน WSDL องค์ประกอบประเภทพอร์ตจะกำหนดการดำเนินการที่คุณเรียกใช้บนเว็บเซอร์วิสได้
- คลิกถัดไป
- ในหน้าโฮสต์เสมือนของวิซาร์ด ให้เลือกโฮสต์เสมือนที่พร็อกซี API จะเชื่อมโยงเมื่อติดตั้งใช้งาน ดูข้อมูลเพิ่มเติมได้ที่เกี่ยวกับโฮสต์เสมือน
- เลือกสภาพแวดล้อมที่ใช้งานแล้วคลิกสร้างและใช้งาน
ระบบจะสร้างและติดตั้งใช้งานพร็อกซี API ใหม่ในสภาพแวดล้อมที่เลือก - คลิกแก้ไขพร็อกซีเพื่อแสดงหน้ารายละเอียดของพร็อกซี API
Edge แบบคลาสสิก (ระบบคลาวด์ส่วนตัว)
วิธีสร้างพร็อกซีการส่งต่อไปยังบริการที่ใช้ SOAP โดยใช้ UI ของ Edge แบบคลาสสิก
- ลงชื่อเข้าใช้
http://ms-ip:9000โดยที่ ms-ip คือที่อยู่ IP หรือชื่อ DNS ของโหนดเซิร์ฟเวอร์การจัดการ - เลือก API > พร็อกซี API ในแถบนำทางด้านบน
- คลิก + พร็อกซี API
- ในวิซาร์ดสร้างพร็อกซี ให้เลือกบริการ SOAP
- คลิกถัดไป
- ในหน้ารายละเอียด ให้เลือกตัวเลือกต่อไปนี้ คุณต้องคลิกตรวจสอบหลังจากเลือก WSDL
ในช่องนี้ ทําสิ่งนี้ WSDL เลือกแหล่งที่มาของ WSDL
- URL - ป้อน URL ของ WSDL ที่ต้องการใช้
- ไฟล์ - เลือกไฟล์ WSDL ในระบบไฟล์ ในกรณีที่มีไฟล์เพิ่มเติมที่เชื่อมโยงกัน คุณจะเลือกไฟล์ทั้งหมดได้
- URL ตัวอย่าง - เลือกจากรายการ WSDL สำหรับเว็บเซอร์วิสที่เผยแพร่ต่อสาธารณะ ซึ่งจะมีประโยชน์สำหรับการลองใช้ฟีเจอร์พร็อกซี SOAP/API ของ Edge
ชื่อพร็อกซี นี่คือชื่อของพร็อกซีที่คุณกําลังสร้าง
เส้นทางฐานพร็อกซี เส้นทางฐานของพร็อกซีคือส่วนของ URI ที่ระบุ API ที่พร็อกซี API นี้แสดงโดยไม่ซ้ำกัน บริการ API ใช้ URI เส้นทางฐานเพื่อจับคู่และกำหนดเส้นทางข้อความคำขอขาเข้าไปยังพร็อกซี API ที่เหมาะสม (ระบบจะเพิ่มเส้นทางฐานต่อท้ายโดเมนของ API ซึ่งสร้างขึ้นโดยอัตโนมัติตามชื่อองค์กรและสภาพแวดล้อมที่ติดตั้งใช้งานพร็อกซี API) แนวทางปฏิบัติแนะนำคือใส่หมายเลขเวอร์ชันในชื่อโปรเจ็กต์ เช่น /v1/delayedstockquoteซึ่งจะเป็นตัวกำหนดวิธีที่แอปของผู้บริโภคเรียกใช้ API ของคุณหมายเหตุ: เส้นทางฐานของพร็อกซีจะเป็นค่าเริ่มต้นที่ระบุสำหรับชื่อพร็อกซีซึ่งแปลงเป็นอักษรตัวพิมพ์เล็กทั้งหมด เว้นแต่คุณจะแก้ไขเนื้อหาในช่องเส้นทางฐานของพร็อกซีอย่างชัดเจน
คำอธิบาย คำอธิบายพร็อกซีโดยย่อ - คลิกถัดไป
- ในหน้า WSDL ให้เลือกประเภทพร็อกซี API Pass-Through SOAP
หมายเหตุ: ตารางจะปรากฏขึ้นพร้อมแสดงรายการการดำเนินการ WSDL แต่ละรายการและเพย์โหลด SOAP ที่เกี่ยวข้อง นี่คือเพย์โหลดที่ "ส่งผ่าน" ไปยังบริการ SOAP แบ็กเอนด์
- เลือกชุดการดำเนินการที่ต้องการใช้จากคอลัมน์ประเภทพอร์ต ใน WSDL องค์ประกอบประเภทพอร์ตจะกำหนดการดำเนินการที่คุณเรียกใช้ในเว็บเซอร์วิสได้
- คลิกผ่านวิซาร์ดที่เหลือเพื่อเพิ่มความปลอดภัย เลือกโฮสต์เสมือน และสภาพแวดล้อมการทําให้ใช้งานได้
- ในหน้าสร้าง ให้คลิกสร้างและเผยแพร่ Edge จะสร้างและติดตั้งใช้งานพร็อกซี API ใหม่ตาม WSDL
เกี่ยวกับพร็อกซีสุดท้าย
เมื่อ Edge สร้างพร็อกซีการส่งผ่าน พร็อกซีที่ได้จะเป็นโฟลว์ที่ซับซ้อนซึ่งรวมถึงนโยบายสำหรับการเปลี่ยนรูปแบบข้อมูล ดึงข้อมูลและตั้งค่าตัวแปร จัดการข้อความ และอื่นๆ หลังจากสร้างพร็อกซีแบบส่งผ่านแล้ว ให้ดูขั้นตอนที่เกิดขึ้นในมุมมองพัฒนาของ UI การจัดการ API คุณจะเห็นนโยบายที่เพิ่มไว้อย่างชัดเจน
ตัวอย่างเช่น รูปภาพต่อไปนี้แสดงส่วนก่อนการเข้าสู่ระบบของปลายทางเป้าหมายของพร็อกซีแบบส่งผ่าน ทางด้านคำขอ ระบบจะใช้นโยบาย AssignMessage เพื่อตั้งค่า URL เป้าหมาย ในด้านคำตอบ นโยบายจะดำเนินการเปลี่ยนรูปแบบคำตอบจาก XML เป็น JSON, ดึงข้อมูลเนื้อหา SOAP ของคำตอบมาใส่ไว้ในตัวแปร และตั้งค่าข้อความตอบกลับ ระบบจะเพิ่มนโยบายเหล่านี้ (และนโยบายอื่นๆ) โดยอัตโนมัติเมื่อคุณสร้างพร็อกซี
WSDL ที่โฮสต์ใน Edge: หากต้องการดู WSDL ที่โฮสต์ใน Edge ที่สร้างขึ้นสําหรับพร็อกซีประเภทนี้ ให้ไปที่ http(s)://[proxy_domain]/[proxy_base_path]?wsdl
การพัฒนาพร็อกซี SOAP เป็น REST ขั้นสูง
ส่วนก่อนหน้านี้กล่าวถึงการสร้างพร็อกซี SOAP-to-REST API โดยใช้วิซาร์ดพร็อกซี API ใน Edge อย่างไรก็ตาม หากต้องการการควบคุมการเปลี่ยนรูปแบบ SOAP เป็น REST ที่ละเอียดยิ่งขึ้น คุณสามารถข้ามการทำงานอัตโนมัติที่วิซาร์ดมีให้และสร้างพร็อกซีโดยการเพิ่มและกำหนดค่านโยบายด้วยตนเองเพื่อให้ได้ลักษณะการทำงานที่ต้องการ ดูข้อมูลเพิ่มเติมได้ที่ บทแนะนํา: การสร้างพร็อกซี SOAP เป็น REST API ด้วยตนเองใน Apigee Edge