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

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

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

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

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

जैसा कि नीचे बताया गया है, पोर्टल को Edge के साथ तीन तरह की जानकारी देनी होगी.

• Edpoint का यूआरएल endpoint
  
  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 संगठन के साथ सिंक रहना चाहिए. इसके लिए, यह ऐसे मैनेजमेंट एपीआई कॉल करें जिनके लिए पुष्टि करने की ज़रूरत होती है. Dedevadmin "user" के पास ज़रूरी अनुमतियां होती हैं.
  

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

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

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

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

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

1. Drupal के एडमिन मेन्यू में, कॉन्फ़िगरेशन > डेव पोर्टल सेटिंग चुनें.
2. Management API संगठन में अपने संगठन का नाम डालें.
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 यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके इस जानकारी में बदलाव कर सकता है. उदाहरण के लिए, कोई एडमिन ये काम कर सकता है:

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

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

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

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

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

• नाम
• सरनेम
• ईमेल पता
• पोर्टल से भेजी गई वैकल्पिक जानकारी

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

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

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

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

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

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

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

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

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

:

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