Apigee Edge दस्तावेज़ देखा जा रहा है.
Apigee X दस्तावेज़ पर जाएं. जानकारी
इस विषय में, एसओएपी पर आधारित वेब सेवाओं के लिए एपीआई प्रॉक्सी बनाने का तरीका बताया गया है. Edge में, दो तरह की एसओएपी प्रॉक्सी बनाई जा सकती हैं. एक बैकएंड, एसओएपी सेवा के लिए RESTful इंटरफ़ेस को जनरेट करता है और दूसरा, बैकएंड को एसओएपी मैसेज का "पासथ्रू" करता है. इस विषय में दोनों तकनीकों के बारे में बताया गया है.
इस वीडियो में एपीआई प्रॉक्सी विज़र्ड का इस्तेमाल करके, Apigee Edge की मदद से SOAP सेवा को REST सेवा में बदलने का एंड-टू-एंड डेमो दिया गया है. हालांकि, अगर आपको SOAP-to-REST में बदलाव को बेहतर तरीके से कंट्रोल करना है, तो नीतियों का इस्तेमाल करके प्रॉक्सी बनाएं. ज़्यादा जानकारी के लिए, ट्यूटोरियल: Apigee Edge में SOAP-to-REST API प्रॉक्सी का मैन्युअल तरीके से बनाना देखें.
SOAP पर आधारित सेवा के लिए RESTful API प्रॉक्सी बनाना
यह सेक्शन बताता है कि प्रॉक्सी विज़र्ड में RESTF से SOAP से REST करने वाले विकल्प की मदद से, RESTful SOAP एपीआई प्रॉक्सी कैसे बनाएं.
खास जानकारी
REST to SOAP से REST विकल्प, RESTful API प्रॉक्सी जनरेट करने के लिए WSDL को प्रोसेस करता है. Edge, WSDL से सेवा के साथ काम करने वाली कार्रवाइयों, इनपुट पैरामीटर वगैरह का पता लगाता है. एज "अनुमान" लगाता है कि हर कार्रवाई के लिए, एचटीटीपी के किस तरीके का इस्तेमाल करना है. आम तौर पर, Edge कार्रवाई को जीईटी अनुरोधों में बदल देता है, जिन्हें कैश मेमोरी में सेव किया जा सकता है. Edge, बैकएंड टारगेट एंडपॉइंट को भी सेट अप करता है, जो हर एसओएपी ऑपरेशन के हिसाब से अलग-अलग हो सकता है.
इस तरह के प्रॉक्सी के लिए, Edge अपने-आप OpenAPI स्पेसिफ़िकेशन जनरेट करता है. इसका इस्तेमाल, एपीआई दस्तावेज़ बनाने के लिए किया जा सकता है.
बुनियादी चरण
Edge
Edge यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके एसओएपी आधारित सेवा के लिए RESTful API प्रॉक्सी बनाने के लिए:
- apigee.com/edge में साइन इन करें.
- बाएं नेविगेशन बार में, डेवलप करें > एपीआई प्रॉक्सी चुनें.
- +प्रॉक्सी पर क्लिक करें.
- एसओएपी सेवा पर क्लिक करें.
- प्रॉक्सी की ज़्यादा जानकारी वाले पेज पर, WSDL फ़ाइल दें.
फ़ील्ड ब्यौरा WSDL फ़ाइल उपलब्ध कराएं WSDL का सोर्स चुनें.
- वेब पते (यूआरएल) से - WSDL का यूआरएल डालें या चिपकाएं.
- मेरे कंप्यूटर से - अपनी लोकल डायरेक्ट्री से WSDL फ़ाइल अपलोड करें. अगर डिपेंडेंसी हैं, तो एक से ज़्यादा फ़ाइलें अपलोड की जा सकती हैं.
- WSDL की पुष्टि करने के लिए, पुष्टि करें पर क्लिक करें.
- प्रॉक्सी की ये जानकारी डालें:
फ़ील्ड ब्यौरा नाम आपके एपीआई के लिए दिखाया गया नाम. अक्षर और अंक, डैश (-) या अंडरस्कोर (_) लिखें. बेस पाथ यूआरआई फ़्रैगमेंट, जो आपके एपीआई प्रॉक्सी के http(s)://[host] पते के बाद दिखता है. Edge, आने वाले अनुरोध के मैसेज को सही एपीआई प्रॉक्सी से मैच करने और रूट करने के लिए, बेस पाथ यूआरआई का इस्तेमाल करता है.
ध्यान दें: एपीआई प्रॉक्सी बेस पाथ, डिफ़ॉल्ट रूप से
Nameफ़ील्ड के लिए तय की गई वैल्यू पर सेट होता है. इसे सभी छोटे अक्षरों में बदला जाता है.बेस पाथ के बाद, अतिरिक्त संसाधन यूआरएल दिए जाते हैं. यहां यूआरएल का पूरा स्ट्रक्चर दिया गया है. क्लाइंट इसका इस्तेमाल करके, आपके एपीआई प्रॉक्सी को कॉल करेंगे:
https://[host]/base_path/conditional_flow_pathध्यान दें: बेस पाथ यूनीक होना चाहिए. एक ही बेस पाथ का इस्तेमाल करके, दो एपीआई प्रॉक्सी डिप्लॉय नहीं किए जा सकते. अगर डिप्लॉय किए गए एपीआई प्रॉक्सी में बदलाव किया जाता है और बेस पाथ को किसी दूसरे एपीआई प्रॉक्सी के बेस पाथ के बराबर वैल्यू पर सेट किया जाता है, तो सेव करने पर Edge, एपीआई प्रॉक्सी को अपने-आप अनडिप्लॉय करता है. एपीआई प्रॉक्सी को फिर से डिप्लॉय करने से पहले, आपको बेस पाथ में बदलाव करना होगा, ताकि वह यूनीक हो.
बेस पाथ में वाइल्डकार्ड का इस्तेमाल करना
एपीआई प्रॉक्सी बेस पाथ में एक या ज़्यादा
/*/वाइल्डकार्ड का इस्तेमाल करें, ताकि आने वाले समय में आपके एपीआई प्रॉक्सी को सुरक्षित रखा जा सके. उदाहरण के लिए,/team/*/membersके बेस पाथ की मदद से, क्लाइंटhttps://[host]/team/blue/membersऔरhttps://[host]/team/green/membersको कॉल कर सकते हैं. इसके लिए, आपको नई टीमों की मदद करने के लिए, एपीआई प्रॉक्सी बनाने की ज़रूरत नहीं होती. ध्यान दें कि/**/काम नहीं करता.ब्यौरा (ज़रूरी नहीं) एपीआई की जानकारी. - आगे बढ़ें पर क्लिक करें.
- विज़र्ड के सामान्य नीतियां पेज पर, ये कॉन्फ़िगर करें:
- सुरक्षा अनुमति की ज़रूरी शर्तों को सुरक्षा: अनुमति सेक्शन में देखा जा सकता है. सुरक्षा जोड़ना देखें.
- सुरक्षा: ब्राउज़र में, क्रॉस-ऑरिजिन रिसॉर्स शेयरिंग (सीओआरएस) के लिए सहायता. सीओआरएस के लिए सहायता जोड़ना देखें.
- कोटा के तहत आपकी बैकएंड सेवा को ज़्यादा ट्रैफ़िक से सुरक्षित रखने के लिए कोटा. कोटा देखें. (अगर 'पास-थ्रू ऑथराइज़ेशन' चुना गया है, तो यह सुविधा उपलब्ध नहीं होती है.)
- WSDL पेज पर, एपीआई प्रॉक्सी टाइप REST से SOAP से
REST पर चुनें.
ऐसी कार्रवाइयों की सूची दिखाने वाली एक टेबल दिखेगी जिन्हें WSDL फ़ाइल में Edge ने "खोजा". अपने एपीआई प्रॉक्सी में शामिल करने के लिए, अपनी पसंद के मुताबिक कार्रवाइयां चुनी और कॉन्फ़िगर की जा सकती हैं. टेबल को नीचे दिए गए डायग्राम में दिखाया गया है.
- आप जिन कार्रवाइयों का इस्तेमाल करना चाहते हैं उनके बारे में बताने के लिए, ड्रॉप-डाउन से पोर्ट का प्रकार चुनें. WSDL में, पोर्ट एलिमेंट उन कार्रवाइयों को तय करते हैं जिन्हें किसी वेब सेवा पर कॉल किया जा सकता है.
- विकल्प के तौर पर, किसी कार्रवाई के लिए REST API पाथ बदलें. एपीआई प्रॉक्सी यूआरएल में, पाथ का इस्तेमाल संसाधन नाम के तौर पर किया जाएगा.
- विकल्प के तौर पर, कार्रवाई से जुड़ी वर्ब (एचटीटीपी तरीका) बदलें.
- आगे बढ़ें पर क्लिक करें.
- विज़र्ड के वर्चुअल होस्ट पेज पर, वे वर्चुअल होस्ट चुनें जिनसे एपीआई प्रॉक्सी डिप्लॉय होगा. ज़्यादा जानकारी के लिए, वर्चुअल होस्ट के बारे में जानकारी देखें.
- आगे बढ़ें पर क्लिक करें.
- डिप्लॉयमेंट एनवायरमेंट चुनें और बनाएं और डिप्लॉय करें पर क्लिक करें
आपका नया एपीआई प्रॉक्सी बन जाता है और चुने गए एनवायरमेंट में डिप्लॉय हो जाता है. - एपीआई प्रॉक्सी की ज़्यादा जानकारी वाला पेज दिखाने के लिए, प्रॉक्सी में बदलाव करें पर क्लिक करें.
क्लासिक एज (प्राइवेट क्लाउड)
क्लासिक Edge यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके एसओएपी आधारित सेवा के लिए RESTful API प्रॉक्सी बनाने के लिए:
http://ms-ip:9000में साइन इन करें. यहां ms-ip, मैनेजमेंट सर्वर नोड का आईपी पता या डीएनएस नाम है.- सबसे ऊपर मौजूद नेविगेशन बार में, एपीआई > एपीआई प्रॉक्सी चुनें.
- + एपीआई प्रॉक्सी पर क्लिक करें.
- बिल्ड प्रॉक्सी विज़र्ड में, SOAP सेवा चुनें.
- आगे बढ़ें पर क्लिक करें.
- जानकारी वाले पेज में, ये विकल्प चुनें. WSDL चुनने के बाद,
आपको पुष्टि करें पर क्लिक करना होगा.
इस फ़ील्ड में यह करो डब्ल्यूएसडीएल WSDL का सोर्स चुनें.
- यूआरएल - उस WSDL का यूआरएल डालें जिसे आपको इस्तेमाल करना है.
- फ़ाइल - अपने फ़ाइल सिस्टम पर कोई WSDL फ़ाइल चुनें. जिन मामलों में अन्य डिपेंडेंट फ़ाइलें मौजूद होती हैं उनमें से सभी को चुना जा सकता है.
- यूआरएल का उदाहरण - सार्वजनिक तौर पर उपलब्ध वेब सेवाओं के लिए, WSDL की सूची में से चुनें. ये Edge की एसओएपी/एपीआई प्रॉक्सी सुविधाओं को आज़माने के लिए आसान हैं.
प्रॉक्सी नाम यह उस प्रॉक्सी का नाम है जिसे बनाया जा रहा है.
प्रॉक्सी बेस पाथ यूआरआई फ़्रैगमेंट, जो आपके एपीआई प्रॉक्सी के http(s)://[host] पते के बाद दिखता है. Edge, आने वाले अनुरोध के मैसेज को सही एपीआई प्रॉक्सी से मैच करने और रूट करने के लिए, बेस पाथ यूआरआई का इस्तेमाल करता है.
ध्यान दें: एपीआई प्रॉक्सी बेस पाथ, डिफ़ॉल्ट रूप से
Nameफ़ील्ड के लिए तय की गई वैल्यू पर सेट होता है. इसे सभी छोटे अक्षरों में बदला जाता है.बेस पाथ के बाद, अतिरिक्त संसाधन यूआरएल दिए जाते हैं. यहां यूआरएल का पूरा स्ट्रक्चर दिया गया है. क्लाइंट इसका इस्तेमाल करके, आपके एपीआई प्रॉक्सी को कॉल करेंगे:
https://[host]/base_path/conditional_flow_pathध्यान दें: बेस पाथ यूनीक होना चाहिए. एक ही बेस पाथ वाले दो एपीआई प्रॉक्सी को डिप्लॉय नहीं किया जा सकता. अगर डिप्लॉय किए गए एपीआई प्रॉक्सी में बदलाव किया जाता है और बेस पाथ को किसी दूसरे एपीआई प्रॉक्सी के बेस पाथ के बराबर वैल्यू पर सेट किया जाता है, तो सेव करने पर Edge, एपीआई प्रॉक्सी को अपने-आप अनडिप्लॉय करता है. एपीआई प्रॉक्सी को फिर से डिप्लॉय करने से पहले, आपको बेस पाथ में बदलाव करना होगा, ताकि वह यूनीक हो.
बेस पाथ में वाइल्डकार्ड का इस्तेमाल करना
एपीआई प्रॉक्सी बेस पाथ में एक या ज़्यादा
/*/वाइल्डकार्ड का इस्तेमाल करें, ताकि आने वाले समय में आपके एपीआई प्रॉक्सी को सुरक्षित रखा जा सके. उदाहरण के लिए,/team/*/membersके बेस पाथ की मदद से, क्लाइंटhttps://[host]/team/blue/membersऔरhttps://[host]/team/green/membersको कॉल कर सकते हैं. इसके लिए, आपको नई टीमों की मदद करने के लिए, एपीआई प्रॉक्सी बनाने की ज़रूरत नहीं होती. ध्यान दें कि/**/काम नहीं करता.Description प्रॉक्सी के बारे में कम शब्दों में जानकारी. - आगे बढ़ें पर क्लिक करें.
- WSDL पेज में, एपीआई प्रॉक्सी टाइप REST से SOAP से
REST पर, चुनें.
ऐसी कार्रवाइयों की सूची दिखाने वाली एक टेबल दिखेगी जिन्हें WSDL फ़ाइल में Edge ने "खोजा". अपने एपीआई प्रॉक्सी में शामिल करने के लिए, अपनी पसंद के मुताबिक कार्रवाइयां चुनी और कॉन्फ़िगर की जा सकती हैं. टेबल को नीचे दिए गए डायग्राम में दिखाया गया है.
- पोर्ट टाइप कॉलम में से चुनें कि आपको कार्रवाई का कौनसा सेट इस्तेमाल करना है. WSDL में, पोर्ट एलिमेंट उन कार्रवाइयों को तय करते हैं जिन्हें किसी वेब सेवा पर कॉल किया जा सकता है.
- वैकल्पिक तौर पर, कार्रवाई से जुड़ा एचटीटीपी तरीका बदलें.
ध्यान दें: Edge हर कार्रवाई के लिए इस्तेमाल किया जाने वाला एचटीटीपी तरीका तय करने के लिए "सबसे अच्छा अनुमान" लगाता है. आम तौर पर, जीईटी को प्राथमिकता दी जाती है, क्योंकि जीईटी अनुरोधों को कैश मेमोरी में सेव किया जा सकता है.
- विकल्प के तौर पर, किसी कार्रवाई के लिए REST API पाथ बदलें. एपीआई प्रॉक्सी यूआरएल में, पाथ का इस्तेमाल संसाधन नाम के तौर पर किया जाएगा.
- सुरक्षा जोड़ने, वर्चुअल होस्ट चुनने, और डिप्लॉयमेंट एनवायरमेंट के लिए, बाकी के विज़र्ड पर क्लिक करें.
- बिल्ड पेज में, बनाएं और डिप्लॉय करें पर क्लिक करें. Edge, WSDL के आधार पर नए एपीआई प्रॉक्सी को जनरेट और डिप्लॉय करता है.
- नए एपीआई प्रॉक्सी के बारे में खास जानकारी वाले पेज पर जाएं. ध्यान दें कि रिसॉर्स का एक सेट,
WSDL फ़ाइल में मिली कार्रवाइयों के आधार पर बनाया गया है.
प्रॉक्सी की खास जानकारी देने वाले पेज पर, संसाधन सूची में नए एपीआई, उसकी कार्रवाइयों, और पैरामीटर की पूरी जानकारी दी जाती है. इसे एपीआई के रेफ़रंस दस्तावेज़ के तौर पर दिखाया जा सकता है. Edge आपके लिए, एपीआई मॉडल का यह व्यू अपने-आप जनरेट कर देता है. किसी संसाधन का ब्यौरा और पाथ की जानकारी देखने के लिए, उसे बड़ा करके देखें.
फ़ाइनल प्रॉक्सी के बारे में जानकारी
जब Edge, WSDL के आधार पर एपीआई प्रॉक्सी जनरेट करता है, तो नतीजे के तौर पर मिलने वाला प्रॉक्सी असल में एक मुश्किल फ़्लो होता है. इसमें डेटा बदलने, वैरिएबल को एक्सट्रैक्ट करने और सेट करने, मैसेज में हेर-फेर करने वगैरह की नीतियां शामिल होती हैं. WSDL के आधार पर प्रॉक्सी जनरेट करने के बाद, एपीआई मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) के डेवलप व्यू में दिखने वाले फ़्लो पर एक नज़र डालें. वहां, जोड़ी गई नीतियों की सटीक जानकारी मिलती है.
उदाहरण के लिए, अनुरोध साइड पर टारगेट यूआरएल सेट करने के लिए, Assignments मैसेज नीति का इस्तेमाल किया जाता है. रिस्पॉन्स साइड पर, नीतियां, रिस्पॉन्स को एक्सएमएल से JSON में बदलने, रिस्पॉन्स के एसओएपी वाले मुख्य हिस्से को एक वैरिएबल में बदलने, और रिस्पॉन्स मैसेज सेट करने के लिए काम करती हैं. प्रॉक्सी बनाते समय, ये नीतियां (और दूसरी नीतियां) अपने-आप जुड़ जाती हैं.
OpenAPI स्पेसिफ़िकेशन: इस प्रॉक्सी के लिए अपने-आप जनरेट हुआ OpenAPI स्पेसिफ़िकेशन देखने के लिए, http(s)://[proxy_domain]/[proxy_base_path]/openapi.json पर जाएं. हालांकि,
कन्वर्ज़न हमेशा सटीक नहीं होता, क्योंकि एक्सएमएल स्कीमा के सभी नियमों को
OpenAPI स्पेसिफ़िकेशन में नहीं दिखाया जा सकता.
एसओएपी पर आधारित किसी सेवा के लिए, पास-थ्रू प्रॉक्सी बनाना
इस सेक्शन में बताया गया है कि 'नया प्रॉक्सी' डायलॉग बॉक्स में, पास-थ्रू प्रॉक्सी विकल्प की मदद से पास-थ्रू प्रॉक्सी कैसे बनाएं.
खास जानकारी
पास-थ्रू प्रॉक्सी विकल्प की मदद से, ऐसी प्रॉक्सी बनाई जा सकती है जो एसओएपी मैसेज को बैकएंड सेवा के अनुरोध में पास करती है. ऐसा करने से, एसओएपी पर आधारित वेब सेवा के लिए प्रॉक्सी बनाना बहुत आसान हो जाता है. पर्दे के पीछे, Edge सभी ट्रांसफ़ॉर्मेशन और अन्य गतिविधियों को अपने-आप मैनेज करता है. उदाहरण के लिए, अगर अनुरोध JSON फ़ॉर्मैट में होता है, तो Edge को सेवा में पोस्ट करने से पहले उसे सही नेमस्पेस वाले एक्सएमएल SOAP मैसेज में बदलने के लिए ज़रूरी कदम उठाए जाते हैं. इसी तरह, जब सेवा, एक्सएमएल पर आधारित एसओएपी रिस्पॉन्स दिखाती है, तो क्लाइंट को वापस लौटाने से पहले, Edge उसे JSON में बदल देता है. इसके अलावा, Edge बैकएंड टारगेट एंडपॉइंट सेट अप करता है, जो हर एसओएपी ऑपरेशन के हिसाब से अलग-अलग हो सकता है.
इस तरह की प्रॉक्सी के लिए, Edge WSDL को होस्ट करता है और प्रॉक्सी में एक फ़्लो बनाता है, ताकि आप उसे ऐक्सेस कर सकें. Edge पर होस्ट किए गए इस WSDL,
http(s)://[proxy_domain]/[proxy_base_path]?wsdl का पता, प्रॉक्सी के ज़रिए एसओएपी सेवा को कॉल करने वाले क्लाइंट के लिए, नया सर्विस एंडपॉइंट यूआरएल बन जाता है.
बुनियादी चरण
Edge
Edge यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके एसओएपी पर आधारित सेवा के लिए, पास-थ्रू प्रॉक्सी बनाने के लिए:
- apigee.com/edge में साइन इन करें.
- बाएं नेविगेशन बार में, डेवलप करें > एपीआई प्रॉक्सी चुनें.
- +प्रॉक्सी पर क्लिक करें.
- एसओएपी सेवा पर क्लिक करें.
- प्रॉक्सी की जानकारी वाले पेज पर, WSDL की जानकारी दें.
फ़ील्ड ब्यौरा डब्ल्यूएसडीएल WSDL का सोर्स चुनें.
- वेब पते (यूआरएल) से - WSDL का यूआरएल डालें या चिपकाएं.
- मेरे कंप्यूटर से - अपनी लोकल डायरेक्ट्री से WSDL फ़ाइल अपलोड करें. अगर डिपेंडेंसी हैं, तो एक से ज़्यादा फ़ाइलें अपलोड की जा सकती हैं.
नाम एपीआई प्रॉक्सी का नाम.
बेस पाथ आपके एपीआई प्रॉक्सी के http(s)://[host] पते के बाद यूआरआई फ़्रैगमेंट. Edge, आने वाले अनुरोध के मैसेज को सही एपीआई प्रॉक्सी से मैच करने और रूट करने के लिए, बेस पाथ यूआरआई का इस्तेमाल करता है.
ध्यान दें: एपीआई वर्शन के बारे में Apigee से मिले सुझाव देखने के लिए, वेब एपीआई डिज़ाइन: लिंक मौजूद नहीं है ई-बुक में वर्शन वर्शन देखें.
बेस पाथ के बाद, अतिरिक्त रिसॉर्स यूआरएल शामिल किए जाते हैं. यहां यूआरएल का पूरा स्ट्रक्चर दिया गया है. क्लाइंट इसका इस्तेमाल करके, आपके एपीआई प्रॉक्सी को कॉल करेंगे:
https://[host]/base_path/conditional_flow_pathध्यान दें: बेस पाथ यूनीक होना चाहिए. अगर बाद में इस प्रॉक्सी में बदलाव किया जाता है और इसके बेस पाथ को किसी दूसरी एपीआई प्रॉक्सी के जैसा सेट किया जाता है, तो सेव करने पर इस एपीआई प्रॉक्सी को अपने-आप डिप्लॉय नहीं किया जाता. आपको बेस पाथ को फिर से डिप्लॉय करने से पहले, उसमें बदलाव करना होगा.
बेस पाथ में वाइल्डकार्ड का इस्तेमाल करना
एपीआई प्रॉक्सी बेस पाथ में एक या एक से ज़्यादा
/*/वाइल्डकार्ड का इस्तेमाल किया जा सकता है, ताकि आने वाले समय में आपकी प्रॉक्सी की पुष्टि की जा सके. उदाहरण के लिए,/team/*/membersके बेस पाथ की मदद से, क्लाइंटhttps://[host]/team/blue/membersऔरhttps://[host]/team/green/membersको कॉल कर सकते हैं. इसके लिए, आपको नई टीमों की मदद करने के लिए, एपीआई प्रॉक्सी बनाने की ज़रूरत नहीं होती. ध्यान दें कि /**/ का इस्तेमाल नहीं किया जा सकता.ध्यान दें: जब तक बेस पाथ फ़ील्ड के कॉन्टेंट में साफ़ तौर पर बदलाव नहीं किया जाता, तब तक एपीआई प्रॉक्सी बेस पाथ, डिफ़ॉल्ट रूप से नाम फ़ील्ड के लिए तय की गई वैल्यू के हिसाब से लोअर केस में बदल दिया जाता है.
ब्यौरा (ज़रूरी नहीं) एपीआई की जानकारी. - आगे बढ़ें पर क्लिक करें.
- विज़र्ड के सामान्य नीतियां पेज पर, ये कॉन्फ़िगर करें:
- सुरक्षा की पुष्टि के लिए ज़रूरी शर्तें. सुरक्षा जोड़ना देखें.
- क्रॉस-ऑरिजिन रिसॉर्स शेयरिंग (सीओआरएस) के लिए सहायता. सीओआरएस के लिए सहायता जोड़ना देखें.
- आपकी बैकएंड सेवा को ज़्यादा ट्रैफ़िक से बचाने के लिए कोटा. कोटा देखें. (अगर 'पास-थ्रू ऑथराइज़ेशन' चुना गया है, तो यह सुविधा उपलब्ध नहीं होती है.)
- जिन संगठनों के लिए कमाई करने की सुविधा चालू की गई है उनके लिए कमाई करने की सीमा लागू करना. एपीआई प्रॉक्सी पर कमाई करने की सीमाएं लागू करना लेख पढ़ें.
- WSDL पेज पर, एपीआई प्रॉक्सी टाइप Pass-थ्रू SOAP चुनें.
- आप जिन कार्रवाइयों का इस्तेमाल करना चाहते हैं उनके बारे में बताने के लिए, ड्रॉप-डाउन से पोर्ट का प्रकार चुनें. WSDL में, पोर्ट एलिमेंट उन कार्रवाइयों को तय करते हैं जिन्हें किसी वेब सेवा पर कॉल किया जा सकता है.
- आगे बढ़ें पर क्लिक करें.
- विज़र्ड के वर्चुअल होस्ट पेज पर, वे वर्चुअल होस्ट चुनें जिनसे एपीआई प्रॉक्सी डिप्लॉय होगा. ज़्यादा जानकारी के लिए, वर्चुअल होस्ट के बारे में जानकारी देखें.
- डिप्लॉयमेंट एनवायरमेंट चुनें और बनाएं और डिप्लॉय करें पर क्लिक करें
आपका नया एपीआई प्रॉक्सी बन जाता है और चुने गए एनवायरमेंट में डिप्लॉय किया जाता है. - एपीआई प्रॉक्सी की ज़्यादा जानकारी वाला पेज दिखाने के लिए, प्रॉक्सी में बदलाव करें पर क्लिक करें.
क्लासिक एज (प्राइवेट क्लाउड)
क्लासिक Edge यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके एसओएपी पर आधारित सेवा के लिए, पास-थ्रू प्रॉक्सी बनाने के लिए:
http://ms-ip:9000में साइन इन करें. यहां ms-ip, मैनेजमेंट सर्वर नोड का आईपी पता या डीएनएस नाम है.- सबसे ऊपर मौजूद नेविगेशन बार में, एपीआई > एपीआई प्रॉक्सी चुनें.
- + एपीआई प्रॉक्सी पर क्लिक करें.
- बिल्ड प्रॉक्सी विज़र्ड में, SOAP सेवा चुनें.
- आगे बढ़ें पर क्लिक करें.
- जानकारी वाले पेज में, ये विकल्प चुनें. WSDL चुनने के बाद,
आपको पुष्टि करें पर क्लिक करना होगा.
इस फ़ील्ड में यह करो डब्ल्यूएसडीएल WSDL का सोर्स चुनें.
- यूआरएल - उस WSDL का यूआरएल डालें जिसका आपको इस्तेमाल करना है.
- फ़ाइल - अपने फ़ाइल सिस्टम पर कोई WSDL फ़ाइल चुनें. जिन मामलों में अतिरिक्त डिपेंडेंट फ़ाइलें मौजूद होती हैं उन सभी को चुना जा सकता है.
- यूआरएल का उदाहरण - सार्वजनिक तौर पर उपलब्ध वेब सेवाओं के लिए, WSDL की सूची में से चुनें. ये Edge की एसओएपी/एपीआई प्रॉक्सी सुविधाओं को आज़माने के लिए आसान हैं.
प्रॉक्सी नाम यह उस प्रॉक्सी का नाम है जिसे बनाया जा रहा है.
प्रॉक्सी बेस पाथ प्रॉक्सी बेस पाथ एक यूआरआई फ़्रैगमेंट है, जो खास तौर पर उस एपीआई की पहचान करता है जिसे इस एपीआई प्रॉक्सी की मदद से दिखाया गया है. एपीआई सेवाएं, बेस पाथ यूआरआई का इस्तेमाल करती हैं. इससे, वे अनुरोध के आने वाले मैसेज को सही एपीआई प्रॉक्सी से मैच कर पाते हैं और उन्हें रूट कर पाते हैं. (बेस पाथ को एपीआई के डोमेन से जोड़ा जाता है, जो आपके संगठन के नाम और उस एनवायरमेंट के आधार पर अपने-आप जनरेट होता है जहां एपीआई प्रॉक्सी डिप्लॉय की गई है.) सबसे सही तरीका यह है कि प्रोजेक्ट के नाम में वर्शन नंबर शामिल करें, जैसे कि /v1/delayedstockquote. इससे यह तय होगा कि उपभोक्ता ऐप्लिकेशन में आपके एपीआई को कैसे चालू किया जाएगा.ध्यान दें: जब तक आप प्रॉक्सी बेस पाथ फ़ील्ड में कॉन्टेंट में साफ़ तौर पर बदलाव नहीं करते, तब तक प्रॉक्सी बेस पाथ, डिफ़ॉल्ट रूप से प्रॉक्सी नाम के लिए तय की गई वैल्यू को लोअर केस में बदल देता है.
Description प्रॉक्सी के बारे में कम शब्दों में जानकारी. - आगे बढ़ें पर क्लिक करें.
- WSDL पेज में, एपीआई प्रॉक्सी टाइप पास-थ्रू SOAP चुनें.
ध्यान दें: एक टेबल दिखती है जिसमें हर WSDL और उससे जुड़े एसओएपी पेलोड की जानकारी मौजूद होती है. यह वह पेलोड है जिसे बैकएंड एसओएपी सेवा को "भेजा" जाता है.
- पोर्ट टाइप कॉलम में से चुनें कि आपको कार्रवाई का कौनसा सेट इस्तेमाल करना है. WSDL में, पोर्ट एलिमेंट उन कार्रवाइयों को तय करते हैं जिन्हें किसी वेब सेवा पर कॉल किया जा सकता है.
- सुरक्षा जोड़ने, वर्चुअल होस्ट चुनने, और डिप्लॉयमेंट एनवायरमेंट के लिए, बाकी के विज़र्ड पर क्लिक करें.
- बिल्ड पेज में, बनाएं और डिप्लॉय करें पर क्लिक करें. Edge, WSDL के आधार पर नए एपीआई प्रॉक्सी को जनरेट और डिप्लॉय करता है.
फ़ाइनल प्रॉक्सी के बारे में जानकारी
जब Edge, पास-थ्रू प्रॉक्सी जनरेट करता है, तब प्रॉक्सी से जनरेट होने वाला एक मुश्किल फ़्लो होता है. इसमें डेटा बदलने, वैरिएबल को एक्सट्रैक्ट करने और सेट करने, मैसेज में हेर-फेर करने वगैरह की नीतियां शामिल होती हैं. पास-थ्रू प्रॉक्सी जनरेट करने के बाद, एपीआई मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) के डेवलप व्यू में दिखने वाले फ़्लो पर एक नज़र डालें. वहां, जोड़ी गई नीतियों की सटीक जानकारी मिलती है.
उदाहरण के लिए, नीचे दिए गए डायग्राम में पास-थ्रू प्रॉक्सी का टारगेट एंडपॉइंट प्रीफ़्लो हिस्सा दिखाया गया है. अनुरोध किए जाने पर, टारगेट यूआरएल सेट करने के लिए, Assignments मैसेज नीति का इस्तेमाल किया जाता है. रिस्पॉन्स साइड पर, नीतियां, रिस्पॉन्स को एक्सएमएल से JSON में बदलने के लिए काम करती हैं. साथ ही, रिस्पॉन्स के एसओएपी वाले मुख्य हिस्से को वैरिएबल में एक्सट्रैक्ट करती हैं, और रिस्पॉन्स मैसेज सेट करती हैं. प्रॉक्सी बनाने पर, ये नीतियां और दूसरी नीतियां अपने-आप जुड़ जाती हैं.
Edge का होस्ट किया गया WSDL: इस तरह के प्रॉक्सी के लिए जनरेट किया गया Edge-होस्ट किया गया WSDL देखने के लिए, http(s)://[proxy_domain]/[proxy_base_path]?wsdl पर जाएं.
एसओएपी-टू-REST प्रॉक्सी डेवलपमेंट की बेहतर सुविधा
पिछले सेक्शन में, Edge में एपीआई प्रॉक्सी विज़र्ड का इस्तेमाल करके SOAP-to-REST API प्रॉक्सी बनाने के बारे में बताया गया था. हालांकि, अगर आपको SOAP-से-REST के ट्रांसफ़ॉर्मेशन पर ज़्यादा कंट्रोल चाहिए, तो आपके पास विज़र्ड से मिले ऑटोमेशन को बायपास करने का विकल्प है. इसके बाद, मनमुताबिक व्यवहार पाने के लिए, मैन्युअल तौर पर नीतियां जोड़कर और उन्हें कॉन्फ़िगर करके प्रॉक्सी बनाएं. ज़्यादा जानकारी के लिए, ट्यूटोरियल: Apigee Edge में SOAP-to-REST API प्रॉक्सी का मैन्युअल तरीके से बनाना देखें.