Drupal पर आधारित पोर्टल और Edge के बीच कम्यूनिकेट करना

Apigee Edge का दस्तावेज़ देखा जा रहा है.
Apigee X के दस्तावेज़ पर जाएं. जानकारी

डेवलपर सेवाओं का पोर्टल, Apigee Edge के लिए क्लाइंट के तौर पर काम करता है. इसका मतलब है कि पोर्टल, स्टैंडअलोन सिस्टम के तौर पर काम नहीं करता. इसके बजाय, पोर्टल में इस्तेमाल की जाने वाली ज़्यादातर जानकारी, असल में Edge पर सेव होती है. ज़रूरत पड़ने पर, पोर्टल Edge से जानकारी पाने या उसमें जानकारी भेजने के लिए, एचटीटीपी या एचटीटीपीएस अनुरोध करता है.

Edge, पोर्टल से अनुरोध नहीं करता. यह सिर्फ़ पोर्टल से किए गए अनुरोधों का जवाब देता है. इसलिए, पोर्टल और Edge के बीच होने वाले सभी इंटरैक्शन, पोर्टल से शुरू होते हैं.

पोर्टल और Edge के बीच कनेक्शन कॉन्फ़िगर करना

पोर्टल को Edge के साथ तीन तरह की जानकारी शेयर करनी होती है. इनके बारे में यहां बताया गया है.

• Edge एंडपॉइंट का यूआरएल
  
  Cloud-based वर्शन के लिए, Edge का डिफ़ॉल्ट एंडपॉइंट https://api.enterprise.apigee.com/v1 है.
  
  निजी क्लाउड इंस्टॉलेशन के लिए, यूआरएल इस फ़ॉर्मैट में होता है: http://EdgePrivateCloudIp:8080/v1 या https://EdgePrivateCloudIp:TLSport/v1.
  
  यहां EdgePrivateCloudIp, Edge मैनेजमेंट सर्वर का आईपी पता है और TLSport, Edge मैनेजमेंट एपीआई के लिए TLS/एसएसएल पोर्ट है. उदाहरण के लिए, 8443.
• Apigee संगठन का नाम
  
  यह Edge पर आपके संगठन का नाम है. Edge पर खाता बनाते समय, संगठन सेट अप किया जाता है.
• डेवलपर एडमिन का उपयोगकर्ता नाम और पासवर्ड
  
  पोर्टल से Edge पर किए जाने वाले कॉल की पुष्टि की जाती है. इसके लिए, डेवलपर एडमिन के खास अधिकारों वाले उपयोगकर्ता की ज़रूरत होती है. जब आपके लिए डेवलपर पोर्टल सेट अप किया जाता है, तो आपके संगठन में डेवलपर एडमिन की भूमिका जोड़ी जाती है. इस भूमिका में, devadmin+{org_name}@apigee.com नाम का एक उपयोगकर्ता शामिल होता है. इसका मकसद, आपके डेवलपर पोर्टल को आपके Edge संगठन से कनेक्ट करना है. पोर्टल पर आपके Edge डेवलपर ऐप्लिकेशन, एपीआई प्रॉडक्ट वगैरह दिखते हैं. इसलिए, यह आपके Edge संगठन के साथ सिंक रहना चाहिए. इसके लिए, पोर्टल को मैनेजमेंट एपीआई कॉल करना होगा, जिनके लिए पुष्टि की ज़रूरत होती है. डेवलपर एडमिन "उपयोगकर्ता" के पास ज़रूरी अनुमतियां हों.
  

कनेक्शन की जानकारी देखने के लिए:

1. Drupal के एडमिन मेन्यू में, कॉन्फ़िगरेशन > डेवलपर पोर्टल > ऐप्लिकेशन सेटिंग चुनें.

कॉन्फ़िगरेशन बदलने के लिए:

कॉन्फ़िगरेशन बदलने का तरीका, आपके पोर्टल के इंस्टॉलेशन और वर्शन पर निर्भर करता है:

• पोर्टल के वर्शन 15.01.06 और उसके बाद के वर्शन को क्लाउड पर इंस्टॉल करना: आपको Apigee Edge की सहायता टीम से संपर्क करके, कनेक्शन की जानकारी बदलने का अनुरोध करना होगा. उदाहरण के लिए, अगर आपको संगठन का नाम बदलना है.
• ऑन-प्राइमिस इंस्टॉलेशन और क्लाउड-आधारित पोर्टल, जो 15.01.06 से पहले के वर्शन का है: कनेक्शन की जानकारी को यहां बताए गए तरीके से बदलें:

1. Drupal के एडमिन मेन्यू में, कॉन्फ़िगरेशन > डेवलपर पोर्टल की सेटिंग चुनें.
2. Management API Organization में अपने संगठन का नाम डालें.
3. Management API एंडपॉइंट यूआरएल में, Edge एंडपॉइंट का यूआरएल डालें.
4. एंडपॉइंट की पुष्टि करने वाला उपयोगकर्ता और पुष्टि किए गए उपयोगकर्ता का पासवर्ड फ़ील्ड में, संगठन के एडमिन के क्रेडेंशियल डालें.
5. कनेक्शन की जांच करें को चुनकर, पक्का करें कि कनेक्शन सही तरीके से हुआ है.
6. कॉन्फ़िगरेशन सेव करें को चुनें.

पोर्टल से Edge को ऐक्सेस करने की सुविधा चालू करना

पोर्टल में इस्तेमाल की जाने वाली ज़्यादातर जानकारी, Edge पर सेव होती है. इसलिए, आपको यह पक्का करना होगा कि पोर्टल, Edge को ऐक्सेस कर सकता हो. पोर्टल, एचटीटीपी और एचटीटीपीएस पर REST अनुरोध करके, Edge के साथ कम्यूनिकेशन शुरू करता है. उदाहरण के लिए, जब कोई डेवलपर पोर्टल पर नया ऐप्लिकेशन रजिस्टर करता है, तो पोर्टल, Edge से ऐप्लिकेशन की जानकारी भेजने का अनुरोध करता है.

Edge और पोर्टल, दोनों को क्लाउड या ऑन-प्रीमिस में डिप्लॉय किया जा सकता है. साथ ही, डिप्लॉयमेंट के अलग-अलग तरीकों को भी इस्तेमाल किया जा सकता है. उदाहरण के लिए, दोनों को क्लाउड में या दोनों को ऑन-प्रीमिस डिप्लॉय किया जा सकता है. इसके अलावा, एक को क्लाउड में और एक को ऑन-प्रीमिस डिप्लॉय भी किया जा सकता है:

• अगर पोर्टल और Edge, दोनों को Apigee ने क्लाउड में डिप्लॉय किया है, तो आपको पोर्टल से Edge को अनुरोध करने में कोई समस्या नहीं होगी.
• अगर पोर्टल को ऑन-प्रीमिस डिप्लॉय किया जाता है, तो आपको यह पक्का करना होगा कि पोर्टल, Edge से अनुरोध कर सकता है. भले ही, Edge को क्लाउड या ऑन-प्रीमिस डिप्लॉय किया गया हो.
• अगर Edge को प्रीमियर वर्शन में डिप्लॉय किया जाता है, तो आपको यह पक्का करना होगा कि पोर्टल के पास Edge का ऐक्सेस हो. इसका मतलब है कि आपके Edge सर्वर को पोर्टल से अनुरोध स्वीकार करने होंगे. भले ही, पोर्टल को क्लाउड में या ऑन-प्रीमिस डिप्लॉय किया गया हो.

पोर्टल से ऐप्लिकेशन और एपीआई कुंजियां मैनेज करना

जब डेवलपर, पोर्टल पर ऐप्लिकेशन के रजिस्ट्रेशन की प्रोसेस पूरी कर लेता है, तो पोर्टल, ऐप्लिकेशन के बारे में जानकारी Edge को भेजता है. इसमें ऐप्लिकेशन का नाम और ऐप्लिकेशन से जुड़े एपीआई प्रॉडक्ट शामिल होते हैं.

अगर Edge ऐप्लिकेशन को रजिस्टर कर लेता है, तो वह पोर्टल को एक एपीआई पासकोड दिखाता है. इसके बाद, डेवलपर उस एपीआई पासकोड का इस्तेमाल करके, ऐप्लिकेशन से जुड़े एपीआई प्रॉडक्ट ऐक्सेस करता है.

पोर्टल पर, ऐप्लिकेशन और एपीआई पासकोड की कोई जानकारी सेव नहीं की जाती. इसके बजाय, यह जानकारी Edge पर सेव की जाती है. इसलिए, जब भी कोई डेवलपर किसी ऐप्लिकेशन के बारे में जानकारी देखने के लिए पोर्टल का इस्तेमाल करता है, तो पोर्टल उस जानकारी को ऐक्सेस करने के लिए Edge से अनुरोध करता है. जब भी डेवलपर किसी ऐप्लिकेशन में बदलाव करता है, तो पोर्टल उन बदलावों को Edge पर अपने-आप भेज देता है.

उदाहरण के लिए, कोई डेवलपर पोर्टल में लॉग इन करता है और 'मेरे ऐप्लिकेशन' पेज पर जाता है. 'मेरे ऐप्लिकेशन' पेज पर जानकारी भरने के लिए, पोर्टल Edge से डेवलपर के ऐप्लिकेशन और एपीआई पासकोड की जानकारी पाने का अनुरोध करता है. इसके बाद, यह जानकारी डेवलपर के पोर्टल में मौजूद 'मेरे ऐप्लिकेशन' पेज पर दिखती है:

अगर डेवलपर किसी ऐप्लिकेशन को जोड़ता है, हटाता है या उसमें बदलाव करता है, तो पोर्टल उन बदलावों को Edge पर भेजता है.

ऐप्लिकेशन और एपीआई पासकोड की सारी जानकारी Edge पर सेव होती है. इसलिए, Edge एडमिन, Edge के यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, उस जानकारी में बदलाव कर सकता है. उदाहरण के लिए, एडमिन ये काम कर सकता है:

• डेवलपर के ऐप्लिकेशन को जोड़ना, हटाना या उसमें बदलाव करना
• किसी ऐप्लिकेशन के लिए एपीआई पासकोड रद्द करना या उसे मंज़ूरी देना

यहां 'मेरा मौसम ऐप्लिकेशन' ऐप्लिकेशन को दिखाया गया है. यह ऐप्लिकेशन, एडमिन को Edge यूज़र इंटरफ़ेस (यूआई) पर ऐसा दिखता है:

पोर्टल से डेवलपर मैनेज करना

जब कोई डेवलपर पोर्टल के नए उपयोगकर्ता के तौर पर रजिस्टर करता है, तो उसे Edge और पोर्टल, दोनों पर डेवलपर के तौर पर जोड़ दिया जाता है. इसलिए, ऐप्लिकेशन और एपीआई पासकोड के उलट, डेवलपर की जानकारी असल में Edge और पोर्टल, दोनों पर सेव की जाती है.

Edge पर सेव की गई डेवलपर की जानकारी में ये चीज़ें शामिल हैं:

• नाम
• उपनाम
• ईमेल पता
• पोर्टल से भेजी गई ज़्यादा जानकारी (ज़रूरी नहीं)

पोर्टल पर वही जानकारी सेव की जाती है जो Edge पर सेव की जाती है. हालांकि, इसमें कुछ और जानकारी भी सेव की जाती है. जैसे:

• पोर्टल का पासवर्ड
• पोर्टल खाते का स्टेटस: चालू या ब्लॉक किया गया
• पोर्टल की भूमिका: पुष्टि किया गया उपयोगकर्ता, एडमिन, अन्य
• भूमिका के हिसाब से अनुमतियां: यह तय करें कि डेवलपर को पोर्टल पर कौनसी कार्रवाइयां करने की अनुमति है

जब कोई डेवलपर पोर्टल में लॉग इन करता है, तो पोर्टल की ज़िम्मेदारी होती है कि वह डेवलपर की पुष्टि करे और भूमिका के हिसाब से अनुमतियां लागू करे.

पोर्टल में डेवलपर की सारी जानकारी सेव होती है. इसलिए, डेवलपर की जानकारी के लिए पोर्टल को रिकॉर्ड का सिस्टम मानें, न कि Edge को. जब डेवलपर पोर्टल पर अपनी जानकारी में बदलाव करता है, तो वह जानकारी पोर्टल पर सेव हो जाती है. अगर लागू हो, तो उसे Edge पर भेज दिया जाता है. उदाहरण के लिए, अगर डेवलपर अपना नाम बदलता है, तो वह जानकारी Edge को भेजी जाती है. हालांकि, अगर डेवलपर अपना पासवर्ड बदलता है, तो वह जानकारी सिर्फ़ पोर्टल पर सेव की जाती है.

ज़्यादा जानकारी के लिए, उपयोगकर्ता खाते जोड़ना और मैनेज करना लेख पढ़ें.

ऐप्लिकेशन डेवलपर को पोर्टल और Edge के बीच सिंक करना

Edge, पोर्टल के साथ कम्यूनिकेशन शुरू नहीं करता. अगर Edge एडमिन के तौर पर, आपने Edge के यूज़र इंटरफ़ेस (यूआई) में किसी डेवलपर की जानकारी में बदलाव किया है, तो इस बात की कोई गारंटी नहीं है कि वह जानकारी पोर्टल पर कब दिखेगी. इसलिए, डेवलपर बनाने, उनमें बदलाव करने, और उन्हें मिटाने के लिए, पोर्टल की एडमिन सुविधाओं का इस्तेमाल करें, न कि Edge की.

पोर्टल एडमिन, पोर्टल और Edge के बीच सिंक करने की सुविधा को ज़बरदस्ती चालू कर सकता है, ताकि Edge से पोर्टल पर जानकारी डाउनलोड की जा सके. हालांकि, अगर आपने सिर्फ़ पोर्टल पर डेवलपर की जानकारी में बदलाव किया है और Edge पर नहीं, तो आपको कभी भी यह सिंक करने की ज़रूरत नहीं पड़ेगी. इसके अलावा, Edge में डेवलपर बनाते समय पासवर्ड सेट करने की अनुमति नहीं मिलती. इसलिए, Edge पर बनाए गए किसी भी डेवलपर के पोर्टल का पासवर्ड, कोई भी वैल्यू हो सकती है. इसलिए, पोर्टल में लॉग इन करने से पहले, डेवलपर को पासवर्ड वापस पाने की प्रोसेस पूरी करनी होगी.

Edge पर ऐप्लिकेशन डेवलपर के साथ पोर्टल को सिंक करने के लिए

:

• अपने पोर्टल में, एडमिन या कॉन्टेंट बनाने की सुविधाओं वाले उपयोगकर्ता के तौर पर लॉग इन करें.
• Drupal के एडमिन मेन्यू में, लोग चुनें.
• Edge पर ऐप्लिकेशन डेवलपर के साथ सिंक करने के लिए, पेज पर सबसे ऊपर मौजूद Dev Portal Developer Sync बटन को चुनें.