निजी क्लाउड के लिए, Edge पर एसएएमएल के साथ काम करना

Edge for Private Cloud v4.19.01

Edge यूज़र इंटरफ़ेस (यूआई) और Edge मैनेजमेंट एपीआई, Edge मैनेजमेंट सर्वर को अनुरोध भेजकर काम करते हैं. मैनेजमेंट सर्वर, पुष्टि करने के इन तरीकों के साथ काम करता है:

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

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

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

Edge for Private Cloud के लिए, OAuth2 की सुविधा जोड़ी गई

जैसा कि ऊपर बताया गया है, एसएएमएल को लागू करने के लिए Edge, OAuth2 ऐक्सेस टोकन का इस्तेमाल करता है.इसलिए, Edge for Private Cloud में OAuth2 की सुविधा जोड़ी गई है. ज़्यादा जानकारी के लिए, OAuth 2.0 के बारे में जानकारी लेख पढ़ें.

एसएएमएल के फ़ायदे

एसएएमएल ऑथेंटिकेशन के कई फ़ायदे हैं. SAML का इस्तेमाल करके, ये काम किए जा सकते हैं:

  • यूज़र मैनेजमेंट का पूरा कंट्रोल पाएं. जब उपयोगकर्ता आपका संगठन छोड़ देते हैं और उन्हें केंद्रीय तौर पर हटा दिया जाता है, तो उन्हें Edge का ऐक्सेस अपने-आप नहीं मिलता..
  • यह कंट्रोल करना कि Edge को ऐक्सेस करने के लिए, उपयोगकर्ता अपनी पहचान की पुष्टि कैसे करें. अलग-अलग Edge संगठनों के लिए, पुष्टि करने के अलग-अलग तरीके चुने जा सकते हैं.
  • पुष्टि करने से जुड़ी नीतियों को कंट्रोल करें. ऐसा हो सकता है कि आपका SAML प्रोवाइडर, पुष्टि करने की ऐसी नीतियों के साथ काम करता हो जो आपके एंटरप्राइज़ के स्टैंडर्ड के मुताबिक हों.
  • Edge डिप्लॉयमेंट पर लॉगिन, लॉगआउट, लॉगिन की असफल कोशिशों, और ज़्यादा जोखिम वाली गतिविधियों पर नज़र रखी जा सकती है.

Edge के साथ एसएएमएल का इस्तेमाल करना

Edge पर एसएएमएल का इस्तेमाल करने के लिए, Edge एसएसओ मॉड्यूल apigee-sso इंस्टॉल करें. इस इमेज में, Edge for Private Cloud इंस्टॉलेशन में Edge SSO को दिखाया गया है:

Edge एसएसओ मॉड्यूल को Edge यूज़र इंटरफ़ेस (यूआई) और मैनेजमेंट सर्वर वाले नोड पर इंस्टॉल किया जा सकता है. इसके अलावा, इसे इसके अपने नोड पर भी इंस्टॉल किया जा सकता है. पक्का करें कि Edge एसएसओ के पास, पोर्ट 8080 पर मैनेजमेंट सर्वर का ऐक्सेस हो.

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

Edge SSO, Postgres नोड पर पोर्ट 5432 पर ऐक्सेस किए जा सकने वाले Postgres डेटाबेस का इस्तेमाल करता है. आम तौर पर, Edge के साथ इंस्टॉल किए गए Postgres सर्वर का इस्तेमाल किया जा सकता है. इसके लिए, स्टैंडअलोन Postgres सर्वर या मास्टर/स्टैंडबाय मोड में कॉन्फ़िगर किए गए दो Postgres सर्वर का इस्तेमाल किया जा सकता है. अगर आपके Postgres सर्वर पर लोड ज़्यादा है, तो सिर्फ़ Edge एसएसओ के लिए अलग Postgres नोड बनाने का विकल्प भी चुना जा सकता है.

SAML चालू होने पर, Edge यूज़र इंटरफ़ेस (यूआई) और Edge मैनेजमेंट एपीआई को ऐक्सेस करने के लिए, OAuth2 ऐक्सेस टोकन का इस्तेमाल किया जाता है. ये टोकन, Edge SSO मॉड्यूल से जनरेट होते हैं. यह मॉड्यूल, आपके आईडीपी से मिले एसएएमएल असर्शन को स्वीकार करता है.

एसएएमएल असर्शन से जनरेट होने के बाद, OAuth टोकन 30 मिनट के लिए मान्य होता है. साथ ही, रीफ़्रेश टोकन 24 घंटे के लिए मान्य होता है. ऐसा हो सकता है कि आपका डेवलपमेंट एनवायरमेंट, डेवलपमेंट से जुड़े सामान्य टास्क के लिए ऑटोमेशन की सुविधा के साथ काम करता हो. जैसे, टेस्ट ऑटोमेशन या लगातार इंटिग्रेशन/लगातार डिप्लॉयमेंट (सीआई/सीडी). इनके लिए, ज़्यादा समय तक मान्य रहने वाले टोकन की ज़रूरत होती है. अपने-आप होने वाले टास्क के लिए खास टोकन बनाने के बारे में जानकारी पाने के लिए, अपने-आप होने वाले टास्क के लिए एसएएमएल का इस्तेमाल करना लेख पढ़ें.

Edge यूज़र इंटरफ़ेस (यूआई) और एपीआई यूआरएल

Edge यूज़र इंटरफ़ेस (यूआई) और Edge Management API को ऐक्सेस करने के लिए इस्तेमाल किया जाने वाला यूआरएल, वही है जो एसएएमएल को चालू करने से पहले इस्तेमाल किया जाता था. Edge यूज़र इंटरफ़ेस (यूआई) के लिए:

http://edge_ui_IP_DNS:9000
https://edge_ui_IP_DNS:9000

जहां edge_ui_IP_DNS, Edge यूज़र इंटरफ़ेस (यूआई) को होस्ट करने वाली मशीन का आईपी पता या डीएनएस नाम है. Edge यूज़र इंटरफ़ेस (यूआई) को कॉन्फ़िगर करने के दौरान, यह तय किया जा सकता है कि कनेक्शन के लिए, एचटीटीपी या एन्क्रिप्ट (सुरक्षित) किए गए एचटीटीपीएस प्रोटोकॉल का इस्तेमाल किया जाए.

Edge Management API के लिए:

http://ms_IP_DNS:8080/v1
https://ms_IP_DNS:8080/v1

जहां ms_IP_DNS, मैनेजमेंट सर्वर का आईपी पता या डीएनएस नाम है. एपीआई को कॉन्फ़िगर करते समय, यह तय किया जा सकता है कि कनेक्शन, एचटीटीपी या एन्क्रिप्ट (सुरक्षित) किए गए एचटीटीपीएस प्रोटोकॉल का इस्तेमाल करे.

Edge SSO पर टीएलएस कॉन्फ़िगर करना

डिफ़ॉल्ट रूप से, Edge एसएसओ का कनेक्शन, apigee-sso (Edge एसएसओ मॉड्यूल) को होस्ट करने वाले नोड पर, पोर्ट 9099 पर एचटीटीपी का इस्तेमाल करता है. apigee-sso में Tomcat का एक इंस्टेंस पहले से मौजूद होता है. यह एचटीटीपी और एचटीटीपीएस अनुरोधों को मैनेज करता है.

Edge SSO और Tomcat, कनेक्शन के तीन मोड के साथ काम करते हैं:

  • DEFAULT - डिफ़ॉल्ट कॉन्फ़िगरेशन, पोर्ट 9099 पर एचटीटीपी अनुरोधों के साथ काम करता है.
  • SSL_TERMINATION - अपनी पसंद के पोर्ट पर, Edge SSO के लिए टीएलएस ऐक्सेस चालू किया गया. इस मोड के लिए, आपको टीएलएस कुंजी और सर्टिफ़िकेट की जानकारी देनी होगी.
  • SSL_PROXY - यह Edge एसएसओ को प्रॉक्सी मोड में कॉन्फ़िगर करता है. इसका मतलब है कि आपने apigee-sso के सामने लोड बैलेंसर इंस्टॉल किया है और लोड बैलेंसर पर टीएलएस को बंद कर दिया है. लोड बैलेंसर से मिलने वाले अनुरोधों के लिए, apigee-sso पर इस्तेमाल किए जाने वाले पोर्ट की जानकारी दी जा सकती है.

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

Edge के लिए एसएएमएल की सुविधा चालू करने के बाद, Apigee Developer Services पोर्टल (या सिर्फ़ पोर्टल) के लिए भी एसएएमएल की सुविधा चालू की जा सकती है. हालांकि, ऐसा करना ज़रूरी नहीं है. Edge को अनुरोध भेजते समय, पोर्टल एसएएमएल की मदद से पुष्टि करने की सुविधा देता है. ध्यान दें कि यह पोर्टल में डेवलपर के लॉगिन के लिए, एसएएमएल की मदद से पुष्टि करने की सुविधा से अलग है. डेवलपर के लॉगिन के लिए, एसएएमएल की मदद से पुष्टि करने की सुविधा को अलग से कॉन्फ़िगर किया जाता है. ज़्यादा जानकारी के लिए, Edge के साथ कम्यूनिकेट करने के लिए, एसएएमएल का इस्तेमाल करने के लिए पोर्टल को कॉन्फ़िगर करना लेख पढ़ें.

पोर्टल को कॉन्फ़िगर करने के लिए, आपको Edge SSO मॉड्यूल का यूआरएल बताना होगा. यह मॉड्यूल, Edge के साथ इंस्टॉल किया जाता है: