इंटिग्रेटेड पोर्टल बनाएं

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

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

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

मुख्य सुविधाएं और फ़ायदे

इंटिग्रेट किए गए पोर्टल से आपको ये मुख्य सुविधाएं और फ़ायदे मिलते हैं:

सुविधा	फ़ायदे
पोर्टल कॉन्टेंट डेवलपमेंट	अपने पोर्टल का कॉन्टेंट तुरंत और आसानी से बनाएं. इस्तेमाल में आसान पेज एडिटर का इस्तेमाल करके, पेज बनाना कॉन्टेंट लिखने के लिए Markdown और एचटीएमएल का इस्तेमाल करना पोर्टल में नेविगेट करने के लिए मेन्यू जोड़ें
पोर्टल का रंग-रूप	एससीएसएस स्टाइल शीट और अपने हिसाब से ब्रैंडिंग का इस्तेमाल करके, पोर्टल के रंग-रूप को पूरी तरह से पसंद के मुताबिक बनाएं.
API दस्तावेज़ीकरण	आपके OpenAPI की विशेषताओं के आधार पर अपने-आप जनरेट होने वाला एपीआई रेफ़रंस दस्तावेज़.
व्यापारी या कंपनी को खुद से रजिस्टर करना	एपीआई का इस्तेमाल करके ऐप्लिकेशन बनाने के लिए, डेवलपर को सेल्फ़-सर्विस रजिस्ट्रेशन की सुविधा दें.
ऑडियंस मैनेजमेंट	कंट्रोल करें कि पोर्टल के कॉन्टेंट और एपीआई को कौन ऐक्सेस कर सकता है
Analytics	Google Analytics और कस्टम Analytics ट्रैकिंग को कॉन्फ़िगर करें.
बेहतर कस्टमाइज़ेशन	पोर्टल में अपनी ज़रूरत के मुताबिक बेहतर तरीके से बदलाव करें. जैसे: अपना डोमेन कस्टमाइज़ करें पसंद के मुताबिक रजिस्ट्रेशन फ़ील्ड जोड़ें स्क्रिप्ट का इस्तेमाल करके अपने पोर्टल को बड़ा करें अपना ईमेल कॉन्फ़िगर करना

अपना पोर्टल बनाना शुरू करें

Apigee, इंटिग्रेट किए गए पोर्टल में सुरक्षा का ध्यान कैसे रखता है

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

सुविधा	पते
एचटीटीपीएस और ट्रांसपोर्ट लेयर सुरक्षा (TLS) की ज़रूरत होती है	एन्क्रिप्ट (सुरक्षित) किया गया कम्यूनिकेशन लागू करें
इसमें सार्वजनिक सफ़िक्स सूची के साथ apigee.io डोमेन रजिस्ट्रेशन शामिल है	"सुपरकुकी" को apigee.io के सबडोमेन पर सेट किए जाने की अनुमति नहीं देता है
कॉन्टेंट की सुरक्षा नीति (सीएसपी) कॉन्फ़िगरेशन के साथ काम करती है	क्रॉस-साइट स्क्रिप्टिंग (XSS) और दूसरे कोड-इंजेक्शन हमलों से बचाव करता है
इसके लिए ज़रूरी है: फ़ॉर्म इनपुट को सैनिटाइज़ेशन पूरी साइट के लिए JavaScript इंजेक्शन, एडमिन तक सीमित है	एचटीएमएल, एसक्यूएल या बैकएंड इंजेक्शन के हमलों से सुरक्षा करता है
इसमें x-content-type-options: nosniff XSS हेडर शामिल है	यह विकल्प, ब्राउज़र को MIME टाइप का अनुमान लगाने की कोशिश करने से रोकता है
इसमें x-frame-options: deny XSS हेडर शामिल है	यह अनुमति, पोर्टल के कॉन्टेंट को iframe में एम्बेड करने की अनुमति नहीं देती
इसमें x-xss-protection: 1 XSS हेडर शामिल है	रिफ़्लेक्ट क्रॉस-साइट स्क्रिप्टिंग (XSS) हमलों का पता चलने पर पेजों को लोड होने से रोकता है
सीएसआरएफ़ टोकन का इस्तेमाल करता है	क्रॉस-साइट अनुरोध जालसाज़ी से सुरक्षा करता है
फ़ायदा: डेटा के ऐक्टिव न होने पर, Google Cloud डेटा एन्क्रिप्ट (सुरक्षित) करने का तरीका Google पर उपयोगकर्ता का डेटा बनाए रखने और निजी डेटा के रखरखाव की नीतियां किरायेदार को अलग रखना डेटा के रखरखाव को लॉग और डीबग करना (छह हफ़्ते)	ग्राहक के डेटा की सुरक्षा

इंटिग्रेट किया गया पोर्टल, Edge के साथ कैसे काम करता है

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

यहां दिए गए सेक्शन में ज़्यादा जानकारी दी गई है.

ऐप्लिकेशन रजिस्ट्रेशन और एपीआई पासकोड को कहां सेव किया जाता है

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

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

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

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

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

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

ऐप्लिकेशन डेवलपर खाते की जानकारी कहां सेव की जाती है

डेवलपर खाते की जानकारी को Edge में इस तरह सेव किया जाता है:

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

उपयोगकर्ता के खाते की यह जानकारी Edge में सेव होती है:

• प्रथम और उपनाम
• ईमेल पता
• उपयोगकर्ता नाम
• पोर्टल खाते की स्थिति (चालू या बंद)
• पोर्टल की भूमिका (पुष्टि किया गया उपयोगकर्ता, एडमिन, अन्य)
• भूमिका के हिसाब से अनुमतियां
• वे टीमें जिनका सदस्य पोर्टल उपयोगकर्ता है (अगर आपने टीम की सुविधा के बीटा रिलीज़ में रजिस्टर किया है)

EDGE में डेवलपर की पहचान करने के लिए, मुख्य ईमेल पता का इस्तेमाल किया जाता है. साथ ही, हर पता यूनीक होना चाहिए. मुख्य कुंजी से, Edge हर उस संगठन के लिए एक यूनीक डेवलपर आईडी जनरेट करता है जिससे डेवलपर जुड़ा है.

ज़्यादा जानकारी के लिए, ऐप्लिकेशन डेवलपर को रजिस्टर करना लेख पढ़ें.

डेवलपर टीम की जानकारी कहां सेव की जाती है (बीटा वर्शन)

जब पोर्टल का इस्तेमाल करने वाला कोई व्यक्ति, पोर्टल पर डेवलपर टीम बनाता है, तब डेवलपर टीम की जानकारी Edge में सेव की जाती है. इसमें ये चीज़ें शामिल हैं:

• डेवलपर टीम का नाम और जानकारी
• डेवलपर टीम के सदस्य और उनकी भूमिकाएं
• ऐसे ऐप्लिकेशन जिनमें डेवलपर टीम असाइन की गई है
• डेवलपर टीम को असाइन की गई ऑडियंस
• डेवलपर टीम को बनाए जाने का समय

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

ज़्यादा जानकारी के लिए, डेवलपर टीम (बीटा) का इस्तेमाल करने वाले ऐप्लिकेशन की ज़िम्मेदारी शेयर करना और डेवलपर टीम को मैनेज करना लेख पढ़ें.

सैंपल पोर्टल के बारे में जानकारी

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

सैंपल पोर्टल का होम पेज यहां पर दिखाया गया है.

सैंपल पोर्टल के साथ दिए गए स्टार्टर पेजों में ये शामिल हैं:

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

ब्राउज़र समर्थन

Apigee के इंटिग्रेट किए गए पोर्टल, जो Apigee Edge के ब्राउज़र वर्शन के साथ काम करते हैं.