आपको Apigee Edge दस्तावेज़ दिख रहा है.
इस पेज पर जाएं
Apigee X दस्तावेज़. जानकारी
Apigee Edge से, 'प्रोग्राम' सेटिंग की जा सकती है बिना कोई कोड लिखे, एपीआई के काम करने का तरीका 'नीतियां'. नीति एक मॉड्यूल की तरह होती है, जो एक खास, सीमित मैनेजमेंट फ़ंक्शन को लागू करती है. नीतियों को इस तरह से डिज़ाइन किया गया है कि आप किसी एपीआई में, मैनेजमेंट से जुड़ी सामान्य सुविधाएं आसानी से जोड़ सकें और पर भरोसा करते हैं. नीतियां सुरक्षा, दर सीमित करना, बदलाव, और मीडिएशन जैसी सुविधाएं देती हैं सुविधाओं का इस्तेमाल करने से, आपको इस सुविधा को खुद कोड करने और मैनेज करने की ज़रूरत नहीं पड़ती.
आप Apigee Edge की ओर से उपलब्ध कराई गई नीतियों के सेट टाइप तक ही सीमित नहीं हैं. यह भी लिखा जा सकता है ऐसी कस्टम स्क्रिप्ट और कोड (जैसे कि JavaScript और Node.js ऐप्लिकेशन) जो एपीआई प्रॉक्सी को बढ़ाते हैं और इसके साथ ही, आप Google Ads की बेसिक मैनेजमेंट क्षमताओं के साथ-साथ, इनोवेशन Apigee की नीतियां.
नीति अटैच करने और उसे लागू करने के बारे में जानने के लिए, यह वीडियो देखें.
नीति के टाइप
तकनीकी तौर पर, नीति एक एक्सएमएल फ़ॉर्मैट वाली कॉन्फ़िगरेशन फ़ाइल होती है. हर तरह की नीति का स्ट्रक्चर (उदाहरण के लिए, ज़रूरी और वैकल्पिक कॉन्फ़िगरेशन एलिमेंट) को एक्सएमएल स्कीमा से तय किया जाता है. अगर आप एक्सएमएल टूल में पारंगत हैं, तो GitHub पर एपीआई प्लैटफ़ॉर्म के सैंपल में, नीति के स्कीमा के बारे में जाना जा सकता है.
Edge नीति के टाइप को, काम करने वाली इन कैटगरी में रखा जाता है:
ट्रैफ़िक मैनेजमेंट
ट्रैफ़िक मैनेजमेंट कैटगरी की नीतियों की मदद से, अनुरोध के फ़्लो को कंट्रोल किया जा सकता है और API प्रॉक्सी के ज़रिए प्रतिक्रिया संदेश भेज सकते हैं. ये नीतियां, ऑपरेशनल और कारोबार के लेवल, दोनों पर कंट्रोल की सुविधा देती हैं. इनसे आपको रॉ थ्रूपुट कंट्रोल मिलता है. साथ ही, ट्रैफ़िक को भी कंट्रोल किया जा सकता है अलग-अलग उपयोगकर्ताओं तक कैसे पहुँचा जा सकता है. ट्रैफ़िक मैनेजमेंट की अलग-अलग तरह की नीतियों की मदद से, कोटा लागू किया जा सकता है. साथ ही, इन टूल की मदद से, डिनायल ऑफ़ सर्विस अटैक को कम किया जा सकता है.
सुरक्षा
सुरक्षा श्रेणी की नीतियों का समर्थन करने के लिए प्रमाणीकरण, अनुमति देने के साथ-साथ कॉन्टेंट पर आधारित सुरक्षा.
मीडिएशन
मीडिएशन कैटगरी की नीतियों की मदद से, मैसेज फ़्लो के दौरान उनमें लगातार बदलाव किए जा सकते हैं को एपीआई प्रॉक्सी के ज़रिए कनेक्ट किया जाता है. इनकी मदद से, मैसेज के फ़ॉर्मैट को एक्सएमएल से JSON में बदला जा सकता है (और भी शामिल होता है. इसके अलावा, एक एक्सएमएल फ़ॉर्मैट को दूसरे एक्सएमएल फ़ॉर्मैट में बदलने के लिए भी कहा जा सकता है. इनकी मदद से, इस सुविधा का इस्तेमाल करके, नए मैसेज जनरेट किए जा सकते हैं. साथ ही, आउटबाउंड मैसेज की वैल्यू बदली जा सकती है. मीडिएशन से जुड़ी समस्या ये नीतियां, एपीआई सेवाओं के ज़रिए सार्वजनिक की गई बुनियादी सेवाओं के साथ भी इंटरैक्ट करती हैं. इससे आपको डेटा वापस पाने में मदद मिलती है रनटाइम के दौरान ऐप्लिकेशन, डेवलपर, सुरक्षा टोकन, और एपीआई प्रॉडक्ट के बारे में जानकारी.
Extension
एक्सटेंशन कैटगरी में मौजूद नीतियों की मदद से, एपीआई सेवाओं का इस्तेमाल करके, इन कामों के लिए अतिरिक्त सुविधाएं इस्तेमाल की जा सकती हैं को अपनी पसंद की प्रोग्रामिंग भाषा में कस्टम व्यवहार लागू किया जा सकता है.
हर तरह की नीति के बारे में ज़्यादा जानकारी, नीति के बारे में खास जानकारी वाले पेज में दी गई है. इस विषय में, सामान्य इंटरैक्शन के बारे में बताया गया है. इसमें, नीतियां बनाने और उन्हें एपीआई प्रॉक्सी कॉन्फ़िगरेशन में फ़्लो से जोड़ने का तरीका बताया गया है.
नीति में बदलाव लागू किए जा रहे हैं
नीति में बदलाव करने के लिए, आपको किसी एनवायरमेंट में एपीआई प्रॉक्सी रिविज़न को डिप्लॉय करना होगा. कोई नीति अटैच करने या किसी मौजूदा नीति में बदलाव करने के बाद, बदलावों को लागू करने के लिए मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) या मैनेजमेंट एपीआई का इस्तेमाल करें.
नीति उल्लंघन ठीक करने के तरीके की पुष्टि करना
यह पुष्टि करने के लिए कि नीति को सही तरीके से लागू किया गया है, एपीआई को एचटीटीपी क्लाइंट से शुरू किया जाना चाहिए. यहां की यात्रा पर हूं
इस कोटा कॉन्फ़िगरेशन की पुष्टि करें, कोटे की तय सीमा को पार करके, एपीआई को एक से ज़्यादा अनुरोध सबमिट करें
जिसे आपने कोटा नीति में सेट किया है. (यूआरआई पाथ, जिसे इसमें बेस पाथ सेटिंग के तौर पर कॉन्फ़िगर किया गया है
नीचे दिए गए अनुरोध में ProxyEndpoint /weather है).
http://{org_name}-test.apigee.net/weather/forecastrss?w=12797282
एक मिनट के अंदर एक से ज़्यादा अनुरोध सबमिट करने पर, आपको गड़बड़ी का यह मैसेज दिखेगा:
{
"fault":{
"faultstring":"policies.ratelimit.QuotaViolation",
"detail":{
"errorcode":"policies.ratelimit.QuotaViolation"
}
}
}
इससे पता चलता है कि कोटा नीति, एपीआई सेवाओं की मदद से लागू की जा रही है.
नीति के हिसाब से गड़बड़ियों को ठीक करना
ऊपर दिए गए गड़बड़ी के मैसेज का फ़ॉर्मैट नोट करें. इसमें faultstring प्रॉपर्टी शामिल है
और एक errorcode प्रॉपर्टी. कई मामलों में, आपको कुछ तरीके लागू करने होंगे, ताकि
इन गड़बड़ियों को ठीक कर लेता है. उदाहरण के लिए, हो सकता है कि आप किसी ऐसे डेवलपर को कस्टमाइज़ किया गया मैसेज भेजना चाहें जिसका ऐप्लिकेशन कोटा से ज़्यादा डेटा इस्तेमाल कर रहा हो.
गड़बड़ियों को ठीक करने के बारे में ज़्यादा जानकारी के लिए, गड़बड़ियों को मैनेज करना देखें.
सबसे सही तरीके: सामान्य नीतियों के सेट
मैनेजमेंट की बुनियादी शर्तों को पूरा करने के लिए, एपीआई प्रॉक्सी में ये नीतियां लागू की जाती हैं:
बेसिक एपीआई पासकोड पुष्टि करना
प्रॉक्सीएंडपॉइंट अनुरोध का फ़्लो:- SpikeArrest
- XMLImageProtection या JSONBetterProtection
- एपीआई पासकोड की पुष्टि करना
- अनुरोध भेजने की तय सीमा
- ResponseCache
- ResponseCache
बुनियादी ट्रांसफ़ॉर्मेशन: JSON से एक्सएमएल
अनुरोध का फ़्लो:- SpikeArrest
- JSONThreatProtection
- एपीआई पासकोड की पुष्टि करना
- अनुरोध भेजने की तय सीमा
- JSONToXML
- एक्सएमएलटोजेएसओ
- ResponseCache