Edge यूज़र इंटरफ़ेस (यूआई) और Edge मैनेजमेंट एपीआई, Edge मैनेजमेंट सर्वर को अनुरोध भेजकर काम करते हैं. मैनेजमेंट सर्वर, पुष्टि करने के इन तरीकों के साथ काम करता है:
- बुनियादी पुष्टि: Edge यूज़र इंटरफ़ेस (यूआई) में लॉग इन करें या Edge मैनेजमेंट एपीआई को अनुरोध भेजें. इसके लिए, अपना उपयोगकर्ता नाम और पासवर्ड डालें.
- OAuth2: Edge Basic Auth के क्रेडेंशियल को OAuth2 ऐक्सेस टोकन और रीफ़्रेश टोकन से बदलें. एपीआई कॉल के Bearer हेडर में OAuth2 ऐक्सेस टोकन पास करके, Edge मैनेजमेंट एपीआई को कॉल करें.
Edge, पुष्टि करने के लिए इन बाहरी आइडेंटिटी प्रोवाइडर (आईडीपी) का इस्तेमाल करने की सुविधा देता है:
- सिक्योरिटी असर्शन मार्कअप लैंग्वेज (एसएएमएल) 2.0: एसएएमएल आइडेंटिटी प्रोवाइडर से मिले एसएएमएल असर्शन से, OAuth ऐक्सेस टोकन जनरेट करें.
- लाइटवेट डायरेक्ट्री ऐक्सेस प्रोटोकॉल (एलडीएपी): OAuth ऐक्सेस टोकन जनरेट करने के लिए, एलडीएपी के खोज और बाइंड या सामान्य बाइंडिंग की पुष्टि करने के तरीकों का इस्तेमाल करें.
एसएएमएल और एलडीएपी, दोनों आईडीपी सिंगल साइन-ऑन (एसएसओ) एनवायरमेंट के साथ काम करते हैं. Edge के साथ किसी बाहरी आईडीपी का इस्तेमाल करके, Edge के यूज़र इंटरफ़ेस (यूआई) और एपीआई के लिए एसएसओ की सुविधा चालू की जा सकती है. इसके अलावा, उन अन्य सेवाओं के लिए भी एसएसओ की सुविधा चालू की जा सकती है जो आपके बाहरी आईडीपी के साथ काम करती हैं.
बाहरी आईडीपी की सुविधा चालू करने के लिए, इस सेक्शन में दिए गए निर्देश, बाहरी पुष्टि से इन तरीकों से अलग हैं:
- इस सेक्शन में एसएसओ (SSO) की सुविधा जोड़ी गई है
- यह सेक्शन, Edge यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करने वाले लोगों के लिए है, न कि क्लासिक यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करने वाले लोगों के लिए
- यह सेक्शन, सिर्फ़ 4.19.06 और इसके बाद के वर्शन पर काम करता है
Apigee एसएसओ के बारे में जानकारी
Edge पर एसएएमएल या एलडीएपी का इस्तेमाल करने के लिए, Apigee एसएसओ मॉड्यूल apigee-sso इंस्टॉल करें.
यहां दी गई इमेज में, Edge for Private Cloud इंस्टॉलेशन में Apigee एसएसओ को दिखाया गया है:
Apigee एसएसओ मॉड्यूल को Edge यूज़र इंटरफ़ेस (यूआई) और मैनेजमेंट सर्वर वाले नोड पर या इसके अपने नोड पर इंस्टॉल किया जा सकता है. पक्का करें कि Apigee SSO के पास पोर्ट 8080 पर मैनेजमेंट सर्वर का ऐक्सेस हो.
Apigee एसएसओ नोड पर पोर्ट 9099 खुला होना चाहिए, ताकि ब्राउज़र, बाहरी एसएएमएल या एलडीएपी आईडीपी, मैनेजमेंट सर्वर, और Edge यूज़र इंटरफ़ेस (यूआई) से Apigee एसएसओ को ऐक्सेस किया जा सके. Apigee SSO को कॉन्फ़िगर करते समय, यह तय किया जा सकता है कि बाहरी कनेक्शन, एचटीटीपी या एन्क्रिप्ट यानी सुरक्षित किए गए एचटीटीपीएस प्रोटोकॉल का इस्तेमाल करे.
Apigee SSO, Postgres नोड पर पोर्ट 5432 पर ऐक्सेस किए जा सकने वाले Postgres डेटाबेस का इस्तेमाल करता है. आम तौर पर, Edge के साथ इंस्टॉल किए गए Postgres सर्वर का इस्तेमाल किया जा सकता है. इसके लिए, स्टैंडअलोन Postgres सर्वर या मास्टर/स्टैंडबाय मोड में कॉन्फ़िगर किए गए दो Postgres सर्वर का इस्तेमाल किया जा सकता है. अगर आपके Postgres सर्वर पर लोड ज़्यादा है, तो सिर्फ़ Apigee एसएसओ के लिए एक अलग Postgres नोड भी बनाया जा सकता है.
Edge for Private Cloud के लिए, OAuth2 की सुविधा जोड़ी गई
जैसा कि ऊपर बताया गया है, एसएएमएल को लागू करने के लिए Edge, OAuth2 ऐक्सेस टोकन का इस्तेमाल करता है.इसलिए, Edge for Private Cloud में OAuth2 की सुविधा जोड़ी गई है. ज़्यादा जानकारी के लिए, OAuth 2.0 के बारे में जानकारी लेख पढ़ें.
एसएएमएल के बारे में जानकारी
एसएएमएल ऑथेंटिकेशन के कई फ़ायदे हैं. SAML का इस्तेमाल करके, ये काम किए जा सकते हैं:
- यूज़र मैनेजमेंट का पूरा कंट्रोल पाएं. जब उपयोगकर्ता आपका संगठन छोड़ देते हैं और उन्हें केंद्रीय तौर पर हटा दिया जाता है, तो उन्हें Edge का ऐक्सेस अपने-आप नहीं मिलता..
- यह कंट्रोल करना कि Edge को ऐक्सेस करने के लिए, उपयोगकर्ता अपनी पहचान की पुष्टि कैसे करें. अलग-अलग Edge संगठनों के लिए, पुष्टि करने के अलग-अलग तरीके चुने जा सकते हैं.
- पुष्टि करने से जुड़ी नीतियों को कंट्रोल करें. ऐसा हो सकता है कि आपका SAML प्रोवाइडर, पुष्टि करने की ऐसी नीतियों के साथ काम करता हो जो आपके एंटरप्राइज़ के स्टैंडर्ड के मुताबिक हों.
- Edge डिप्लॉयमेंट पर लॉगिन, लॉगआउट, लॉगिन की असफल कोशिशों, और ज़्यादा जोखिम वाली गतिविधियों पर नज़र रखी जा सकती है.
SAML चालू होने पर, Edge यूज़र इंटरफ़ेस (यूआई) और Edge मैनेजमेंट एपीआई को ऐक्सेस करने के लिए, OAuth2 ऐक्सेस टोकन का इस्तेमाल किया जाता है. ये टोकन, Apigee एसएसओ मॉड्यूल से जनरेट होते हैं. यह मॉड्यूल, आपके आईडीपी से मिले एसएएमएल असर्शन को स्वीकार करता है.
एसएएमएल असर्शन से जनरेट होने के बाद, OAuth टोकन 30 मिनट के लिए मान्य होता है. साथ ही, रीफ़्रेश टोकन 24 घंटे के लिए मान्य होता है. ऐसा हो सकता है कि आपका डेवलपमेंट एनवायरमेंट, डेवलपमेंट से जुड़े सामान्य टास्क के लिए ऑटोमेशन की सुविधा के साथ काम करता हो. जैसे, टेस्ट ऑटोमेशन या लगातार इंटिग्रेशन/लगातार डिप्लॉयमेंट (सीआई/सीडी). इनके लिए, ज़्यादा समय तक मान्य रहने वाले टोकन की ज़रूरत होती है. अपने-आप होने वाले टास्क के लिए खास टोकन बनाने के बारे में जानकारी पाने के लिए, अपने-आप होने वाले टास्क के लिए एसएएमएल का इस्तेमाल करना लेख पढ़ें.
LDAP के बारे में जानकारी
लाइटवेट डायरेक्ट्री ऐक्सेस प्रोटोकॉल (एलडीएपी), एक ओपन और इंडस्ट्री स्टैंडर्ड ऐप्लिकेशन प्रोटोकॉल है. इसका इस्तेमाल, डिस्ट्रिब्यूटेड डायरेक्ट्री की जानकारी वाली सेवाओं को ऐक्सेस और मैनेज करने के लिए किया जाता है. डायरेक्ट्री सेवाएं, रिकॉर्ड का कोई भी व्यवस्थित सेट उपलब्ध करा सकती हैं. आम तौर पर, इसमें हैरारकी वाला स्ट्रक्चर होता है, जैसे कि कॉर्पोरेट ईमेल डायरेक्ट्री.
Apigee एसएसओ में LDAP की मदद से पुष्टि करने के लिए, Spring Security LDAP मॉड्यूल का इस्तेमाल किया जाता है. इस वजह से, Apigee SSO के LDAP के लिए पुष्टि करने के तरीके और कॉन्फ़िगरेशन के विकल्प, Spring Security LDAP में मिलने वाले विकल्पों से सीधे तौर पर जुड़े होते हैं.
Edge for Private Cloud के साथ LDAP, एलडीएपी के साथ काम करने वाले सर्वर के लिए, पुष्टि करने के इन तरीकों के साथ काम करता है:
- खोजें और बाइंड करें (इनडायरेक्ट बाइंडिंग)
- सिंपल बाइंड (डायरेक्ट बाइंडिंग)
Apigee SSO, उपयोगकर्ता का ईमेल पता हासिल करने और उसके साथ अपने इंटरनल उपयोगकर्ता रिकॉर्ड को अपडेट करने की कोशिश करता है, ताकि फ़ाइल में मौजूदा ईमेल पता मौजूद हो. ऐसा इसलिए, क्योंकि Edge इस ईमेल का इस्तेमाल अनुमति देने के लिए करता है.
Edge यूज़र इंटरफ़ेस (यूआई) और एपीआई यूआरएल
Edge यूज़र इंटरफ़ेस (यूआई) और Edge मैनेजमेंट एपीआई को ऐक्सेस करने के लिए इस्तेमाल किया जाने वाला यूआरएल वही है जो एसएएमएल या एलडीएपी को चालू करने से पहले इस्तेमाल किया जाता था. 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, मैनेजमेंट सर्वर का आईपी पता या डीएनएस नाम है. एपीआई को कॉन्फ़िगर करते समय, यह तय किया जा सकता है कि कनेक्शन, एचटीटीपी या एन्क्रिप्ट (सुरक्षित) किए गए एचटीटीपीएस प्रोटोकॉल का इस्तेमाल करे.
Apigee SSO पर टीएलएस कॉन्फ़िगर करना
डिफ़ॉल्ट रूप से, Apigee SSO का कनेक्शन, apigee-sso (Apigee SSO मॉड्यूल) को होस्ट करने वाले नोड पर पोर्ट 9099 पर एचटीटीपी का इस्तेमाल करता है. apigee-sso में Tomcat का एक इंस्टेंस पहले से मौजूद होता है. यह एचटीटीपी और एचटीटीपीएस अनुरोधों को मैनेज करता है.
Apigee एसएसओ और Tomcat, कनेक्शन के तीन मोड के साथ काम करते हैं:
- डिफ़ॉल्ट: डिफ़ॉल्ट कॉन्फ़िगरेशन, पोर्ट 9099 पर एचटीटीपी अनुरोधों के साथ काम करता है.
- SSL_TERMINATION: अपनी पसंद के पोर्ट पर, Apigee SSO के लिए टीएलएस ऐक्सेस चालू किया गया. इस मोड के लिए, आपको टीएलएस कुंजी और सर्टिफ़िकेट की जानकारी देनी होगी.
- SSL_PROXY: यह Apigee SSO को प्रॉक्सी मोड में कॉन्फ़िगर करता है. इसका मतलब है कि आपने
apigee-ssoके सामने लोड बैलेंसर इंस्टॉल किया है और लोड बैलेंसर पर टीएलएस को बंद कर दिया है. लोड बैलेंसर से मिलने वाले अनुरोधों के लिए,apigee-ssoपर इस्तेमाल किए जाने वाले पोर्ट की जानकारी दी जा सकती है.
पोर्टल के लिए, बाहरी आईडीपी की सुविधा चालू करना
Edge के लिए बाहरी आईडीपी की सुविधा चालू करने के बाद, आपके पास Apigee Developer Services पोर्टल (या सिर्फ़ पोर्टल) के लिए भी इसे चालू करने का विकल्प होता है. Edge को अनुरोध भेजते समय, पोर्टल एसएएमएल और एलडीएपी की मदद से पुष्टि करने की सुविधा देता है. ध्यान दें कि यह पोर्टल में डेवलपर के लॉगिन के लिए, एसएएमएल और एलडीएपी की मदद से पुष्टि करने की सुविधा से अलग है. डेवलपर के लॉगिन के लिए, बाहरी आईडीपी (IdP) से पुष्टि करने की सुविधा को अलग से कॉन्फ़िगर किया जाता है. ज़्यादा जानकारी के लिए, आईडीपी का इस्तेमाल करने के लिए पोर्टल को कॉन्फ़िगर करना लेख पढ़ें.
पोर्टल को कॉन्फ़िगर करने के लिए, आपको Apigee SSO मॉड्यूल का यूआरएल बताना होगा. यह मॉड्यूल, Edge के साथ इंस्टॉल किया जाता है:
