Apigee Edge दस्तावेज़ देखा जा रहा है.
Apigee X दस्तावेज़ पर जाएं. जानकारी
Apigee Edge में, संगठन टॉप-लेवल का कंटेनर होता है. इसमें आपकी सभी एपीआई प्रॉक्सी और उनसे जुड़े संसाधन शामिल हैं. इस विषय के बाकी हिस्से में, संगठनों के बारे में ज़्यादा जानकारी दी गई है. हालांकि, यहां काम करने के लिए कुछ बातें बताई गई हैं:
- डिफ़ॉल्ट रूप से, आपके संगठन का नाम उस यूआरएल में होता है जिसका इस्तेमाल आपके एपीआई प्रॉक्सी को कॉल करने के लिए किया जाता है, जैसा कि वर्चुअल होस्ट के बारे में जानकारी में बताया गया है.
उदाहरण के लिए:
http(s)://your_org_name-environment.apigee.net/proxy_base_path/...
- आपके संगठन का नाम, Edge मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) के यूआरएल में है. उदाहरण के लिए, यह यूआरएल
docsसंगठन के लिए एपीआई प्रॉक्सी दिखाता है:
- हो सकता है कि आपने सिर्फ़ एक संगठन बनाया हो, लेकिन आप दूसरे संगठनों में खास अनुमतियों वाले उपयोगकर्ता या एडमिन के तौर पर शामिल हो सकते हैं. अगर आप एक से ज़्यादा संगठनों से जुड़े हैं, तो Edge मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) में जाकर, किसी दूसरे संगठन पर स्विच किया जा सकता है. इसके बारे में अपने संगठनों के बीच स्विच करना में बताया गया है.
- जब संगठन के एडमिन की भूमिका वाले उपयोगकर्ता के तौर पर, management API से कॉल किया जाता है,
तो ज़्यादातर कॉल में संगठन की पाथ का ज़रूरी हिस्सा होता है. उदाहरण के लिए, नीचे दिया गया
management API cURL अनुरोध किसी संगठन में सभी एपीआई प्रॉक्सी की सूची दिखाता है:
curl https://api.enterprise.apigee.com/v1/organizations/your_org_name/apis -u org_admin_email_address
वीडियो: यह जानने के लिए एक छोटा वीडियो देखें कि संगठन, एपीआई मैनेजमेंट के लिए मल्टी-टेनंसी आर्किटेक्चर के साथ कैसे काम करते हैं.
संगठन के कॉम्पोनेंट
Edge खाता बनाने पर, Edge आपके लिए अपने-आप एक संगठन बना देता है. ऐसा करने के बाद, उपयोगकर्ताओं को अपने संगठन में जोड़ा जा सकता है, एपीआई प्रॉक्सी और एपीआई प्रॉडक्ट बनाए जा सकते हैं, और डेवलपर और ऐप्लिकेशन रजिस्टर किए जा सकते हैं.
नीचे दी गई इमेज में, Edge के संगठन के मॉडल के मुख्य कॉम्पोनेंट दिखाए गए हैं. इस मॉडल से पता चलता है कि आपके एपीआई, एपीआई प्रॉडक्ट, ऐप्लिकेशन, और ऐप्लिकेशन डेवलपर, Edge में एक-दूसरे से किस तरह जुड़े होते हैं.
इस मॉडल में Apigee Edge की सभी सुविधाएं नहीं दिखती हैं. अगर कमाई करने की सुविधा का इस्तेमाल किया जाता है, तो इस मॉडल में अन्य कॉम्पोनेंट भी शामिल होंगे. ज़्यादा जानकारी के लिए, कमाई करने से जुड़ी खास जानकारी देखें. कमाई करने वाली कंपनियों और डेवलपर को मैनेज करने के बारे में जानकारी के लिए, कंपनी और डेवलपर को मैनेज करें पर जाएं.
संगठन का नाम
संगठन का यह नाम है:
- मूल्यांकन करने वाला संगठन:
username-eval - पैसे चुकाकर लिया गया संगठन: यह शुरुआती प्रावधान के समय उपयोगकर्ता की ओर से तय किया जाता है
संगठन बनाने के बाद, उसका नाम नहीं बदला जा सकता.
Edge मैनेजमेंट एपीआई को अनुरोध करते समय, संगठन का नाम आपके एपीआई प्रॉक्सी के यूआरएल का हिस्सा बन जाता है और यूआरएल का हिस्सा बन जाता है. उदाहरण के लिए, किसी एपीआई प्रॉक्सी को ऐक्सेस करने के लिए इस्तेमाल किए जाने वाले आम यूआरएल का फ़ॉर्मैट इस तरह होता है:
http://org-name-env.apigee.net/v1/weather/forecastrss
कहां:
- org-name, आपके संगठन का नाम है.
- env, एपीआई प्रॉक्सी के डिप्लॉयमेंट एनवायरमेंट में से एक है. इसका इस्तेमाल टेस्ट या प्रोडक्शन के लिए किया जा सकता है.
उदाहरण के लिए:
http://myorg-test.apigee.net/v1/weather/forecastrss
संगठन के कॉम्पोनेंट
नीचे दी गई टेबल में संगठन के मॉडल के कॉम्पोनेंट के बारे में ज़्यादा जानकारी दी गई है:
| कॉम्पोनेंट | ब्यौरा |
|---|---|
|
संगठन |
हर Apigee खाता, Apigee Edge पर एक या एक से ज़्यादा संगठनों से मैप होता है. संगठन में सभी कॉम्पोनेंट की जानकारी शामिल होती है. इनमें एपीआई प्रॉक्सी, एपीआई प्रॉडक्ट, एपीआई पैकेज, ऐप्लिकेशन, और डेवलपर शामिल हैं. खाते के मालिक एक ही संगठन से जुड़े नहीं हो सकते. खाता मालिक, ऐसे कई संगठनों की पहचान कर सकते हैं या उनके सदस्य हो सकते हैं जो अलग-अलग ऐप्लिकेशन डेवलपर कम्यूनिटी के साथ काम करते हैं. |
| एनवायरमेंट | किसी संगठन में एपीआई प्रॉक्सी के लिए रनटाइम एक्ज़ीक्यूशन का कॉन्टेक्स्ट. एनवायरमेंट के बारे में ज़्यादा जानने के लिए, नीचे दिया गया सेक्शन देखें. |
|
उपयोगकर्ता |
अगर किसी संगठन में खाता बनाने वाला व्यक्ति अपने-आप एडमिन होता है, तो संगठन में आपके पास ज़्यादा उपयोगकर्ताओं को जोड़ने का विकल्प होता है. उपयोगकर्ता, संगठन की एपीआई टीम बनाते हैं. इसमें एडमिन, एपीआई प्रॉक्सी, और एपीआई प्रॉडक्ट बनाने वाले लोग, आंकड़ों और अन्य आंकड़ों की निगरानी करने वाले उपयोगकर्ता, और अन्य लोग शामिल हो सकते हैं. अलग-अलग उपयोगकर्ताओं की अलग-अलग भूमिकाएं और ऐक्सेस के खास अधिकार हो सकते हैं. उदाहरण के लिए, कुछ उपयोगकर्ताओं को संगठन के एडमिन और ऑपरेशन एडमिन के तौर पर तय करें, जिनके पास संगठन और उसके कॉम्पोनेंट में बदलाव करने का खास अधिकार हो. दूसरे उपयोगकर्ताओं को एपीआई प्रॉक्सी और एपीआई प्रॉडक्ट बनाने की अनुमतियां दें, लेकिन उनके पास दूसरे उपयोगकर्ताओं में बदलाव करने का अधिकार न दें. उपयोगकर्ता, एक से ज़्यादा संगठनों के सदस्य हो सकते हैं. उदाहरण के लिए, आपकी कंपनी अलग-अलग डेवलपर कम्यूनिटी के साथ काम करने के लिए, Apigee Edge पर कई संगठन बना सकती है. हालांकि, ये लोग ही सभी एपीआई प्रॉक्सी और एपीआई प्रॉडक्ट बनाते हैं और इसलिए आपके सभी संगठनों के सदस्य होते हैं. उपयोगकर्ता बनने के लिए, आपको Apigee खाता बनाने की ज़रूरत नहीं है. जैसे, Apigee संगठन. एडमिन आपको किसी मौजूदा संगठन में जोड़ सकता है. सभी उपयोगकर्ता, यहां Apigee Edge में लॉग इन करते हैं: https://enterprise.apigee.com. |
|
एपीआई प्रॉक्सी |
किसी संगठन के उपयोगकर्ता, एक या उससे ज़्यादा एपीआई प्रॉक्सी बनाते हैं. एपीआई प्रॉक्सी से यह पता चलता है कि किसी बैकएंड सेवा के लिए, सार्वजनिक रूप से उपलब्ध एचटीटीपी एंडपॉइंट की मैपिंग की गई है. एपीआई प्रॉक्सी को इस तरह भी कॉन्फ़िगर किया जा सकता है कि इनमें सुरक्षा शामिल हो (जैसे कि OAuth), मैसेज में बदलाव करना (जैसे एक्सएमएल से JSON), ट्रैफ़िक को बैकएंड सेवाओं तक सीमित करना, और अनुरोध पर, उसके जवाब देने, और सेवा के कॉलआउट की मदद से दूसरी अहम कार्रवाइयां करना. Edge, एपीआई प्रॉक्सी पर आंकड़े इकट्ठा करता है. |
|
एपीआई प्रॉडक्ट |
संगठन के उपयोगकर्ता एक या उससे ज़्यादा एपीआई प्रॉडक्ट बनाते हैं. इनमें एपीआई प्रॉडक्ट, सेवा प्लान के साथ एपीआई प्रॉक्सी का बंडल होता है. वह सेवा प्लान, एपीआई प्रॉक्सी पर ऐक्सेस की सीमा तय कर सकता है, सुरक्षा दे सकता है, निगरानी करने और विश्लेषण करने की अनुमति दे सकता है, और अतिरिक्त सुविधाएं दे सकता है. Edge, एपीआई प्रॉडक्ट से जुड़े आंकड़ों के लिए डेटा इकट्ठा करता है. |
|
डेवलपर |
किसी संगठन में एक या उससे ज़्यादा डेवलपर होते हैं, जो आपके संगठन के तय किए गए एपीआई (एपीआई प्रॉडक्ट में इकट्ठा किए गए) का इस्तेमाल करने वाले ऐप्लिकेशन बनाते हैं. डेवलपर, एपीआई का इस्तेमाल करते हैं, लेकिन वे एपीआई नहीं बना सकते या संगठन में कोई दूसरी कार्रवाई नहीं कर सकते. डेवलपर, आपकी कंपनी के अंदरूनी हो सकते हैं, पार्टनर हो सकते हैं. इसके अलावा, वे ऐसे बाहरी डेवलपर भी हो सकते हैं जो आपके एपीआई ऐक्सेस करने के लिए पैसे देते हैं. डेवलपर के लिए यह ज़रूरी है कि वे आपके संगठन में रजिस्टर हों. इसके बाद ही, वे किसी ऐप्लिकेशन को रजिस्टर कर सकते हैं और आपके एपीआई को ऐक्सेस करने के लिए, एपीआई पासकोड पा सकते हैं. एपीआई की सेवा देने वाली कंपनी के तौर पर, यह आपकी ज़िम्मेदारी है कि अपने संगठन में डेवलपर को कैसे जोड़ें, अपडेट करें या हटाएं. उन्हें Edge मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) की मदद से मैन्युअल तरीके से जोड़ा जा सकता है, उन्हें रजिस्टर करने के लिए डेवलपर पोर्टल बनाया जा सकता है. इसके अलावा, Edge मैनेजमेंट एपीआई का इस्तेमाल करके, रजिस्ट्रेशन करने का अपना तरीका तय किया जा सकता है. डेवलपर को Edge पर खाता बनाने की ज़रूरत नहीं होती. साथ ही, ज़्यादातर डेवलपर को Edge के बारे में कुछ भी जानने की ज़रूरत नहीं होती. अगर डेवलपर का खाता Edge पर है, तो आम तौर पर वह किसी दूसरे संगठन के उपयोगकर्ता के तौर पर होता है या Edge API सेवाएं इस्तेमाल करता है. |
|
ऐप्लिकेशन |
डेवलपर आपके एपीआई का इस्तेमाल करने वाले एक या उससे ज़्यादा क्लाइंट ऐप्लिकेशन बनाते हैं. डेवलपर को अपने ऐप्लिकेशन आपके संगठन के साथ रजिस्टर करने होंगे. 'एज में ऐप्लिकेशन' डेवलपर के असल ऐप्लिकेशन का प्रतिनिधित्व करता है. यह डेवलपर को एक एपीआई पासकोड देता है, ताकि वह आपके एपीआई से किए गए हर अनुरोध को पास कर सके. सभी ऐप्लिकेशन आपके संगठन में रजिस्टर होते हैं. इसलिए, आपके पास Edge का इस्तेमाल करके ऐप्लिकेशन पर मौजूद, आंकड़ों से जुड़ी जानकारी इकट्ठा करने और उसे मॉनिटर करने के लिए इस्तेमाल करने का विकल्प होता है. साथ ही, यह भी इस्तेमाल किया जा सकता है कि यह ऐप्लिकेशन आपके एपीआई का इस्तेमाल कैसे करता है. |
|
एपीआई पासकोड/OAuth टोकन |
आपने एपीआई के लिए, पुष्टि करने का जो तरीका तय किया है उसके आधार पर, ऐप्लिकेशन आपके एपीआई के हर अनुरोध के साथ, एक एपीआई पासकोड भी पास करता है. अगर वह कुंजी मान्य है, तो अनुरोध की अनुमति दी जाती है. Edge, पुष्टि करने के अलग-अलग तरीकों के साथ काम करता है, जैसे कि एक सामान्य एपीआई पासकोड, दो पैरों वाला OAuth, तीन पैरों वाला OAuth वगैरह. एपीआई की सेवा देने वाली कंपनी के तौर पर, आपको डेवलपर के लिए अपने ऐप्लिकेशन रजिस्टर करने का तरीका बताना होगा. उपयोगकर्ताओं के ऐप्लिकेशन को रजिस्टर करने पर, आपको डेवलपर के पास उस कुंजी का ऐक्सेस वापस मिल जाता है जो एपीआई ऐक्सेस करने के लिए ज़रूरी है. ऐप्लिकेशन रजिस्ट्रेशन के समय, डेवलपर यह चुन सकता है कि एपीआई के किसी एक प्रॉडक्ट या एपीआई के एक से ज़्यादा प्रॉडक्ट को ऐक्सेस करना है. डेवलपर का असली ऐप्लिकेशन, ऐप्लिकेशन से जुड़े सभी एपीआई प्रॉडक्ट को ऐक्सेस करने के लिए एक ही कुंजी का इस्तेमाल करता है (एज में डेवलपर के ऐप्लिकेशन का रजिस्टर किया गया वर्शन). किसी भी समय, आपके पास कुंजी को वापस लेने का विकल्प होता है, ताकि डेवलपर के ऐप्लिकेशन के पास आपके एपीआई का ऐक्सेस न रहे. भले ही, डेवलपर के ऐप्लिकेशन का रजिस्टर किया गया प्रतिनिधि अब भी आपके संगठन में मौजूद हो. इसके अलावा, किसी कुंजी पर समयसीमा तय की जा सकती है, ताकि डेवलपर को तय समय के बाद कुंजी को रीफ़्रेश करना पड़े. |
एनवायरमेंट के बारे में जानकारी
एनवायरमेंट, किसी संगठन में एपीआई प्रॉक्सी के लिए रनटाइम चलाने का कॉन्टेक्स्ट होता है. इसे ऐक्सेस करने से पहले, आपको किसी एनवायरमेंट में एपीआई प्रॉक्सी डिप्लॉय करना होगा. एपीआई प्रॉक्सी को एक या एक से ज़्यादा एनवायरमेंट में डिप्लॉय किया जा सकता है.
एक संगठन में कई एनवायरमेंट हो सकते हैं. उदाहरण के लिए, किसी संगठन में dev, test, और prod एनवायरमेंट तय किया जा सकता है.
संगठन में Apigee की कुछ सुविधाएं उपलब्ध हैं. उदाहरण के लिए, की-वैल्यू-मैप (केवीएम) डेटा को संगठन के लेवल पर उपलब्ध कराया जा सकता है. इसका मतलब है कि किसी भी एनवायरमेंट के लिए लागू किए गए एपीआई प्रॉक्सी को केवीएम से वही डेटा मिलेगा. कैश मेमोरी जैसी कुछ सुविधाएं, संगठन के दायरे में या संगठन के किसी खास एनवायरमेंट के हिसाब से हो सकती हैं. Apigee के आंकड़ों को इकट्ठा करने के लिए, डेटा को संगठन और एनवायरमेंट के हिसाब से बांटा जाता है.
यहां उन मुख्य इकाइयों की जानकारी दी गई है जिन्हें किसी संगठन में मैनेज किया जाता है. इनमें, संगठन में दुनिया भर में लागू होने वाली इकाइयां और खास तौर पर किसी एनवायरमेंट के लिए बनाई गई इकाइयां शामिल होती हैं:
