Apigee Edge का दस्तावेज़ देखा जा रहा है.
Apigee X के दस्तावेज़ पर जाएं. जानकारी
इस विषय में, SOAP-आधारित वेब सेवाओं के लिए एपीआई प्रॉक्सी बनाने का तरीका बताया गया है. Edge में दो तरह के SOAP प्रोक्सी बनाए जा सकते हैं. एक, बैकएंड एसओएपी सेवा के लिए RESTful इंटरफ़ेस जनरेट करता है और दूसरा, बैकएंड पर एसओएपी मैसेज को "पास-थ्रू" करता है. इस विषय में, दोनों तकनीकों के बारे में बताया गया है.
इस वीडियो में, एपीआई प्रॉक्सी विज़र्ड का इस्तेमाल करके, Apigee Edge की मदद से किसी SOAP सेवा को REST सेवा में बदलने का पूरा डेमो दिखाया गया है. हालांकि, अगर आपको SOAP से REST में बदलाव करने की प्रोसेस पर ज़्यादा कंट्रोल चाहिए, तो नीतियों का इस्तेमाल करके एक प्रॉक्सी बनाई जा सकती है. ज़्यादा जानकारी के लिए, ट्यूटोरियल: Apigee Edge में SOAP-to-REST एपीआई प्रॉक्सी को मैन्युअल तरीके से बनाना देखें.
SOAP पर आधारित सेवा के लिए, RESTful एपीआई प्रॉक्सी बनाना
इस सेक्शन में, REST से SOAP से REST विकल्प की मदद से, RESTful SOAP API प्रॉक्सी बनाने का तरीका बताया गया है. यह तरीका, 'प्रॉक्सी बनाएं' विज़र्ड में बताया गया है.
खास जानकारी
REST से SOAP से REST विकल्प, WSDL को प्रोसेस करके RESTful एपीआई प्रॉक्सी जनरेट करता है. Edge, WSDL से यह तय करता है कि सेवा के कौनसे ऑपरेशन काम करते हैं, इनपुट पैरामीटर क्या हैं वगैरह. Edge यह "अनुमान" लगाता है कि हर ऑपरेशन के लिए, एचटीटीपी का कौनसा तरीका इस्तेमाल करना है. आम तौर पर, Edge, ऑपरेशन को जीईटी अनुरोधों में बदल देता है. इनका फ़ायदा यह है कि इन्हें कैश मेमोरी में सेव किया जा सकता है. Edge, बैकएंड टारगेट एंडपॉइंट को भी सेट अप करता है. यह हर SOAP ऑपरेशन के हिसाब से अलग-अलग हो सकता है.
इस तरह के प्रॉक्सी के लिए, Edge अपने-आप एक OpenAPI स्पेसिफ़िकेशन जनरेट करता है. इसका इस्तेमाल, एपीआई दस्तावेज़ बनाने के लिए किया जा सकता है.
बुनियादी चरण
Edge
Edge यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, SOAP-आधारित सेवा के लिए RESTful एपीआई प्रॉक्सी बनाने के लिए:
- apigee.com/edge में साइन इन करें.
- बाईं ओर मौजूद नेविगेशन बार में, डेवलप करें > एपीआई प्रॉक्सी चुनें.
- +प्रॉक्सी पर क्लिक करें.
- SOAP सेवा पर क्लिक करें.
- प्रॉक्सी की जानकारी वाले पेज पर, 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 to SOAP to
REST चुनें.
एक टेबल दिखती है, जिसमें उन ऑपरेशन की सूची होती है जिन्हें Edge ने WSDL फ़ाइल में "ढूंढा" है. आपके पास यह चुनने और कॉन्फ़िगर करने का विकल्प होता है कि आपको एपीआई प्रॉक्सी में कौनसे ऑपरेशन शामिल करने हैं. टेबल इस इमेज में दिखाई गई है.
- ड्रॉप-डाउन से कोई पोर्ट टाइप चुनें, ताकि यह तय किया जा सके कि आपको ऑपरेशन के किस सेट का इस्तेमाल करना है. WSDL में, पोर्ट टाइप एलिमेंट उन कार्रवाइयों के बारे में बताते हैं जिन्हें वेब सेवा पर कॉल किया जा सकता है.
- किसी कार्रवाई के लिए, REST API पाथ को बदला जा सकता है. हालांकि, ऐसा करना ज़रूरी नहीं है. पाथ का इस्तेमाल, एपीआई प्रॉक्सी यूआरएल में संसाधन के नाम के तौर पर किया जाएगा.
- इसके अलावा, कार्रवाई से जुड़े क्रिया (एचटीटीपी तरीका) को बदला जा सकता है.
- आगे बढ़ें पर क्लिक करें.
- विज़र्ड के वर्चुअल होस्ट पेज पर, वे वर्चुअल होस्ट चुनें जिनसे एपीआई प्रॉक्सी को डिप्लॉय करने पर बंधा जाएगा. ज़्यादा जानकारी के लिए, वर्चुअल होस्ट के बारे में जानकारी देखें.
- आगे बढ़ें पर क्लिक करें.
- डिप्लॉयमेंट एनवायरमेंट चुनें और बनाएं और डिप्लॉय करें पर क्लिक करें
आपकी नई एपीआई प्रॉक्सी बन जाएगी और चुने गए एनवायरमेंट में डिप्लॉय हो जाएगी. - एपीआई प्रॉक्सी के बारे में जानकारी वाला पेज देखने के लिए, प्रॉक्सी में बदलाव करें पर क्लिक करें.
क्लासिक Edge (निजी क्लाउड)
क्लासिक Edge यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, SOAP-आधारित सेवा के लिए RESTful एपीआई प्रॉक्सी बनाने के लिए:
http://ms-ip:9000में साइन इन करें. यहां ms-ip, मैनेजमेंट सर्वर नोड का आईपी पता या डीएनएस नेम है.- सबसे ऊपर मौजूद नेविगेशन बार में, एपीआई > एपीआई प्रॉक्सी चुनें.
- + एपीआई प्रॉक्सी पर क्लिक करें.
- 'प्रॉक्सी बनाएं' विज़र्ड में, SOAP सेवा चुनें.
- आगे बढ़ें पर क्लिक करें.
- ज़्यादा जानकारी वाले पेज पर, ये विकल्प चुनें. WSDL चुनने के बाद, आपको पुष्टि करें पर क्लिक करना होगा.
इस फ़ील्ड में यह करें WSDL WSDL का सोर्स चुनें.
- यूआरएल - उस WSDL का यूआरएल डालें जिसका इस्तेमाल करना है.
- फ़ाइल - अपने फ़ाइल सिस्टम में मौजूद कोई WSDL फ़ाइल चुनें. जिन मामलों में, डिपेंडेंट फ़ाइलें मौजूद हों उनमें सभी फ़ाइलों को चुना जा सकता है.
- यूआरएल का उदाहरण - सार्वजनिक तौर पर उपलब्ध वेब सेवाओं के लिए, WSDL की सूची में से कोई एक चुनें. ये Edge के SOAP/एपीआई प्रॉक्सी की सुविधाओं को आज़माने के लिए काम के हैं.
प्रॉक्सी का नाम यह उस प्रॉक्सी का नाम है जिसे बनाया जा रहा है.
प्रॉक्सी का बेस पाथ यूआरआई का वह फ़्रैगमेंट जो आपकी एपीआई प्रॉक्सी के 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 to SOAP to
REST चुनें.
एक टेबल दिखती है, जिसमें उन ऑपरेशन की सूची होती है जिन्हें Edge ने WSDL फ़ाइल में "ढूंढा" है. आपके पास यह चुनने और कॉन्फ़िगर करने का विकल्प होता है कि आपको एपीआई प्रॉक्सी में कौनसे ऑपरेशन शामिल करने हैं. टेबल इस इमेज में दिखाई गई है.
- पोर्ट टाइप कॉलम से चुनें कि आपको ऑपरेशन के किस सेट का इस्तेमाल करना है. WSDL में, पोर्ट टाइप एलिमेंट उन कार्रवाइयों के बारे में बताते हैं जिन्हें वेब सेवा पर कॉल किया जा सकता है.
- इसके अलावा, ऑपरेशन से जुड़ा एचटीटीपी तरीका भी बदला जा सकता है.
ध्यान दें: Edge, हर कार्रवाई के लिए इस्तेमाल किए जाने वाले एचटीटीपी तरीके का पता लगाने के लिए, "सबसे सही अनुमान" लगाता है. आम तौर पर, GET को प्राथमिकता दी जाती है, क्योंकि GET अनुरोधों को कैश मेमोरी में सेव किया जा सकता है.
- किसी कार्रवाई के लिए, REST API पाथ को बदला जा सकता है. हालांकि, ऐसा करना ज़रूरी नहीं है. पाथ का इस्तेमाल, एपीआई प्रॉक्सी यूआरएल में संसाधन के नाम के तौर पर किया जाएगा.
- सुरक्षा जोड़ने, वर्चुअल होस्ट चुनने, और डिप्लॉयमेंट के लिए, विज़र्ड के बाकी हिस्सों पर क्लिक करें माहौल.
- 'बिल्ड करें' पेज पर, बिल्ड और डिप्लॉय करें पर क्लिक करें. Edge, WSDL के आधार पर नई एपीआई प्रॉक्सी जनरेट और डिप्लॉय करता है.
- नए एपीआई प्रॉक्सी की खास जानकारी वाले पेज पर जाएं. ध्यान दें कि WSDL फ़ाइल में मिले ऑपरेशन के आधार पर, रिसॉर्स का एक सेट बनाया गया है.
प्रॉक्सी के होम पेज पर, संसाधन सूची में नए एपीआई, उसके काम करने के तरीके, और पैरामीटर के बारे में पूरी जानकारी मिलती है. इस रेप्रज़ेंटेशन को एपीआई के रेफ़रंस दस्तावेज़ के तौर पर देखा जा सकता है. Edge, एपीआई मॉडल का यह व्यू आपके लिए अपने-आप जनरेट करता है. किसी संसाधन का ब्यौरा और पाथ की जानकारी देखने के लिए, बस उसे बड़ा करें.
फ़ाइनल प्रोक्सी के बारे में जानकारी
जब Edge, WSDL के आधार पर एपीआई प्रॉक्सी जनरेट करता है, तो बनने वाली प्रॉक्सी असल में एक जटिल फ़्लो होती है. इसमें डेटा को बदलने, वैरिएबल को निकालने और सेट करने, मैसेज में बदलाव करने वगैरह की नीतियां शामिल होती हैं. WSDL के आधार पर कोई प्रॉक्सी जनरेट करने के बाद, एपीआई मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) के 'डिवेलप' व्यू में, जनरेट हुए फ़्लो को देखें. वहां आपको यह पता चलेगा कि कौनसी नीतियां जोड़ी गई हैं.
उदाहरण के लिए, अनुरोध करने वाले पक्ष पर, टारगेट यूआरएल सेट करने के लिए, AssignMessage नीति का इस्तेमाल किया जाता है. रिस्पॉन्स के हिस्से में, नीतियां रिस्पॉन्स को एक्सएमएल से JSON में बदलने के लिए लागू होती हैं. साथ ही, रिस्पॉन्स के SOAP बॉडी हिस्से को वैरिएबल में निकालती हैं और रिस्पॉन्स मैसेज सेट करती हैं. प्रॉक्सी बनाने पर, ये नीतियां और अन्य नीतियां अपने-आप जुड़ जाती हैं.
OpenAPI स्पेसिफ़िकेशन: इस प्रॉक्सी के लिए, अपने-आप जनरेट हुआ OpenAPI स्पेसिफ़िकेशन देखने के लिए,
http(s)://[proxy_domain]/[proxy_base_path]/openapi.json पर जाएं. हालांकि,
कन्वर्ज़न हमेशा सटीक नहीं होता, क्योंकि किसी एक्सएमएल स्कीमा के सभी नियमों को
OpenAPI स्पेसिफ़िकेशन में नहीं दिखाया जा सकता.
SOAP-आधारित सेवा के लिए पास-थ्रू प्रॉक्सी बनाना
इस सेक्शन में, नई प्रॉक्सी बनाने वाले डायलॉग में पास-थ्रू प्रॉक्सी विकल्प की मदद से, पास-थ्रू प्रॉक्सी बनाने का तरीका बताया गया है.
खास जानकारी
पास-थ्रू प्रॉक्सी विकल्प की मदद से, ऐसी प्रॉक्सी बनाई जा सकती है जो बैकएंड सेवा के अनुरोध में एसओएपी मैसेज को "बिना बदलाव के" पास करती है. इससे, एसओएपी पर आधारित वेब सेवा के लिए प्रॉक्सी बनाना बहुत आसान हो जाता है. बैकग्राउंड में, Edge आपके लिए किसी भी तरह के ट्रांसफ़ॉर्मेशन और फ़्लो की अन्य गतिविधियों को अपने-आप मैनेज करता है. उदाहरण के लिए, अगर अनुरोध JSON फ़ॉर्मैट में है, तो Edge, सेवा पर पोस्ट करने से पहले, उसे सही नेमस्पेस के साथ मान्य एक्सएमएल एसओएपी मैसेज में बदलने के लिए कार्रवाई करता है. इसी तरह, जब सेवा एक्सएमएल पर आधारित SOAP रिस्पॉन्स दिखाती है, तो Edge उसे क्लाइंट को दिखाने से पहले, फिर से JSON में बदल देता है. इसके अलावा, Edge बैकएंड टारगेट के एंडपॉइंट को सेट अप करता है. यह हर SOAP ऑपरेशन के हिसाब से अलग-अलग हो सकता है.
इस तरह के प्रॉक्सी के लिए, Edge, WSDL को होस्ट करता है और प्रॉक्सी में एक फ़्लो बनाता है, ताकि आप उसे ऐक्सेस कर सकें. Edge पर होस्ट किए गए इस WSDL का पता,
http(s)://[proxy_domain]/[proxy_base_path]?wsdl, प्रॉक्सी के ज़रिए SOAP सेवा को कॉल करने वाले क्लाइंट के लिए, सेवा का नया एंडपॉइंट यूआरएल बन जाता है.
बुनियादी चरण
Edge
Edge यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, SOAP पर आधारित सेवा के लिए पास-थ्रू प्रॉक्सी बनाने के लिए:
- apigee.com/edge में साइन इन करें.
- बाईं ओर मौजूद नेविगेशन बार में, डेवलप करें > एपीआई प्रॉक्सी चुनें.
- +प्रॉक्सी पर क्लिक करें.
- SOAP सेवा पर क्लिक करें.
- प्रॉक्सी की जानकारी वाले पेज पर, WSDL की जानकारी दें.
फ़ील्ड ब्यौरा 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 पेज पर, एपीआई प्रॉक्सी टाइप पास-थ्रू SOAP चुनें.
- ड्रॉप-डाउन से कोई पोर्ट टाइप चुनें, ताकि यह तय किया जा सके कि आपको ऑपरेशन के किस सेट का इस्तेमाल करना है. WSDL में, पोर्ट टाइप एलिमेंट उन कार्रवाइयों के बारे में बताते हैं जिन्हें वेब सेवा पर कॉल किया जा सकता है.
- आगे बढ़ें पर क्लिक करें.
- विज़र्ड के वर्चुअल होस्ट पेज पर, वे वर्चुअल होस्ट चुनें जिनसे एपीआई प्रॉक्सी को डिप्लॉय करने पर बंधा जाएगा. ज़्यादा जानकारी के लिए, वर्चुअल होस्ट के बारे में जानकारी देखें.
- डिप्लॉयमेंट एनवायरमेंट चुनें और बनाएं और डिप्लॉय करें पर क्लिक करें
आपकी नई एपीआई प्रॉक्सी बनाई गई और चुने गए एनवायरमेंट में डिप्लॉय की गई. - एपीआई प्रॉक्सी के बारे में जानकारी वाला पेज देखने के लिए, प्रॉक्सी में बदलाव करें पर क्लिक करें.
क्लासिक Edge (निजी क्लाउड)
क्लासिक Edge यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, SOAP पर आधारित सेवा के लिए पास-थ्रू प्रॉक्सी बनाने के लिए:
http://ms-ip:9000में साइन इन करें. यहां ms-ip, मैनेजमेंट सर्वर नोड का आईपी पता या डीएनएस नेम है.- सबसे ऊपर मौजूद नेविगेशन बार में, एपीआई > एपीआई प्रॉक्सी चुनें.
- + एपीआई प्रॉक्सी पर क्लिक करें.
- 'प्रॉक्सी बनाएं' विज़र्ड में, SOAP सेवा चुनें.
- आगे बढ़ें पर क्लिक करें.
- ज़्यादा जानकारी वाले पेज पर, ये विकल्प चुनें. WSDL चुनने के बाद, आपको पुष्टि करें पर क्लिक करना होगा.
इस फ़ील्ड में यह करें WSDL WSDL का सोर्स चुनें.
- यूआरएल - उस WSDL का यूआरएल डालें जिसका इस्तेमाल करना है.
- फ़ाइल - अपने फ़ाइल सिस्टम में मौजूद कोई WSDL फ़ाइल चुनें. जिन मामलों में ज़रूरी फ़ाइलें और भी हैं उन्हें भी चुना जा सकता है.
- यूआरएल का उदाहरण - सार्वजनिक तौर पर उपलब्ध वेब सेवाओं के लिए, WSDL की सूची में से कोई एक चुनें. ये Edge के SOAP/एपीआई प्रॉक्सी की सुविधाओं को आज़माने के लिए काम के हैं.
प्रॉक्सी का नाम यह उस प्रॉक्सी का नाम है जिसे बनाया जा रहा है.
प्रॉक्सी का बेस पाथ प्रॉक्सी का बुनियादी पाथ, यूआरआई का एक फ़्रैगमेंट होता है. इससे उस एपीआई की खास पहचान की जाती है जिसे इस एपीआई प्रॉक्सी ने एक्सपोज़ किया है. एपीआई सेवाएं, आने वाले अनुरोध मैसेज को सही एपीआई प्रॉक्सी से मैच करने और रूट करने के लिए, बेस पाथ यूआरआई का इस्तेमाल करती हैं. (बेस पाथ को एपीआई के डोमेन में जोड़ा जाता है, जो आपके संगठन के नाम और उस एनवायरमेंट के आधार पर अपने-आप जनरेट होता है जहां एपीआई प्रॉक्सी को डिप्लॉय किया गया है.) प्रोजेक्ट के नाम में वर्शन नंबर शामिल करना सबसे सही तरीका है. उदाहरण के लिए, /v1/delayedstockquote. इससे यह तय होगा कि कंज़्यूमर ऐप्लिकेशन आपके एपीआई को कैसे कॉल करते हैं.ध्यान दें: प्रॉक्सी बेस पाथ, डिफ़ॉल्ट रूप से प्रॉक्सी नेम के लिए तय की गई वैल्यू पर सेट होता है. इसे छोटे अक्षरों में बदल दिया जाता है. ऐसा तब तक होता है, जब तक प्रॉक्सी बेस पाथ फ़ील्ड में कॉन्टेंट में साफ़ तौर पर बदलाव नहीं किया जाता.
जानकारी प्रॉक्सी के बारे में कम शब्दों में जानकारी. - आगे बढ़ें पर क्लिक करें.
- WSDL पेज में, एपीआई प्रॉक्सी टाइप पास-थ्रू SOAP चुनें.
ध्यान दें: एक टेबल दिखती है, जिसमें हर WSDL ऑपरेशन और उससे जुड़े SOAP पेलोड की सूची होती है. यह वह पेलोड है जिसे बैकएंड SOAP सेवा पर "पास किया जाता है".
- पोर्ट टाइप कॉलम से चुनें कि आपको ऑपरेशन के किस सेट का इस्तेमाल करना है. WSDL में, पोर्ट टाइप एलिमेंट उन कार्रवाइयों के बारे में बताते हैं जिन्हें वेब सेवा पर कॉल किया जा सकता है.
- सुरक्षा जोड़ने, वर्चुअल होस्ट चुनने, और डिप्लॉयमेंट के लिए, विज़र्ड के बाकी हिस्सों पर क्लिक करें एनवायरमेंट.
- 'बिल्ड करें' पेज पर, बिल्ड और डिप्लॉय करें पर क्लिक करें. Edge, WSDL के आधार पर नई एपीआई प्रॉक्सी जनरेट और डिप्लॉय करता है.
फ़ाइनल प्रोक्सी के बारे में जानकारी
जब Edge कोई पास-थ्रू प्रॉक्सी जनरेट करता है, तो बनने वाली प्रॉक्सी असल में एक जटिल फ़्लो होती है. इसमें डेटा में बदलाव करने, वैरिएबल निकालने और सेट करने, मैसेज में बदलाव करने वगैरह की नीतियां शामिल होती हैं. पास-थ्रू प्रॉक्सी जनरेट करने के बाद, एपीआई मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) के 'डेवलप' व्यू में, नतीजे के तौर पर मिलने वाले फ़्लो को देखें. वहां आपको यह पता चलेगा कि कौनसी नीतियां जोड़ी गई हैं.
उदाहरण के लिए, नीचे दिए गए इलस्ट्रेशन में, पास-थ्रू प्रोक्सी के टारगेट एंडपॉइंट के प्रीफ़्लो का हिस्सा दिखाया गया है. अनुरोध करने वाले पक्ष पर, टारगेट यूआरएल सेट करने के लिए, AssignMessage नीति का इस्तेमाल किया जाता है. रिस्पॉन्स के हिस्से में, नीतियां लागू होती हैं, ताकि रिस्पॉन्स को एक्सएमएल से JSON में बदला जा सके. साथ ही, रिस्पॉन्स के SOAP बॉडी वाले हिस्से को वैरिएबल में निकाला जा सके और रिस्पॉन्स मैसेज सेट किया जा सके. प्रॉक्सी बनाने पर, ये नीतियां और अन्य नीतियां अपने-आप जुड़ जाती हैं.
Edge पर होस्ट किया गया WSDL: इस तरह के प्रोक्सी के लिए जनरेट किया गया, Edge पर होस्ट किया गया WSDL देखने के लिए, http(s)://[proxy_domain]/[proxy_base_path]?wsdl पर जाएं.
बेहतर एसओएपी-टू-आरईएसटी प्रॉक्सी डेवलपमेंट
पिछले सेक्शन में, Edge में एपीआई प्रॉक्सी विजर्ड का इस्तेमाल करके, SOAP-to-REST एपीआई प्रॉक्सी बनाने के बारे में बताया गया है. हालांकि, अगर आपको SOAP से REST में बदलाव करने की प्रोसेस पर ज़्यादा कंट्रोल चाहिए, तो विज़र्ड की मदद से मिलने वाले ऑटोमेशन को बायपास किया जा सकता है. साथ ही, अपनी पसंद के हिसाब से व्यवहार पाने के लिए, मैन्युअल तरीके से नीतियां जोड़कर और कॉन्फ़िगर करके, एक प्रॉक्सी बनाई जा सकती है. ज़्यादा जानकारी के लिए, ट्यूटोरियल: Apigee Edge में SOAP-to-REST एपीआई प्रॉक्सी को मैन्युअल तरीके से बनाना देखें.